PostFinance Plugin Installationsanleitung Plugin version: 1.0.0 Shopware versions: 4.1.x 4.3.x Copyright Tarkka.ch 2014 1/9
Inhaltsverzeichnis 1. Einführung... 2 2. Installation... 3 3. Plugin Setup... 4 3.1. Grundeinstellungen des Plugins... 5 3.2. Status Einstellungen... 6 3.3. DirectLink Setup... 7 3.4. Zahlungsmethoden... 8 3.5. Vorlageneinstellungen... 9 1. Einführung PostFinance ist ein führender Finanzdienstleister aus der Schweiz und bietet ein umfangreiches Angebot an Zahlungslösungen für Onlineshops. Unser Postfinance-Modul lässt sich einfach integrieren und konfigurieren. Es fügt sich optimal in den Zahlungsprozess ein. Das Modul unterstützt den one page checkout1 (DirectLink Postfinance) für die Zahlung mit Kreditkarte. Benutzen Sie das Dynamic Template. Mit diesem wird Ihr Kunde zum Payment bei Postfinance weitergeleitet, aber das Design ist mit dem Ihres Shops identisch. Achtung: Für die Anbindung brauchen Sie einen Vertrag mit Postfinance. Wir unterstützen Sie gerne. 1 SSL ist zwingend nötig Copyright Tarkka.ch 2014 2/9
2. Installation Erstellen Sie eine Datensicherung bevor Sie mit der Installation beginnen. Falls Sie sich nicht sicher fühlen können Sie uns mit der Installation beauftragen. Wenn Sie das Plugin über den Community-Store gekauft oder gemietet haben können Sie es wie gewohnt downloaden und aktivieren. Meine Einkäufe > hier finden Sie das Plugin zum Download Community-Erweiterungen > hier können Sie das Plugin aktivieren Wenn Sie ein zip-file besitzen können Sie dies unter Community-Erweiterungen über den Button Plugin manuell hinzufügen hochladen. 1. Gehen Sie zum Shop Backend Einstellungen Plugin Manager Community- Erweiterungen PostFinance payments plugin und Plugin installieren (Bild 2.1) 2. Die Frage nach dem Cache leeren beantworten Sie mit Ja 3. Aktivieren Sie nun das Plugin 4. Laden Sie die Seite neu, damit das Plugin erscheint Bild 2.1 Plugin Manager Copyright Tarkka.ch 2014 3/9
3. Plugin Setup Gehen Sie im Backend zu Einstellungen PostFinance (Bild 3.1). Folgen Sie Punkt 3.1. 3.5. um das Setup des Moduls durchzuführen. Speichern Sie Ihre Änderungen. Bild 3.1 Konfiguration des Plugin Copyright Tarkka.ch 2014 4/9
3.1. Grundeinstellungen des Plugins 1. Wählen Sie den Tab Grundeinstellungen (Bild 3.1.1) PostFinance module installation guide 2. Testmodus aktivieren Ihre Zahlungen und andere Informationen finden Sie in Ihrem Test-Account von Postfinance. Wenn Sie die Tests abgeschlossen haben deaktivieren Sie den Testmodus wieder. 3. Transaktion - Reservation oder Buchung Wenn Sie diese Funktion aktivieren werden Zahlungen lediglich reserviert und die Buchung muss im Backoffice manuell erfolgen. Andernfalls erfolgt die Belastung unmittelbar mit der Bestellung. 4. Fügen Sie PSPID ein, welche Sie von Postfinance erhalten haben. 5. Wählen Sie den SHA hash algorithm Diesen müssen Sie auch im Backoffice von Postfinance einrichten. 6. SHA-IN Bitte erst im Backoffice erstellen und dann hier einfügen. 7. SHA-OUT Bitte erst im Backoffice erstellen und dann hier einfügen. 8. Fügen Sie hier eine shopspezifische Order ID ein Arbeiten Sie mit mehreren Shops fügen Sie bitte für jeden Shop eine andere Order ID ein. Bild 3.1.1 Grundeinstellungen Copyright Tarkka.ch 2014 5/9
3.2. Status Einstellungen 1. Wählen Sie den Tab Status-Einstellungen (Bild 3.1.2) 2. Status bei erfolgreicher Bestellung 3. Status für anulierte Bestellungen 4. Status für Bestellungen mit einer Fehlermeldung 5. Status bei erfolgreicher Zahlung 6. Status bei abgebrochenem Zahlungsvorgang 7. Status nach fehlerhaftem Zahlungsvorgang Bild 3.1.2 Status-Einstellungen Copyright Tarkka.ch 2014 6/9
3.3. DirectLink Setup 1. Wählen Sie den Tab DirectLink Einstellungen (Bild 3.1.3) 2. Aktivieren Sie Direct Link Direct Link ermöglicht Ihnen Kreditkartenzahlungen im Shop. Diese Funktion muss bei Postfiance bestellt werden. Achtung: Direct Link benötigt SSL 3. Fügen Sie Ihre PostFinance API ID ein Den API-User können Sie Backoffice von Postfinance erstellen. 4. Fügen Sie hier die PostFinance API Passwort ein Den API-User können Sie Backoffice von Postfinance erstellen Bild 3.1.3 DirectLink Einstellungen Copyright Tarkka.ch 2014 7/9
3.4. Zahlungsmethoden 1. Wählen Sie den Tab Zahlungsmethoden (Bild 3.1.4) 2. Wählen Sie die Zahlungsmethoden die Sie bei Postfinance gebucht haben Warnung: Wenn Sie auf speichern klicken werden die neuen Zahlungsmittel angelegt. Die Konfiguration erfolgt wie bei anderen Zahlungsmitteln. Damit man die neu erstellen Zahlungsmittel besser erkennt wird (Postfinance) angefügt. Dies können Sie beliebig ändern. Bild 3.1.4 Zahlungsmethoden Copyright Tarkka.ch 2014 8/9
3.5. Vorlageneinstellung 1. Wählen Sie den Tab Vorlageneinstellungen (Bild 3.1.5) 3. Dynamic Template aktivieren Mit Dynamic Template wird die Zahlungsmaske in den Bestellprozess des OXID eshop integriert. ATTENTION: Dynamic Template benötigt SSL und muss bei Postfinance aktiviert sein. 4. Statische Template-Einstellungen Deaktivieren Sie Dynamic Template um die Einstellungen hier vornehmen zu können. English / German Titel Titel der auf der Payment- Colors Die Farben können Sie sowohl mit dem hexadezimal Code (#ffffff) oder aber mit einer Farbangabe wie white definiert werden. Es empfiehlt sich die Farben in verschiedenen Browsern anzusehen. Font type Es empfiehlt sich nur übliche Font type wie Arial, Verdana etc. zu verwenden. Logo URL Fügen Sie hier den absoluten Pfad zu Ihrer Grafik ein. Das Logo muss unter SSL erreichbar sein. Bild 3.1.5 Vorlageneinstellung Copyright Tarkka.ch 2014 9/9