Postbank Paysolution OXID Zahlungsmodul

Postbank Paysolution
OXID Zahlungsmodul
Modul Version: 1.1.0
Shopversion: OXID 4.5.x – 4.6.x
Inhaltsverzeichnis
1
Funktionsumfang ............................................................................................................ 2
1.1 Vorteile auf einen Blick .............................................................................................. 2
2
Installation und Konfiguration ......................................................................................... 3
2.1 Dateien Kopieren (alle Versionen) ............................................................................. 3
2.2 Modulerweiterung registrieren (nur 4.5.x) .................................................................. 3
2.3 Install.sql und update view......................................................................................... 4
2.4 Bootstrap (4.5.x) ........................................................................................................ 4
2.5 tmp-Verzeichnis leeren .............................................................................................. 4
2.6 Script-Verzeichnis kontrollieren ................................................................................. 5
2.7 Modul aktivieren (4.6.x) ............................................................................................. 5
2.8 Bezahlmethoden einrichten ....................................................................................... 5
2.9 Aktivierung der API Kommunikation .......................................................................... 7
2.10 Zahlungsverwaltung ................................................................................................ 7
1 Funktionsumfang
Das Modul sorgt für die sichere und einfache Abwicklung von Zahlungen über die Postbank
Paysolution API mit ihrem OXID eShop. Im bisherigen Leistungsumfang enthalten sind
Zahlungen mit den gängigen Kreditkarten VISA und Mastercard.
Die Besonderheit dieses Moduls ist das anonyme Kreditkartenhandling, welches es dem
Kunden ermöglicht, Kreditkarteninformationen anonym und sicher zu hinterlegen und so den
Checkout-Prozess schneller zu durchlaufen. Der Kunde hat dabei die Möglichkeit, die
Kreditkartendaten sowohl im Checkout, als auch in seinem Kundenkonto zu bearbeiten.
Darüberhinaus kann der Merchant die Kreditkarte des Kunden entweder direkt beim Einkauf
belasten, oder aber die Zahlung reservieren und zu einem späteren Zeitpunkt abbuchen.
Das wäre beispielsweise für turnusmäßige Abbuchungen von Abo-Produkten interessant,
bzw. von nicht unmittelbar lieferbaren Artikeln.
Sollte das anonyme Kreditkartenhandling nicht gewünscht sein und der Merchant möchte
dem Kunden ausschließlich das herkömmliche Kreditkartenhandling anbieten, so kann dies
im Backend, je nach Bedarf, ein und ausgeschalten werden.
1.1 Vorteile auf einen Blick
 Anbindung Ihrer Hausbank für optimalen Service und Konditionen
 Kunde kann Kreditkartendaten speichern und so Checkout beschleunigen
 Shop hat keinen Kontakt mit original Kreditkartendaten, sondern speichert
anonmisierte Pseudokartendaten
 Optionale Einstellung ob Kreditkarten direkt oder z.B. erst nach Versand belastet
werden
 Leichte Installation und Konfiguration durch Modul nach OXID Standard
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 2]
2
Installation und Konfiguration
Sichern Sie Ihre Shopdaten. Sollte Sie Bedenken bezüglich der Installation des Moduls
haben, lassen Sie diese von fachkundigem Personal vornehmen, gerne unterstützen
wir Sie dabei. Dieses Modul wurde für die OXID Shop Editionen CE, PE, EE unter den
o.g. Versionen entwickelt. Folgen Sie der Anleitung für einen problemlosen Betrieb.
Sollte es Unklarheiten in den Installationsanweisungen geben, freuen wir uns über Ihr
Feedback ([email protected]).
2.1



Dateien Kopieren (alle Versionen)
Stellen Sie eine Verbindung z.B. via FTP zu Ihrem Webserver her
Kopieren Sie den Inhalt des Verzeichnisses copy_this in Ihr Shop
Stammverzeichnis
Nutzen Sie ein anderes OXID Theme als Azure, kopieren Sie bitte den Inhalt
des Themeverzeichnisses copy_this/out/azure in das Verzeichnis Ihres aktiven
Themes. Migirieren Sie ggf. die erweiterten Blöcke unter
/modules/mo_paysolution/out/blocks
2.2 Modulerweiterung registrieren (nur 4.5.x)
Melden Sie sich im Administrationsbereich des Shops an und registrieren Sie folgende
Erweiterungen (Stammdaten => Grundeinstellungen => System => Module):
oxorder => mo_paysolution/core/mo_paysolution__oxorder
oxpayment => mo_paysolution/core/mo_paysolution__oxpayment
oxuser => mo_paysolution/core/mo_paysolution__oxuser
order => mo_paysolution/views/mo_paysolution__order
thankyou => mo_paysolution/views/mo_paysolution__thankyou
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 3]
2.3 Install.sql und update view
Führen Sie nun das Datenbank-Update unter Service => Tools durch. Verwenden Sie
dafür die install_4.5.sql, bzw. install.sql (für Shopversion 4.6.x).
2.4 Bootstrap (4.5.x)
Fügen Sie folgende Zeile der Datei /modules/functions.php hinzu:
include dirname( __FILE__ ) . "/mo_paysolution/bootstrap.php";
2.5
tmp-Verzeichnis leeren
Im OXID Hauptverzeichnis unter /tmp sämtliche *.php & *.txt Dateien löschen.
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 4]
2.6
Script-Verzeichnis kontrollieren
Stellen Sie sicher, daß die Dateien im Ordner /modules/mo_paysolution/scripts von
ausserhalb erreichbar sind (notwendig für API-Kommunikation). Ein erfolgreicher Aufruf
der folgenden URL gibt Ihnen Gewissheit:
<meine-shopURL>/modules/mo_paysolution/scripts/mo_paysolution__shopNotifica
tion.php?mo_paysolution__checkScript=1
2.7
Modul aktivieren (4.6.x)
Aktivieren Sie ihr Modul indem Sie es im neuen OXID Modulhandling anklicken. Sollten
Sie es nicht mehr benötigen, oder wollen Sie Ihr Modul kurzfristig inaktiv setzen, dann
können Sie das an selber stelle wieder inaktiv setzen.
2.8
Bezahlmethoden einrichten
Richten Sie ihre neue Zahlungsart wie gehabt unter dem Menüpunkt
Shopeinstellungen => Zahlungsart ein. Beachten Sie dabei, dass die Grundeinstellung
des max. Einkaufswerts von 0 auf einen höheren Betrag geändert wird.
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 5]
Stellen Sie anschließend sicher, dass der neuen Zahlungsart auch alle
Benutzergruppen und Länder korrekt zugeordnet sind.
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 6]
2.9
Aktivierung der API Kommunikation
Stellen Sie sicher,dass im Merchant-Admin Bereich ihres Payment-Providers folgende
"URL für Shopbenachrichtigung" korrekt hinterlegt ist:
<meine shopURL>/modules/mo_paysolution/scripts/mo_paysolution__shopNotifica
tion.php
2.10 Zahlungsverwaltung
Stellen Sie sicher, dass sich Ihr Modul im Live-Modus befindet und wählen Sie
zwischen den Optionen „buchen“ (die Kreditkarte des Kunden direkt belasten) oder
„reservieren“ (s.u.).
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 7]
Sollte das anonyme Kreditkartenhandling („Pseudo-Kreditkarten“) von Ihnen nicht
gewünscht sein, oder nicht durch Ihren Akzeptanzpartner unterstütz werden, dann
können Sie diesen Service einfach ausschalten.
Im Backend des Payment Providers können Sie dann reservierte Zahlungen
nachträglich zu einem Zeitpunkt Ihrer Wahl abbuchen oder stornieren.
Postbank Paysolution | Modul Version: 1.1.0 | © derksen mediaopt GmbH 2012
Seite [ 8]