easycredit Ratenkauf für OXID eshop

Transkript

1 easycredit Ratenkauf für OXID eshop Version: Datum: Editor: easycredit Copyright easycredit 2016 Seite 1 / 14

2 Inhaltsverzeichnis 1 Übersicht Funktionsübersicht 3 2 Voraussetzungen Kompatibilität 4 3 Installation 5 4 Aktivierung 6 5 Konfiguration Schritt 1: Konfiguration des easycredit-moduls Schritt 2: Konfiguration weiterer Verknüpfungen 10 6 Versionshinweise 13 Copyright easycredit 2016 Seite 2 / 14

3 1 Übersicht Das ecommerce-modul easycredit für OXID eshop erlaubt die Abwicklung von Zahlungsvorgängen per Ratenkauf für Shopbetreiber mit dem Shopsystem OXID eshop. Hinweis: Die Begriffe Plugin, Extension und Modul werden in dieser Dokumentation synonym verwendet. 1.1 Funktionsübersicht Das Modul easycredit für OXID eshop bietet den folgenden Funktionsumfang: Konfiguration der easycredit-zugangsdaten Erfassung der abwicklungsrelevanten Kundendaten Prüfung der Zahlungsmöglichkeit (Ein- bzw. Ausblenden von easycredit) Berechnung der Raten, Beträge und Zinsen Anfrage und Abruf der Zahlungsfreigabe Übertragung der Kundendaten zur Abwicklung an easycredit Copyright easycredit 2016 Seite 3 / 14

4 2 Voraussetzungen Für den Betrieb dieses Moduls benötigen Sie das OXID eshop-shopsystem. Da OXID eshop auf die Scriptsprache PHP aufsetzt, benötigen Sie diese auf dem Server, auf dem das Shopsystem und das Modul betrieben werden sollen. 2.1 Kompatibilität In der Entwicklung wurde OXID eshop in den Versionen und eingesetzt. Daher sollte mit diesen beiden Versionen die größtmögliche Kompatibilität bestehen. Je nach Auf- und Abwärtskompatibilität der verschiedenen Versionen des OXID- Shopsystems sind viele weitere kompatible Versionen denkbar. Im Zweifel wenden Sie sich bitte an easycredit bzw. Ihren IT-Integrator zur Prüfung einer konkreten Version. Prüfen Sie bitte auch die PHP-Kompatibilitätsangaben Ihrer OXID-Version. Speziell das vorliegende easycredit-modul ist für eine möglichst breite Unterstützung von PHP 5.3 bis PHP 5.6 ausgelegt, so dass damit keine weiteren Einschränkungen neben den Voraussetzungen für OXID eshop einhergehen sollten. Diese Installation ist für OXID geschrieben, d.h. die Screenshots und Dateinamen beziehen sich auf diese Version. Die Schritte für andere OXID-Versionen sind jedoch identisch. Sie müssen nur die entsprechenden Dateinamen oder -pfade einsetzen. Copyright easycredit 2016 Seite 4 / 14

5 3 Installation Die Installation des Moduls ist sehr einfach. Innerhalb des Modul-Archivs im Zip-Format gibt es das Unterverzeichnis easycredit/copy_this. Darin befinden sich der Unterordner modules/easycredit, der 1:1 in das OXID-Shop-Verzeichnis kopiert werden kann. Dort sollte bereits ein modules-ordner existieren, so dass Sie den easycredit-ordner einfach hineinkopieren können. $ unzip easycredit_oxid_4.6.zip $ cd easycredit_oxid_4.6 $ cd easycredit/copy_this $ cp -R modules/easycredit <SHOP-VERZEICHNIS>/modules/ Damit sind alle notwendigen Modul-Dateien im Shop-System integriert. Fahren Sie nun mit dem Schritt Aktivierung fort. Copyright easycredit 2016 Seite 5 / 14

6 4 Aktivierung Damit das Modul im Shop integriert und bei den richtigen Stellen aufgerufen wird, muss es aktiviert werden. Wechseln Sie dazu bitte in den Administrationsbereich Ihres Shops. In der Regel sollten Sie sich dazu mit der URL /admin/ auf Ihrer Shop-Domain anmelden. Wählen Sie dort links in der vertikalen Menüleiste den Punkt Erweiterungen/Module. Nun sollten Sie eine Liste von Modulen sehen, darunter auch das easycredit-modul. Mit einem Klick auf das Modul wird es rot markiert und darunter die Details angezeigt. In den Stammdaten des Moduls ist das Modul als inaktiv markiert: Mit einem Klick auf den Button Aktivieren wird die Erweiterung aktiviert, und die grundlegenden Einstellung aus den Moduldaten in die OXID-Konfiguration übernommen. Nun sollte die Modulübersicht wie folgt erscheinen: Copyright easycredit 2016 Seite 6 / 14

7 Damit ist das Modul aktiviert und einsatzbereit. Fahren Sie nun mit der Konfiguration fort, um es für Ihren Einsatz richtig einzustellen. Copyright easycredit 2016 Seite 7 / 14

8 5 Konfiguration 5.1 Schritt 1: Konfiguration des easycredit-moduls Für die Basis-Konfiguration hinterlegen Sie bitte zunächst ihre Shop-ID und den Shop-Token in den Modul-Stammdaten: Als nächstes konfigurieren Sie bitte weitere Einstellungen unter den Zahlarten. Dazu wechseln Sie bitte auf die Liste der Zahlungsarten, die Sie auf der Menüleiste des Admin-Bereichts unter Shopeinstellungen/Zahlungsarten. Dort finden Sie eine Liste der installierten Zahlungsarten. Copyright easycredit 2016 Seite 8 / 14

9 Mit einem Klick auf die Ratenkauf-Zahlungsart öffnet sich die Detailansicht mit allen relevanten Konfigurationsoptionen: Haben Sie beide Einstellungen aktiviert, so sollte Ratenkauf nun am Artikel sichtbar sein: Danach müssen einige Einstellungen vorgenommen werden, die es Ihren Besuchern erlaubt, die Zahlungsart Ratenkauf by easycredit zu benutzen. Dazu muss die Zahlungsart mit den entsprechenden Benutzergruppen, Ländern und Zahlungsarten verknüpft werden. Copyright easycredit 2016 Seite 9 / 14

10 5.2 Schritt 2: Konfiguration weiterer Verknüpfungen Zunächst muss die Zahlungsart Ratenkauf by easycredit in den richtigen Ländern aktiviert werden. Sie finden den Button zu dieser Einstellung auf der rechten Seite des Konfigurationsbildschirms für Zahlungsarten: Für die Aktivierung von Ländern ziehen Sie einfach das entsprechende Land per Drag'n'Drop von der linken Liste aller im Shop verfügbaren Länder nach rechts in die Liste der Länder, in denen Ratenkauf by easycredit aktiviert werden soll. Danach ordnen Sie bitte die Benutzergruppen dem Modul auf ähnliche Weise zu: Auch dort können Sie Drag'n'Drop nutzen, um alle relevanten Benutzergruppen zu erlauben: Copyright easycredit 2016 Seite 10 / 14

11 Nun ist noch notwendig, dass die relevanten Versandarten mit easycredit verwendet werden können. Dazu wählen Sie bitte den Punkte Shopeinstellungen/Versandarten aus dem Admin-Menü aus: Dort finden Sie analog zu den vorigen Schritten wieder eine Liste der Versandarten vor. Mit einem Klick auf einen passenden Eintrag aktivieren Sie diesen wieder und finden unten alle Details vor: Copyright easycredit 2016 Seite 11 / 14

12 Mit einem Klick auf den Button "Zahlungsarten zuordnen" öffnet sich eine ähnliche Ansicht wie den vorigen beiden Schritten. Hier können Sie die Zahlungsart Ratenkauf by easycredit durch Drag'n'Drop für die ausgewählte Versandart aktivieren. An dieser Stelle gehen wir davon aus, dass grundsätzlich die verwendeten Länder, Versandarten mit Versandkostenregelungen sowie die Benutzergruppen so eingerichtet sind, dass sich eine gültige Kombination für Ihre Besucher ergibt. Copyright easycredit 2016 Seite 12 / 14

13 6 Versionshinweise Copyright easycredit 2016 Seite 13 / 14