Shopware 6 User Guide - German
Saferpay Plugin für Shopware 6
Voraussetzungen
Shopware Version 6.4.8.x - 6.7.x.x
Saferpay Account mit mindestens einem eCommerce-Terminal
Saferpay API Credentials (Customer-ID, Terminal-ID, JSON API Benutzername und Passwort)
Gültige Akzeptanzverträge für die zu verwendenden Zahlungsmittel
Installation und Aktivierung
Loggen Sie sich ins Shopware 6 Backend ein.
Navigieren Sie zu: Erweiterungen--> Meine Erweiterungen --> Apps -->Erweiterung hochladen und laden Sie das Plugin hoch oder installieren Sie das Plugin über Ihren Shopware Account
Öffnen Sie das Kontextmenü über den "..."-Button und klicken Sie auf den Button Installieren.
Unter Meine Erweiterungen --> Apps aktivieren Sie das Plugin über den entsprechenden Schalter
Konfiguration
Allgemeine Einstellungen
Klicken Sie auf der rechten Seite auf den Button mit den drei Punkten (…) und wählen Sie Konfigurieren um zur Plugin-Konfiguration zu gelangen
Unter Betriebsart wählen Sie entweder "Live" oder "Test" aus, je nachdem welche Saferpay-Umgebung Sie verwenden möchten (siehe https://docs.saferpay.com/home/integration-guide/testing-and-go-live).
Geben Sie unter Händler-Email-Adressen eine kommaseparierte Liste von bis zu 10 E-Mail-Adressen ein, die eine Bestätigungs-Email nach erfolgreicher Zahlungsautorisierung erhalten sollen.
Unter Payment Page-Konfiguration können Sie die Payment Page Konfiguration (https://docs.saferpay.com/home/features/payment-page-configuration) festlegen, die Sie verwenden möchten, indem Sie den Namen der entsprechenden Konfiguration eingeben.
Mit der Option “Zahlungsdaten speichern” wird definiert, ob die Zahlungsinformationen via Secure Card Data gespeichert werden sollen (mehr Informationen entnehmen Sie der Sektion “Zahlungsdaten speichern”)
Mit der Option “3-D Secure erzwingen” wird definiert, ob eine 3-D-Secure-Challenge erzwungen werden soll (siehe https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/general-information/3d-secure#forcing-a-3ds-challenge)
Über die Option "Zahlungsreferenz" lässt sich festlegen, ob die Bestellnummer oder die Bestell-ID als Referenz an Saferpay übermittelt werden soll.
Im Konfigurationsblock Payment API (JSON API) Live-Zugangsdaten geben Sie die Daten Ihres Saferpay Live Accounts ein (Customer-ID, Terminal-ID, JSON API Username, JSON API Passwort), die verwendet werden sollen, wenn die Betriebsart "Live" ausgewählt ist.
Im Konfigurationsblock Payment API (JSON API) Test-Zugangsdaten geben Sie die Daten Ihres Saferpay Test Accounts ein (Customer-ID, Terminal-ID, JSON API Username, JSON API Passwort), die verwendet werden sollen, wenn die Betriebsart "Test" ausgewählt ist.
Im Konfigurationsblock "Zahlungserfassungsverhalten" können Sie für jede Saferpay-Zahlungsmethode, welche manuelle Zahlungserfassungen unterstützt, individuell konfigurieren, ob die Zahlung automatisch erfasst (Auto-Capturing) werden sollen oder nicht (mehr Informationen entnehmen Sie der Sektion “Manuelle Zahlungserfassung”).
Saferpay Fields
Anstatt den Nutzer während des Bezahlprozesses zur Eingabe der Zahlungsinformationen auf die Saferpay Payment Page umzuleiten, ermöglicht Saferpay Fields die direkte Eingabe der Zahlungsinformationen (z.B. Kreditkartendaten) im letzten Checkout-Schritt. Dies kann für jede Zahlungsart individuell konfiguriert werden. Bitte beachten Sie, dass die Integration nur mit den von Saferpay unterstützten Zahlungsarten funktioniert; andernfalls erfolgt als Fallback die Bezahlung über die Payment Page.
Iframe Integration
Anstatt den Nutzer zu Saferpay weiterzuleiten, kann die Zahlungsverarbeitung über die Iframe Integration direkt in den Shopware Checkoutprozess eingebettet werden. Die Iframe Integration wird für Saferpay Fields als auch für die Payment Page unterstützt.
Zahlungsdaten speichern
Zahlungsdaten können über Secure Card Data gespeichert werden (siehe https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/secure-card-data). Die gespeicherten Zahlungsinformationen können im Shopware-Kunden-Konto eingesehen und gelöscht werden:
Falls Sie Saferpay Fields nutzen, können Kunden die gespeicherten Zahlungsinformationen für ihren nächsten Einkauf verwenden:
Zahlungsmethoden hinzufügen
Nachdem Sie die allgemeinen Einstellungen für das Saferpay-Plugin vorgenommen haben, müssen Sie die Zahlungsarten konfigurieren, welche Sie unterstützen wollen:
Gehen Sie zur Seite Einstellungen -> Zahlungsarten im Shopware 6 Admin-Bereich.
Hier erscheinen nun alle Zahlungsarten, die vom Saferpay-Plugin unterstützt werden.
Öffnen Sie die Details der Zahlungsart, die Sie verwenden möchten.
Aktivieren Sie die Zahlungsart
Im Block Zusatzfelder im Tab Saferpay stehen Ihnen verschiedene Felder zur Verfügung, um die Zahlungsart zu konfigurieren.
Unter Zahlungsmittel können Sie explizit einstellen, welche Zahlungsmittel auf der Saferpay Payment Page zur Verfügung stehen sollen, wenn diese Zahlungsart in der Storefront ausgewählt wird. Beachten Sie dabei, dass die Zahlungsart auch im Saferpay-Terminal aktiviert sein muss. Wenn Sie dieses Feld leer lassen, werden alle im Saferpay-Terminal verfügbaren Zahlungsarten angeboten.
Wenn 3D-Secure (https://docs.saferpay.com/home/integration-guide/3d-secure) durch die Zahlungsart unterstützt wird, können Sie unter Verhalten bei Haftungsumkehr einstellen, ob die Zahlung abgebrochen werden soll, wenn keine Haftungsumkehr gewährt wird oder ob die Zahlung trotzdem akzeptiert werden soll.
Unter Wallets können Sie einstellen, welche Wallets auf der Saferpay Payment Page zur Verfügung stehen sollen, wenn diese Zahlungsart in der Storefront gewählt wird. Auch hier muss die Zahlungsart im Saferpay-Terminal aktiviert sein. Wenn Sie dieses Feld leer lassen, werden keine Wallets angeboten.
Beachten Sie, dass alle Konfigurationen individuell für jede Shopware-Sprache konfiguriert werden können. Standardmäßig sind für alle NICHT-Standard-Sprachen alle Felder leer. Wenn ein Feld in einer NICHT-Standardsprache leer ist, wird der Wert von der Standardsprache übernommen.
Einrichten der Checkout Page
Zu guter Letzt müssen die Zahlungsarten noch den Verkaufskanälen zugewiesen werden, damit Kunden diese im Checkout-Prozess auswählen können. Dazu gehen Sie wie folgt vor:
Navigieren Sie im Shopware 6 Admin-Bereich unter Verkaufskanäle.
Wählen Sie den Verkaufskanal aus, für den Sie die Zahlungsarten aktivieren möchten.
Ordnen Sie im Block Zahlung und Versand die Saferpay-Zahlungsarten zu, die Sie für diesen Verkaufskanal verwenden möchten.
Nach der Zuweisung der Zahlungsarten zu den Verkaufskanälen stehen in der Storefront die entsprechenden Saferpay-Zahlungsmethoden zur Verfügung.
Gutschriften
Wurden bereits Beträge erfasst, können Sie im Reiter „Saferpay“ entweder einen spezifischen Teilbetrag oder alle erfassten Beträge auf einmal rückerstatten.
Seit den Plugin-Versionen 1.8.0, 2.6.0 und 3.1.0 kann konfiguriert werden, ob für Rückerstattungen die Bestellnummer oder die Bestell-ID als Referenz an Saferpay übermittelt werden soll:
Manuelle Verbuchung
Falls Sie bei einer Zahlungsart “Manuell" konfigurieren, wird nach jedem Bezahlvorgang mit dieser Zahlungsart der Shopware-Zahlungsstatus auf “Autorisiert" und nicht direkt auf “Bezahlt” gesetzt. Um die Zahlung nach einer Autorisierung manuell zu bestätigen (Capturing), müssen Sie über das Shopware-Backend den Zahlungsstatus der entsprechenden Bestellungen von “Autorisiert” auf “Bezahlt" setzen. Bei der Shopware-Statusänderung wird die entsprechende Saferpay-Zahlung verbucht.
Unter dem Reiter „Saferpay“ lassen sich zudem mehrere spezifische Teilbeträge erfassen:
Autorisierte Beträge stornieren
Sie können Autorisierungen freigeben oder stornieren, indem Sie den Shopware-Zahlungsstatus auf „Abgebrochen“ setzen oder im Reiter „Saferpay“ auf die Schaltfläche „Autorisierung stornieren“ klicken.
Last updated
Was this helpful?