Shopware 6 User Guide - German
Saferpay Plugin für Shopware 6
Voraussetzungen
Shopware Version 6.4.8.x - 6.6.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
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FeXR6uUcXg2Oh0bKGTonL%252F1_Installation_MyExtensions.png%3Falt%3Dmedia%26token%3D89454070-13f6-48f3-95ba-dacbb6247a0b&width=768&dpr=4&quality=100&sign=3b81dd77&sv=1)
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 Theme können Sie ein Theme auswählen, um das Erscheinungsbild der Zahlungsseite anzupassen.
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.
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.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FbIKnQR54n48NVDDBR7pf%252F2_Configuration_GeneralSettings.jpg%3Falt%3Dmedia%26token%3Db64c2903-bba7-4faf-8d55-0610a81b2b53&width=768&dpr=4&quality=100&sign=c24ffc61&sv=1)
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.
Storefront integration: 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 im letzten Checkout-Schritt. Bitte beachten Sie, dass Saferpay Fields nur mit Karten-Zahlungsmitteln funktioniert, andernfalls erfolgt als Fallback die Bezahlung über die Payment Page. Ausserdem muss Saferpay Fields bei Ihrem Saferpay Account bzw. Vertrag enthalten sein, andernfalls kann nur die Payment Page verwendet werden.
Redirect URL handling: Beschreibung folgt in Kürze.
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.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FdeSiuGpAQwFjXOdVRDL1%252F3_Configuration_AddingPaymentMethods.png%3Falt%3Dmedia%26token%3De9df6141-7070-435d-8a76-4e77b10bd6d6&width=768&dpr=4&quality=100&sign=a921d272&sv=1)
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FFcNOYaxDrUjBgRnBRVLA%252F3.1_Configuration_AddingPaymentMethods_Edit.png%3Falt%3Dmedia%26token%3D52090f78-117f-4813-97f0-e9967fdb7da4&width=768&dpr=4&quality=100&sign=49c335f1&sv=1)
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.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FVy7kopdErnCjw6zYp4Ac%252F4_Configuration_CheckoutPage.png%3Falt%3Dmedia%26token%3D03dde7d7-41a8-4e44-bf20-866e2a90da97&width=768&dpr=4&quality=100&sign=5e18da88&sv=1)
Gutschriften
Um eine Rückerstattung über Saferpay durchzuführen, können Sie in der Shopware-Administration einfach die entsprechenden Positionen auswählen, die zurückerstattet werden sollen. Dazu klicken Sie auf den Button "Über Saferpay rückerstatten". Bitte beachten Sie, dass dieser Button nur sichtbar ist, wenn die Bestellung über Saferpay bezahlt wurde und den Zahlungsstatus "Bezahlt" aufweist.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FpB8gWWXVVEohuqWBAsYG%252Frefund_1_20240502150926.png%3Falt%3Dmedia%26token%3De53353d4-a5cb-4e2c-a7dd-0a10842c7a08&width=768&dpr=4&quality=100&sign=dd549617&sv=1)
In einem Overlay haben Sie die Möglichkeit, die Stückzahlen der ausgewählten Positionen anzupassen, die rückerstattet werden sollen. Nachdem Sie die gewünschten Anpassungen vorgenommen haben, klicken Sie auf den Button "Rückerstatten". Dadurch wird der entsprechende Geldbetrag über die vom Kunden gewählte Zahlungsart zurückerstattet.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FjrukdDmCshobXw8cgbPf%252Frefund_2_20240502150951.png%3Falt%3Dmedia%26token%3D298485a7-d8aa-450a-bbda-9886d87d9475&width=768&dpr=4&quality=100&sign=52db0f65&sv=1)
Nach erfolgreicher Rückerstattung wird der Zahlungsstatus auf "Erstattet" oder "Teilweise erstattet" aktualisiert. Zusätzlich können Sie die Rückerstattung und die dazugehörige Transaktions-ID im neuen Tab "Saferpay Rückerstattungen" einsehen.
![](https://docs.saferpay.com/~gitbook/image?url=https%3A%2F%2F3537448238-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fzpi9teY7Tm2pCZ1Bw8zO%252Fuploads%252FQX9acjlht8TTCQHtmf01%252Frefund_3_20240502151450.png%3Falt%3Dmedia%26token%3D6dd06a35-f221-4019-ac90-2e2f9255c48d&width=768&dpr=4&quality=100&sign=9f0412b0&sv=1)
Bitte beachten Sie, dass derzeit nur eine Rückerstattung pro Bestellung erstellt werden kann. Zudem findet derzeit auch noch keine automatische Bestandsberechnung statt. Diese muss manuell durchgeführt werden (siehe https://docs.shopware.com/de/shopware-6-de/bestellungen/retouren-management).
Last updated