Dokumentation des Saferpay-Moduls für Zope
------------------------------------------

(C) netEstate GmbH, www.netestate.de

1.	Installation

-Installieren Sie die Saferpay-Client-Komponente unter /usr/local so daß
 das Programm saferpay mit dem Pfad /usr/local/bin/saferpay aufgerufen
 werden kann.

-Legen Sie im Heimatverzeichnis von Zope ein Verzeichnis "saferpay" mit den
 Berechtigungen des Zope-Users ein. Speichern Sie den Pfad dieses
 Verzeichnisses in der Property "saferpayHome" Ihres Zope-Startverzeichnisses.
 Dieses Verzeichnis nennen wir fortan Saferpay-Heimatverzeichnis

-Nehmen Sie die Identität des Zope-Users an und rufen Sie folgendes Kommando
 auf:

 /usr/local/bin/saferpay -conf \
 -p <Saferpay-Heimatverzeichnis> \
 -r https://www.saferpay.com/user/setup.asp \
 -u <Saferpay-Username>
 -w <Saferpay-Passwort>

 Die Saferpay-Client-Komponente wurde hiermit konfiguriert.

-Kompilieren Sie die Datei saferpay_wrapper.c mit dem Kommando
 "make saferpay_wrapper" und installieren Sie die erzeugte ausführbare Datei
 unter /usr/local/bin

-Installieren Sie saferpay.py im Extensions-Verzeichnis von Zope

-Legen Sie in Ihrem Zope-Startverzeichnis eine externe Methode CallSaferpay
 an, die auf die gleichnamige Funktion im Modul saferpay.py zeigt.

-Legen Sie eine DTML-Methode Testzahlung mit folgendem Inhalt an:
 <dtml-if DATA>
  <dtml-if SaferpayPayconfirm>
   Zahlung Erfolgreich.
  <dtml-else>
   Unerwarteter Fehler!
  </dtml-if>
 <dtml-else>
  <a href="<dtml-var SaferpayPayinit>">Weiter zur Zahlung</a>
 </dtml-if>

-Legen Sie ein Python-Skript SaferpayPayinit mit folgendem Inhalt an:
 args={}
 args['AMOUNT']='100'
 args['CURRENCY']='EUR'
 args['DESCRIPTION']='Testzahlung'
 args['SUCCESSLINK']='<URL DTML-Methode Testzahlung>'
 args['BACKLINK']=args['SUCCESSLINK']
 args['FAILLINK']=args['SUCCESSLINK']
 args['ACCOUNTID']='<Saferpay-Accountid>'
 args['ALLOWCOLLECT']='no'
 args['CCCVC']='no'
 args['DELIVERY']='no'
 return context.CallSaferpay(args)

-Legen Sie ein Python-Skript SaferpayPayconfirm mit folgendem Inhalt an:
 request = context.REQUEST
 form = request.form
 return context.CallSaferpay(form)

-Rufen Sie Testzahlung auf.

2.	Dokumentation

Das Modul implementiert die von Saferpay als "E-Commerce-Modul" verkaufte
Schnittstelle. Diese besteht aus:

-Einem Aufruf der Payinit-Funktion mit den im Python-Skript
 SaferpayPayinit vorhandenen Zahlungsparametern, welcher eine URL zum
 Saferpay-Webserver zurückliefert. Zu dieser URL wird der Browser des
 Kunden geleitet.

-Der Abfrage aller relevanten Zahlungsdaten durch den Saferpay-Webserver.

-Bei erfolgreicher Kartenprüfung: Der Weiterleitung des Kunden zurück zu
 einer vorher spezifizierten URL, welche um die Parameter DATA und
 SIGNATURE erweitert wird. Diese stellen eine Kryptographisch
 signierte Zusammenfassung des Zahlungsvorgangs dar, die nun verwendet
 werden können, um mit Hilfe der PayConfirm- und Capture-Funktion
 die Zahlung abzuschliessen. Ein Fehler kann zu diesem Zeitpunkt
 eigentlich nicht mehr auftreten, da die Karte des Kunden
 schon geprüft wurde.

Sollte dennoch einmal ein Fehler in der PayConfirm- und Capture-Phase
auftreten, kehrt die Funktion CallSaferpay mit dem Rückgabewert 0 zurück.
In diesem Fall bleibt die Ausgabe des Programms saferpay als Datei
stdout_<Zufallszahl>.txt im Saferpay-Heimatverzeichnis zurück.