# Shopware 6 User Guide - German ## 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](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Fintegration-guide%2Ftesting-and-go-live\&data=05%7C01%7Cintegration.saferpay%40worldline.com%7C4b2ee8bc965a4cc3f7e908db56eeddd4%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638199356159277668%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C\&sdata=GLy0p%2F66vkWZw8NVDdR4jbM%2FslewaFsNl0X%2B%2FSvzeZc%3D\&reserved=0)). * 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](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Ffeatures%2Fpayment-page-configuration\&data=05%7C01%7Cintegration.saferpay%40worldline.com%7C4b2ee8bc965a4cc3f7e908db56eeddd4%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638199356159277668%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C\&sdata=hywzxn%2F78JVHKCC%2B%2B6usIVlvcY5lDfJrfoioaKenncM%3D\&reserved=0)) 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](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Fintegration-guide%2Flicences-and-interfaces%2Fgeneral-information%2F3d-secure%23forcing-a-3ds-challenge\&data=05%7C02%7Cintegration.saferpay%40worldline.com%7C703951403ec04c2db2cd08dd0ecbbe49%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638682990439539341%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C\&sdata=KYH%2BXT64M%2FEUNdQgTv%2FSzVDdKFWZKhucOkX8U1%2BjxXo%3D\&reserved=0)) * 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](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/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](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/saferpay-fields) 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).](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Fintegration-guide%2Flicences-and-interfaces%2Fsecure-card-data\).\&data=05%7C02%7Cintegration.saferpay%40worldline.com%7C703951403ec04c2db2cd08dd0ecbbe49%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638682990439553884%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C\&sdata=dxMWxccD9sbsrXdFO9iu3hNl9dI2b4zQ2oPp3qWhiPA%3D\&reserved=0)\ 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](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Fintegration-guide%2F3d-secure\&data=05%7C01%7Cluca.schweizer%40worldline.com%7C1d5e3c65cd304dd2ca2708db5c425329%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638205212162542061%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C\&sdata=q7IDjRTwWH%2FsiGpCur%2BBEB2MT6NC43AE7MfezJrO0VU%3D\&reserved=0)) 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*](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.saferpay.com%2Fhome%2Fintegration-guide%2Flicences-and-interfaces%2Fsaferpay-fields\&data=05%7C02%7Cintegration.saferpay%40worldline.com%7C47ea73acbfbf4032cb5e08dc86e34173%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638533557845800379%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C\&sdata=LTn1PkwApJO0dAmRjXzYGcoj%2BPvmyQNJUPTijBDd7gw%3D\&reserved=0) 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.
### 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 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.
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.
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.
{% hint style="warning" %} 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](https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.shopware.com%2Fde%2Fshopware-6-de%2Fbestellungen%2Fretouren-management\&data=05%7C02%7Cintegration.saferpay%40worldline.com%7Cd4485ec1828e4003314d08dc6b6a0621%7Cfda9decfe89243ac9d9f1a493f9f98d0%7C0%7C0%7C638503350322048962%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C\&sdata=6IwN3yJVsKJlmIGO24Knq0%2F6UMQgjx3hhpermwHT%2B7E%3D\&reserved=0)). {% endhint %} 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:
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.saferpay.com/home/master/web-shop-plug-ins/shopware-6/shopware-6-user-guide-german.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.