> For the complete documentation index, see [llms.txt](https://docs.saferpay.com/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saferpay.com/home/master/web-shop-plug-ins/shopware-6/shopware-6-user-guide-german.md).

# 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

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FeXR6uUcXg2Oh0bKGTonL%2F1_Installation_MyExtensions.png?alt=media&amp;token=89454070-13f6-48f3-95ba-dacbb6247a0b" alt=""><figcaption></figcaption></figure>

## 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))
* Ü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](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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FCBflD08rouMkcbGu8KiA%2Fsaferpay_fields_integration_20240606120806.png?alt=media&amp;token=f5999d10-6ce1-4f25-a090-95a99bd88e9c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FaMrrzjDutkq426jhM1No%2Fsaferpay_fields_frontend_20240606121046.png?alt=media&amp;token=ed41417e-0209-4560-aa4b-b7724d1bf8e4" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FvtIgd1yumDdinyIBZKmZ%2Fiframe_integration_20240606121932.png?alt=media&amp;token=75cbc3ad-9d1a-4c7f-8d76-bc073fec9fee" alt=""><figcaption></figcaption></figure>

### 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:

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2Fyx5eD0irLVMSO2wxzMHH%2Faccount-stored-payment-data_20241126102751.png?alt=media&amp;token=3d7d8619-8a19-42fa-a7c1-e89098103f0a" alt=""><figcaption></figcaption></figure>

Falls Sie Saferpay Fields nutzen, können Kunden die gespeicherten Zahlungsinformationen für ihren nächsten Einkauf verwenden:&#x20;

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FW8LtMJPqQPp2QFXIX3jT%2Fcheckout-stored-payment-data_20241126103511.png?alt=media&amp;token=a074a40b-4c3b-4e0b-ae1f-a4982df6bc53" alt=""><figcaption></figcaption></figure>

### 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.
* 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FdeSiuGpAQwFjXOdVRDL1%2F3_Configuration_AddingPaymentMethods.png?alt=media&amp;token=e9df6141-7070-435d-8a76-4e77b10bd6d6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FFcNOYaxDrUjBgRnBRVLA%2F3.1_Configuration_AddingPaymentMethods_Edit.png?alt=media&amp;token=52090f78-117f-4813-97f0-e9967fdb7da4" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FVy7kopdErnCjw6zYp4Ac%2F4_Configuration_CheckoutPage.png?alt=media&amp;token=03dde7d7-41a8-4e44-bf20-866e2a90da97" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FbF1HOxDFMawjgtPsrLne%2FTransactionDetails_RefundButton.png?alt=media&amp;token=dbfe4c2e-44fb-4b85-a981-376aaf83b2c8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FbQpCEIFAj0hbrcJiF7x4%2FRefundAllOrPartial.png?alt=media&amp;token=48817aaf-1ab0-46be-88f6-919af9c5f9f9" alt=""><figcaption></figcaption></figure>

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:

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FuCyxMZXmyn0jdCRAGKJM%2FRefundReference.png?alt=media&amp;token=4b7be489-4cae-42c6-946e-4a1229330e4d" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2Fg9gPX7rG5TpfDCELGxeP%2FManualCapture1.png?alt=media&amp;token=140158b1-f5f8-425a-84fc-7d73babf0449" alt=""><figcaption></figcaption></figure>

Unter dem Reiter „Saferpay“ lassen sich zudem mehrere spezifische Teilbeträge erfassen:

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FYyAbdWLOeWhktCMKnxwn%2FMultipartCapture.png?alt=media&amp;token=22beb40a-91b9-4dda-970f-b4d93560caa3" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FGE4sYOJyjaAlFyYw7L6t%2FCancel.png?alt=media&amp;token=54131366-b732-4e8b-868d-aae00e80726f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Wenn bereits Teilzahlungen verbucht wurden, lässt sich der Saferpay-Status nicht mehr auf „Abgebrochen“ setzen. Um den Restbetrag in diesem Fall zu stornieren, nutzen Sie die Schaltfläche „Autorisierung stornieren“ im Reiter „Saferpay“.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.saferpay.com/home/master/web-shop-plug-ins/shopware-6/shopware-6-user-guide-german.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.