1 Funktionsumfang. 1.1 Vorteile auf einen Blick

Transkript

1 VöB ZVD directpos OXID Zahlungsmodul Modul Version: 1.1. Shopversion: OXID 4.5.x 4.7.x/5.0.x Inhaltsverzeichnis 1 Funktionsumfang Vorteile auf einen Blick Installation und Konfiguration Dateien kopieren (alle Versionen) Modulerweiterung registrieren (nur 4.5.x) Install.sql und update view Bootstrap (4.5.x) tmp-verzeichnis leeren Script-Verzeichnis kontrollieren Modul aktivieren (4.6.x) Bezahlmethoden einrichten Aktivierung der Bezahlmethode bei Versandkosten Aktivierung der API Kommunikation Zahlungsverwaltung... 8 derksen mediaopt gmbh kontakt@mediaopt.de elbestrasse 28/ berlin +49 (30) fax-66 ust.-id DE HRB B Amtsgericht Charlottenburg geschäftsführer dipl.-ing. philipp derksen Seite 1

2 1 Funktionsumfang Das Zahlungsmodul VöB ZVD directpos sorgt für die sichere und einfache Abwicklung von Zahlungen über das VöB ZVD directpos payment gateway 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über hinaus 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. Mehr Informationen über das Produkt erhalten Sie hier: Vorteile auf einen Blick Anbindung Ihrer Hausbank für optimalen Service und Konditionen. Kunde kann Kreditkartendaten speichern und so den Checkout beschleunigen. Der Shop hat keinen Kontakt mit den originalen Kreditkartendaten, sondern speichert anonymisierte Pseudokartendaten. Optionale Einstellung, ob Kreditkarten direkt oder z.b. erst nach Versand belastet werden, Leichte Installation und Konfiguration durch Modul nach OXID Standard, VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 2

3 2 Installation und Konfiguration Sichern Sie Ihre Shop Daten. 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 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. Das Plugin ist für das OXID Theme Azure konzipiert. Wenn Sie ein anderes OXID Theme nutzen, dann müssen Sie Anpassungen vornehmen. Kopieren Sie hierzu bitte den Inhalt des Themenverzeichnisses copy_this/out/azure in das Verzeichnis Ihres aktiven Themes und migrieren Sie ggf. die erweiterten Blöcke (unter /modules/mo_directpos/out/blocks) und Templates. 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_directpos/core/mo_directpos oxorder oxpayment => mo_directpos/core/mo_directpos oxpayment oxuser => mo_directpos/core/mo_directpos oxuser order => mo_directpos/views/mo_directpos order thankyou => mo_directpos/views/mo_directpos thankyou 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). VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 3

4 2.4 Bootstrap (4.5.x) Fügen Sie folgende Zeile der Datei /modules/functions.php hinzu: include dirname( FILE ). "/mo_directpos/bootstrap.php"; 2.5 tmp-verzeichnis leeren Im OXID Hauptverzeichnis unter /tmp sämtliche *.php & *.txt Dateien löschen. 2.6 Script-Verzeichnis kontrollieren Stellen Sie sicher, dass die Dateien im Ordner /modules/mo_directpos/scripts von außerhalb erreichbar sind (notwendig für API-Kommunikation). Ein erfolgreicher Aufruf der folgenden URL gibt Ihnen Gewissheit: <meine-shop- URL>/modules/mo_directpos/scripts/mo_directpos shopnotification.php?mo_directpos checkscript=1 VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 4

5 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. VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 5

6 Stellen Sie anschließend sicher, dass der neuen Zahlungsart auch alle Benutzergruppen und Länder korrekt zugeordnet sind. VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 6

7 2.9 Aktivierung der Bezahlmethode bei Versandkosten Bitte aktivieren Sie die neue Zahlungsart auch unter den Versandkostenarten unter Shopeinstellungen Versandarten. Wählen Sie die Versandart aus für die Sie die Zahlungsart wünschen und klicken Sie im Register Zahlungsarten auf Zahlungsarten zuordnen. Es öffnet sich ein Fenster. Fügen Sie die gewünschte Zahlungsart der Spalte Zugeordnete Zahlungsarten per Drag and Drop hinzu. VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 7

8 2.10 Aktivierung der API Kommunikation Stellen Sie sicher, dass im Merchant-Admin Bereich Ihres Payment-Providers folgende "URL für Shopbenachrichtigung" korrekt hinterlegt ist: <meineshop- URL>/modules/mo_directpos/scripts/mo_directpos shopnotification.php 2.11 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.). VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 8

9 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. VöB ZVD directpos Modul Version: 1.1. derksen mediaopt GmbH 2013 Seite 9