Integration Billpay in Intershop 7

Transkript

1 Integration Billpay in Intershop 7 Stand: Version: 1.0

2 Seite 2 von 7 Änderungshistorie Datum Version Bearbeiter Änderungen Mirko Stölzel Initiale Version

3 Seite 3 von 7 Inhalt 1 EINLEITUNG VORAUSSETZUNG EINBINDUNG IN INTERSHOP Cartridge Struktur Installation KONFIGURATION DER ZAHLARTEN Zuweisung der Billpay Bezahlarten zur Organisation Zuweisung der Billpay Bezahlarten zum Kanal Konfiguration der einzelnen Billpay Bezahlarten PROJEKTSPEZIFISCHE ANPASSUNGEN IN INTERSHOP Allgemeine Informationen Betrugsprävention (Pflicht) Einbindung statischer Resourcen (Pflicht) Template Anpassung... 7

4 Seite 4 von 7 1 Einleitung Die Billpay GmbH (im Folgenden Billpay ) hatte die dmc digital media center GmbH (im Folgenden dmc ) beauftragt eine Integration von Billpay in Intershop Build 328 durchzuführen. Dieses Dokument beschreibt die Integration der Billpay Bezahlmöglichkeiten in diese Version. 2 Voraussetzung Als Grundlage für die Implementierung dienten die von Billpay gelieferten Dokumente: - billpay-api-dokumentation_v1_9_7_de2.pdf, - billpay-api-ratenkauf-erweiterung_v0_4_1_de.pdf, - billpay-api-betrugspraevention_erweiterung_v0_1_0_de.pdf. 3 Einbindung in Intershop Cartridge Struktur Für die Integration von Billpay sind zwei Cartridges erforderlich: 1. Die Cartridge ac_calculation ist eine Adapter Cartridge, die eine zentrale Registry bereitstellt, um neue Kalkulationsregeln der Standard Intershop Kalkulation hinzuzufügen und/ oder vorhandene zu überschreiben. Die Billpay Cartridge verwendet diesen Mechanismus, um die zusätzlichen Kosten für den Ratenkauf in die Intershop Kalkulation einzubinden 2. Die Cartridge ac_payment_billpay beinhaltet die Implementierung der unterschiedlichen Bezahloptionen sowie die einzelnen Templates zur Anzeige. 3.2 Installation Zur Installation müssen folgende Schritte durchgeführt werden: 1. IS Server stoppen 2. Die beiden Cartriges ac_calculation und ac_payment_billpay müssen in den Cartrdige Ordner <ISHOME>/share/system/cartridges kopiert werden. 3. Die Dateien ac_calculation.properties, ac_payment_billpay.properties und logbackac_payment_billpay.xml müssen nach <ISHOME>/share/system/config/cartridges kopiert werden 4. Beiden Cartrdiges müssen in die Cartridge Liste der Intershop Installation aufgenommen werden: sld_ch_sf_base,,ac_calculation,ac_payment_billpay,,<shopcartridge> 5. Optional: Datei ac_payment_billpay.properties editieren und die Eigenschaften für die unterschiedlichen Billpay URLs anpassen 6. IS Server neustarten

5 Seite 5 von 7 4 Konfiguration der Zahlarten Nach der Einbindung der Cartridges müssen 3 Konfigurationsschritte im Intershop 7 BackOffice (SLD-System) durchgeführt werden. 4.1 Zuweisung der Billpay Bezahlarten zur Organisation Zunächst muss man sich als Admin Nutzer an der Organisation Operations anmelden. Über den Menüpunkt Sales Organizations gelangt man zur Übersicht der Organisationen. In der Liste klickt man auf die gewünschte Organisation und gelangt über den Reiter Payment zu den Bezahlarten. Dort ist vor den einzelnen Billpay Bezahlmethoden das Häkchen zu setzen und die Änderung zu speichern. 4.2 Zuweisung der Billpay Bezahlarten zum Kanal Anschließend muss man sich als Admin Nutzer der Organisation anmelden. Über den Menüpunkt Channels/Channels gelangt man zur Übersicht der Kanäle. In der Liste klickt man auf den gewünschten Kanal und gelangt über den Reiter Payment zu den Bezahlarten. Dort vor den einzelnen Billpay Bezahlmethoden das Häkchen setzen und die Änderung speichern.

6 Seite 6 von Konfiguration der einzelnen Billpay Bezahlarten Abschließend wechselt man in das Backoffice des Kanals und ruft über das Menü Orders/Payment Methods auf. Hier die gewünschte Payment Methode auswählen. Anschließend die Applikation und die Konsumergruppen auswählen und speichern. Auf dem Reiter Preferences zusätzlich noch die individuellen Zugangsdaten von Billpay eintragen und speichern. 5 Projektspezifische Anpassungen in Intershop 7 Nach der Einbindung der drei Cartridges müssen/können noch folgende projektspezifische Anpassungen durchgeführt werden. 5.1 Allgemeine Informationen Die Billpay Cartridge enthält schon eine Reihe von Modulen, Templates, Pipelines und statischen Resourcen: - Pipeline ProcessBillpay: Bietet Optionen zur Ermittlung der einzelnen AGB URLs und zur Einbindung der Betrugsprävention. - Pipeline ProcessOrders (überschrieben): Versendet beim Ratenkauf die Bestätigungsmail mit den PDF Informationsdateien als Anhang, die im Rahmen des Capture Request erhalten wurden. - payment_billpay/modules/module: Definiert verschiedene Module, die bei der Anzeige der unterschiedlichen Billpay Bezahlmethoden verwendet werden. - Template Prefix: Template, das in den Templates zum Editieren der Bezahlmethoden im Checkout-Prozess eingefügt ist. Es bindet das Modul payment_billpay/modules/module und erzeugt im Template Dictionary ein WebForm Objekt mit dem Name EditForm. Dieses Objekt wird zur Erzeugung der einzelnen Input Felder der jeweiligen Bezahlmethode verwendet. Die zugehörigen Webform Definitionen sind im Ordner webforms der ac_payment_billpay Cartridge zu finden.

7 Seite 7 von Betrugsprävention (Pflicht) Die Einbindung der Betrugsprävention sollte auf der ersten Seite des Checkouts erfolgen. Die ideale Stelle hierfür ist die Adressseite des Checkout-Prozesses: <isinclude url="#url(action('processbillpay-getprofilingtags'))#" mode="automatic"> 5.3 Einbindung statischer Ressourcen (Pflicht) Die Billpay Cartridge enthält, wie bereits erwähnt, die entsprechenden Templates zur Anzeige und zur Erfassung sämtlicher Pflichtparameter der jeweiligen Bezahlmethode. Die Einbindung erfolgt nach dem Standard-Intershop-Mechanismus. Sollten im Shop die Template der Billpay Cartridge verwendet werden, so muss die Datei billpay.js in die Shop Cartridge eingefügt und entsprechend als JavaScript eingebunden werden. Optional kann auch die billpay.css eingebunden werden. 5.4 Template Anpassung Alternativ zu den vorhandenen Templates kann auch der Intershop Überschreibungsmechanismus zur Anpassung der Templates verwendet werden. Die entsprechenden Templates müssen lediglich in den folgenden Template Ordnern der Shop Cartridge abgelegt werden: - payment_billpay/directdebit - payment_billpay/hirepurchase - payment_billpay/invoice Innerhalb der jeweiligen Templates zum Editieren der benötigten Parameter der jeweiligen Bezahlmethode kann, wie bereits erwähnt, das Prefix Template eingebunden werden: <isinclude template="payment_billpay/prefix.isml"/>