xt:commerce EPS2 - Plugin
-------------------------

Version:  v1.0
Author:   DI (FH) Ludwig Ertl  <ludwig.ertl@softwerker.at> 
Company:  SoftWerker Datenservice GmbH 
WWW:      http://www.softwerker.at/ 

Released under the GNU General Public License.


Installationsanleitung
----------------------
Kopieren Sie bitte einfach den Verzeichnisbaum unterhalb des Verzeichnisses
xtcommerce/ dieses Pakets in Ihr xt:commerce Verzeichnis auf Ihrem Webserver.
Die Verzeichnisstruktur ist wie folgt aufgebaut:

includes/modules/payment/eps2.php
 - Das EPS2-Zahlungsmodul fuer xt:commerce. Dies beinhaltet den eigentlichen 
   Programmcode

lang/german/modules/payment/eps2.php
 - Deutsche Textressourcen fuer das Plugin. 
   
lang/english/modules/payment/eps2.php
 - Englische Textressourcen fuer das Plugin.

backref2.php
 - Rueckmeldeskript fuer Bankserver. Dieses Skript schreibt die Confirmation des
   Bankservers in die Datenbank, sodass das Hauptmodul diese auslesen und 
   entsprechend behandeln kann.


Nach dem korrekten Kopieren der Dateien in Ihr xt:commerce Verzeichnis muessen 
Sie das Modul auf die gewohnte Art und Weise einrichten. Loggen Sie sich als 
xt:commerce Administrator ein und waehlen Sie in der linken Spalte unter 
"Module" den Punkt "Zahlungsoptionen".

Haben Sie zuvor das EPS1-Modul benutzt, so deaktivieren Sie dieses bitte, indem
Sie dieses anwaehlen, auf "Bearbeiten" klicken und "EPS1 Modul aktivieren" 
auf "False" stellen.

Waehlen Sie "EPS2" aus der Liste und klicken Sie rechts auf "Installieren."
Klicken Sie dann auf "Bearbeiten", um die Optionen einzustellen:
Geben Sie Ihre HaendlerID, Ihren PIN, Ihren IBAN und Ihren BIC fuer die jeweils
unterstuetzen Kreditinstitute ein. 
Info fuer EPS1-Zahlungsmodulbenutzer: IBAN und BIC sind bei EPS2 
verpflichtende Angaben und muessen in jedem Fall angegeben werden!
Stellen Sie auch die anderen Parameter entsprechend Ihren Wuenschen ein
und speichern Sie die Einstellungen anschliessend mittels "Aktualisieren".
Das EPS2 - Zahlungsmodul ist nun eingerichtet.

Testdaten
---------
Getestet werden kann das Modul mit dem Testsystem der ERSTE Bank.
Dazu sind folgende Daten in der Konfiguration anzugeben:

Testsystem benutzen?	=>	TRUE
Erste Bank und Sparkassen
HändlerID		=>	00088_501866818
PIN			=>	WFuFmCnHrJ
IBAN			=>	AT212099900000637777
BIC			=>	SPBAAT20


Arbeitsweise
------------
Ist eine EPS - Zahlung erfolgreich, so wird der Status der Bestellung 
automatisch  auf "In Bearbeitung" gesetzt, andernfall bleibt er auf "offen". Bei 
"In Bearbeitung" haben Sie die Zahlung erhalten und koennen sofort mit der 
Auslieferung beginnen - dies sollte normalerweise der Fall sein, da bei einer 
nicht erfolgreichen Zahlung auf die Fehlerseite weitergeleitet wird und somit 
ein Kauf  nicht erfolgreich abgeschlossen werden kann.
Sollte der Bankserver aber irgendeinmal nicht rechtzeitig antworten, so wurde 
die Bestellung auf 'Offen' bleiben und sie muessten anhand der 
Rueckmeldungstabelle (im folgenden beschrieben) pruefen, ob fuer die 
entsprechende Order eine Bestaetigung eingegangen ist.
Im Normalfall sollte dies allerdings nicht vorkommen, es ist nur als 
extra-Sicherheit gedacht.

Es wird in der xt:commerce Datenbank eine Tabelle mit dem Namen 'payment_eps2' 
eingerichtet, welche zur Rueckverfolgung der einzelnen EPS2-Transaktionen dient.
Diese beinhaltet die folgenden Felder:

+--------------+-------------------+---------------------+--------------+
| eps2_TRID    | eps2_RETURNSTATUS | eps2_DATE           | eps2_ORDERID |
+--------------+-------------------+---------------------+--------------+

Die eps2_TRID ist eine zufaellig generierte Transaction ID und ist fuer Sie 
nicht wirklich von Interesse.
Der eps1_RETURNSTATUS ist die Rueckmeldung des Bankservers zur entsprechenden 
Transaktion.
Sie kann eine der folgenden Stati sein:

 OK           -> Zahlung OK
 NOK          -> Zahlung NICHT OK
 VOK          -> Zahlung vorlaeufig OK, order ueberprueft. (~OK)

Das eps2_DATE ist das Datum der Transaktion.
Die eps2_ORDERID ist die ID der Bestellung und dient fuer Sie zur 
Rueckverfolgung der Bestellung.

Kontakt
-------
Fragen, Wuensche, Anregungen, Beschwerden bitte an die oben genannte e-mail
Adresse.

