Shopware Payments

Mit Shopware Payments verwaltest du unterstützte Zahlungsarten und Zahlungsvorgänge in der Shopware-Administration. Diese Anleitung führt dich von den Voraussetzungen über die Einrichtung bis zum Produktivbetrieb und zur Fehlerbehebung.

Die Bereitstellung hängt von deiner Shopware-Version ab – beachte daher vor dem Start den Installationshinweis.

Schnellstart

Shopware-Payments-Übersicht mit Konto- und Verwaltungsbereichen.

1. Prüfe deine Shopware-Version, dein Händlerland und die Kontoanforderungen.

2. Aktiviere Shopware Payments oder installiere die App – abhängig von deiner Version.

3. Verbinde ein Shopware-Payments-Konto oder wähle für Tests das bereitgestellte Testkonto.
4. Ordne das gewünschte Konto dem richtigen Verkaufskanal zu.
5. Richte die verfügbaren Zahlungsmethoden ein und aktiviere die gewünschten Methoden.
6. Teste den Checkout und die Bestellbearbeitung, bevor du auf ein Produktivkonto umstellst.

Shopware Payments basiert auf der PayPal-Infrastruktur und wird in der Shopware-Administration verwaltet. Es ersetzt nicht grundsätzlich andere Payment-Service-Provider; externe Anbieter können weiterhin genutzt werden.

Voraussetzungen und Verfügbarkeit

Unterstützte Versionen

Händler und Regionen

• Du benötigst eine gültige Shopware-Installation.

• Voraussetzung sind PayPal Business Services in einer unterstützten Region.

• Je nach Geschäftsmodell können zusätzliche Prüfungen zu Verifizierung und Compliance erforderlich sein.

• Shopware Payments ist derzeit für Händler in Deutschland und Österreich verfügbar. Weitere EU-Märkte und die USA werden schrittweise ergänzt.

Pläne und Support

Shopware Payments ist in der Community Edition sowie in den Plänen Rise, Evolve und Beyond verfügbar. Support- und Reaktionszeiten richten sich nach dem jeweiligen Plan. Die konkreten Angaben können sich ändern; aktuelle Konditionen findest du in den verlinkten Shopware-Plan- und Supportinformationen.

Shopware Payments aktivieren oder installieren

Shopware 6.7.1.0 und höher

1. Öffne in der Shopware-Administration Einstellungen > System > Shopware Services.

2. Aktiviere Shopware Payments.
3. Öffne den Bereich über die Hauptnavigation Shopware Payments oder über Einstellungen > Zahlungsarten > Shopware Payments.
4. Starte das Onboarding.

Shopware 6.5.7.x bis 6.6.10

1. Öffne die Shopware-Administration.
2. Gehe zu Erweiterungen > Meine Erweiterungen > Apps.
3. Suche nach Shopware Payments.
4. Installiere und aktiviere die App.
5. Starte anschließend das Onboarding.

Konto verbinden und Verkaufskanäle zuordnen

Ein verbundenes Konto verarbeitet Zahlungen für die Verkaufskanäle, die ihm zugeordnet sind. Prüfe diese Zuordnung sorgfältig, besonders wenn du mehrere Marken, Länder-Shops oder B2B- und B2C-Kanäle betreibst.

Konto hinzufügen

Einstieg zum Verbinden eines weiteren Kontos.

1. Öffne Shopware Payments > Einstellungen > Konten.

2. Klicke auf Konto hinzufügen (1).

3. Wähle das Land, in dem dein Unternehmen registriert ist.
4. Klicke auf Onboarding starten und folge den angezeigten Schritten.

Während des Onboardings wird ein PayPal-Geschäftskonto erstellt oder ein bestehendes Konto verknüpft. Je nach Land, Unternehmensform und Kontostatus können Unternehmens-, Kontakt- und Steuerdaten sowie Informationen zu wirtschaftlich Berechtigten oder Nachweise verlangt werden.

1. Wähle in der Kontoübersicht das verbundene Konto.
2. Wähle im Feld Verkaufskanäle einen oder mehrere Kanäle aus.
3. Prüfe, ob jeder Kanal dem beabsichtigten Konto zugeordnet ist.

Ein Konto kann mehreren Verkaufskanälen zugeordnet werden. So können mehrere Storefronts oder Sprachshops dieselbe Anbindung nutzen. Eine falsche Zuordnung kann dazu führen, dass Zahlungen über ein anderes Konto laufen als beabsichtigt.

Kontostatus und Verwaltung

Der Status Aktiv bedeutet, dass das Konto verbunden und für die Zahlungsabwicklung nutzbar ist. Über Account verwalten kannst du – abhängig vom Konto – Kontoinformationen, Unternehmensdaten, Auszahlungsinformationen und Verifizierungsanforderungen verwalten.

Einrichtung im Testmodus prüfen

Shopware Payments stellt ein Testkonto bereit. Separate Sandbox-Zugangsdaten sind dafür nicht erforderlich. Im Testmodus werden Transaktionen simuliert und keine echten Zahlungen verarbeitet.

1. Öffne in den Shopware-Payments-Einstellungen den Tab Zuordnung (1).

2. Klicke beim gewünschten Verkaufskanal auf Details (2).

3. Öffne das Dropdown-Menü und wähle Testmodus (3).

4. Führe deine Checkout- und Bestelltests im betreffenden Verkaufskanal durch. Wähle vorab die gewünschten Zahlungsmethoden aus der Liste aus.

Konten im Testmodus sind mit dem Status Test gekennzeichnet. Für den Produktivbetrieb musst du dem Verkaufskanal ein produktives Konto zuweisen. Prüfe vor dem Wechsel ausdrücklich die Zuordnung, damit Zahlungen nicht versehentlich im Testmodus bleiben oder über ein falsches Konto laufen.

Zahlungsmethoden verwalten

Öffne Shopware Payments > Einstellungen > Zahlungsmethoden. Dort kannst du den Status einsehen, Details bearbeiten und festlegen, ob eine Zahlungsart im Checkout angeboten wird.

Mögliche Zahlungsarten

Die verfügbaren Methoden hängen vom Konto und den unterstützten Ländern ab. Mögliche Zahlungsarten sind unter anderem: PayPal, Später Bezahlen, Kauf auf Rechnung (für Händler in Deutschland), Klarna, Kredit- oder Debitkarte, Apple Pay, Google Pay, Bancontact, SEPA-Lastschrift, Venmo, BLIK und EPS.

Status einer Zahlungsmethode

Über Bearbeiten öffnest du die Detailkonfiguration einer Zahlungsart. Dort können je nach Methode zusätzliche Einstellungen, etwa für Länder, verfügbar sein. Mit dem Schalter Aktiv steuerst du, ob die Methode Kunden im Checkout angezeigt wird. Bereits bestehende Bestellungen bleiben von einer Deaktivierung unberührt.

Allgemeine Einstellungen

Öffne Shopware Payments > Einstellungen > Allgemein. Viele Einstellungen lassen sich für alle Verkaufskanäle oder einzeln setzen. Wähle zuerst den gewünschten Geltungsbereich.

Zahlungseinzug

Zahlungsmethoden speichern (Vaulting)

Aktiviere Vaulting, wenn Kunden unterstützte Zahlungsinformationen für spätere Einkäufe speichern können sollen. Unterstützt werden Kreditkarten, Debitkarten und PayPal. Für wiederkehrende PayPal-Zahlungen, etwa bei Abonnements, muss Vaulting für PayPal aktiviert sein.

Sicherheit: 3D Secure

Mit Transaktionen ohne 3D Secure blockieren werden Zahlungen ohne erfolgreiche 3D-Secure-Prüfung abgelehnt. Das kann den Schutz vor Betrug und das Chargeback-Risiko beeinflussen. Nicht alle Karten unterstützen 3D Secure; das betrifft insbesondere Karten aus Ländern außerhalb des EWR. Bei einem hohen Anteil internationaler Kunden kann die Einstellung daher zu weniger akzeptierten Kartenzahlungen führen. Prüfe, ob sie zu deinen Zielmärkten passt.

Textangaben

Eingabefelder für angezeigte Textangaben.

• Markenname: Name deiner Marke oder deines Unternehmens, der im Bezahlvorgang angezeigt werden kann.

• Kundendienstanweisungen: Hinweise für Kunden, die Unterstützung benötigen, zum Beispiel ein Verweis auf deine Kontakt- oder Hilfeseite.

Express-Checkout

Der PayPal-Express-Checkout ist ab Shopware 6.7.4.0 verfügbar. Du kannst festlegen, auf welchen Seiten der Button erscheint: Produktdetailseite, Warenkorb, Offcanvas-Warenkorb, Anmeldeseite und Listingseiten. In älteren Shopware-Versionen ist die Funktion aufgrund technischer Einschränkungen des App-Systems nicht verfügbar.

„Jetzt kaufen, später zahlen“-Banner

Pay-Later-Banner informieren über verfügbare Finanzierungs- und Ratenzahlungsoptionen. Du kannst die Banner auf der Produktdetailseite, im Warenkorb, im Offcanvas-Warenkorb, auf der Anmeldeseite und Listingseite sowie im Footer anzeigen.

Button-Erscheinungsbild und Speichern

Du kannst Farbe, Form und Sprache der PayPal-Buttons festlegen. Die Button-Sprache beeinflusst nur den Button, nicht die Sprache des Shops. Klicke nach Änderungen auf Einstellungen speichern; nicht gespeicherte Änderungen gehen beim Verlassen der Seite verloren.

Apple Pay einrichten

Öffne Shopware Payments > Einstellungen > Apple Pay. Für Apple Pay muss die verwendete Shop-Domain einem aktiven Produktivkonto zugeordnet und erfolgreich registriert sein. Apple Pay wird im Testkonto nicht unterstützt.

1. Wähle im Feld Konto das aktive Händlerkonto aus.
2. Klicke auf Domain hinzufügen.
3. Gib den Domainnamen ohne Protokoll ein, zum Beispiel example.com oder shop.example.com.
4. Lade die Datei apple-developer-merchantid-domain-association herunter.
5. Lege die Datei auf deinem Webserver unter /.well-known/apple-developer-merchantid-domain-association ab.
6. Stelle sicher, dass die Datei öffentlich, ohne Authentifizierung und ohne Weiterleitung erreichbar ist. Bei Shopware-Installationen ist das Verzeichnis public das Webroot.
7. Klicke auf Domain registrieren und prüfe, ob die Domain als registriert angezeigt wird.

Beispielpfad auf dem Server: …/public/.well-known/apple-developer-merchantid-domain-association. Die zugehörige URL lautet beispielsweise https://example.com/.well-known/apple-developer-merchantid-domain-association.

Zahlungen in Bestellungen verwalten

Öffne eine Bestellung in der Administration und wechsle zum Reiter Shopware Payments. Dort findest du Zahlungsinformationen und – abhängig von Zahlungsabsicht und Transaktionsstatus – manuelle Aktionen.

Zahlungsinformationen und Verlauf

Die Bestellansicht kann Zahlerinformationen, Zahler-ID, Rechnungs-, Versand- und Gesamtbetrag, Zahlungsabsicht sowie Erstellungs- und Aktualisierungszeitpunkte anzeigen. Im Zahlungsverlauf stehen je Transaktion unter anderem Typ, Transaktions-ID, Betrag, Status, Gebühren und Zeitpunkte.

Zahlungsabsicht und Aktionen

Transaktionsstatus

Der Status Created zeigt eine erfolgreiche Autorisierung an. Completed bedeutet, dass eine Zahlung erfolgreich eingezogen wurde. Je nach Zahlungsart und Bearbeitungsstand können weitere Status angezeigt werden.

Zahlungsprozesse mit dem Flow Builder automatisieren

Capture Payment

Diese Flow Action zieht eine zuvor autorisierte Zahlung ein. Sie ist für Zahlungen mit der Zahlungsabsicht AUTHORIZE vorgesehen. Als Auslöser eignen sich beispielsweise der Versand einer Bestellung oder das Erreichen eines bestimmten Bestellstatus.

Release Funds

Die Aktion kann damit für automatisierte Stornierungen oder Rückabwicklungen verwendet werden. Richte den Flow so ein, dass der Status und die daraus folgende Wirkung zu deinem Geschäftsprozess passen.

Von der klassischen PayPal-Integration migrieren

Plane die Umstellung so, dass im Checkout keine doppelten Zahlungsarten erscheinen und Vorgänge zu bestehenden Bestellungen weiterhin bearbeitet werden können.

1. Prüfe, ob dein Shopware-Payments-Konto alle aktuell angebotenen Methoden enthält und diese einsatzbereit sind.
2. Aktiviere und konfiguriere Shopware Payments.
3. Deaktiviere zunächst die neuen Shopware-Payments-Zahlungsmethoden.
4. Ordne sie den gewünschten Verkaufskanälen zu und richte die Zuordnung möglichst wie bei den bisherigen Zahlungsmethoden ein.
5. Teste Checkout, Zahlung, Bestellanlage und Bestellbearbeitung.
6. Schalte die Shopware-Payments-Zahlungsmethoden produktiv und deaktiviere gleichzeitig die entsprechenden Methoden des PayPal-Plugins, damit keine doppelten Einträge entstehen.
7. Lasse das bisherige PayPal-Plugin installiert und aktiv, solange noch Erstattungen, Rückfragen oder andere Vorgänge zu alten Bestellungen bearbeitet werden müssen.
8. Deaktiviere oder deinstalliere das alte Plugin erst, wenn keine offenen Transaktionen und keine weiteren Vorgänge zu bestehenden Bestellungen mehr zu erwarten sind.

Fehlerbehebung

Zahlungsstatus wird nicht aktualisiert

1. Prüfe, ob dein Shop von außen erreichbar ist.
2. Prüfe, ob die Shop-API ohne Einschränkungen erreichbar ist.
3. Kontrolliere, ob Wartungsarbeiten, Netzwerkprobleme, Firewall-Regeln oder andere Zugriffsbeschränkungen vorliegen.
4. Wenn dein Shop wieder erreichbar ist, kontrolliere den Zahlungsstatus erneut. Ausstehende Statusaktualisierungen werden in vielen Fällen automatisch verarbeitet.

Ist dein Shop vorübergehend nicht erreichbar, können Statusänderungen ausbleiben, Transaktionen unvollständig synchronisiert oder zahlungsbezogene Aktionen verzögert verarbeitet werden. Besteht die Störung weiterhin, wende dich mit deiner Shopware-Version, der betroffenen Bestell- oder Transaktions-ID und dem Zeitpunkt an den Shopware-Support.

Zahlungsmethode ist nicht nutzbar

1. Prüfe den Status der Methode und ergänze gegebenenfalls fehlende Daten.
2. Prüfe Händler- und Kundenland, Währung sowie Konto-Freischaltungen.
3. Kontrolliere, ob das richtige Konto dem Verkaufskanal zugeordnet ist.
4. Prüfe, ob die Methode aktiviert ist und eine etwaige Prüfung abgeschlossen wurde.

Häufige Fragen

Was ändert sich und was bleibt gleich?

Was gleich bleibt:

• PayPal bleibt dein Payment Service Provider

• Deine bestehende Zahlungsinfrastruktur bleibt erhalten

• Compliance-Verantwortlichkeiten bleiben klar geregelt

• Dein bestehendes PayPal-Business-Konto wird weiterhin genutzt

Was sich verbessert:

Zahlungen werden in einer zentralen Payment-Ebene innerhalb von Shopware gebündelt. Dadurch lassen sich operative Prozesse vereinfachen und Abläufe effizienter steuern.

Durch ein neues kommerzielles Modell und wettbewerbsfähigere Preise kannst du deine Wirtschaftlichkeit verbessern, ohne dein bestehendes Setup oder deine etablierten Prozesse grundlegend verändern zu müssen.

Ergebnis:

Das Ergebnis ist ein übersichtlicheres und besser kontrollierbares Payment-System – ohne bestehende und funktionierende Prozesse zu unterbrechen.

Wer ist mein Ansprechpartner bei Supportfragen zu Shopware Payments?

Für Händler ist Shopware stets die erste Anlaufstelle für Supportanfragen. Falls erforderlich, koordiniert Shopware die Abstimmung direkt mit PayPal über etablierte Eskalationswege.

Alle Pläne – von der Community Edition bis hin zu Shopware Beyond – erhalten vollständigen Support für Shopware Payments direkt durch Shopware. Dazu gehören Unterstützung beim Onboarding, bei der Konfiguration, bei operativen Fragen sowie bei der Fehlerbehebung.

Für zahlungsspezifische Themen wie Compliance, Fondsmanagement oder Transaktionsabwicklung bestehen klar definierte Eskalationsprozesse zu PayPal.

Das grundlegende Supportmodell bleibt über alle Shopware-Pläne hinweg konsistent. Shopware Payments verwendet keine separate Supportstruktur. Reaktionszeiten und Service Levels richten sich nach dem jeweiligen Supportmodell deines Shopware-Plans. Weitere Informationen findest du auf der Preisübersicht.

Für Händler der Community Edition gilt ein SLA mit einer Reaktionszeit von fünf Werktagen innerhalb der regulären Supportzeiten (Montag bis Freitag, 09:00–17:00 Uhr CET, ausgenommen gesetzliche Feiertage in Nordrhein-Westfalen).