Zahlungsarten & Fehlerfälle
Wie der Zusatzbetrag eingezogen wird, hängt davon ab, wie die ursprüngliche Bestellung bezahlt wurde. Die Erweiterung ermittelt dies immer aus der eigenen Zahlung der Bestellung, nicht aus etwas, das der Kunde nachträglich ändert. Dieses Kapitel zeigt die vollständige Matrix nach Zahlungszustand – und was in Fehlerfällen greift.
Unterstützung nach Zahlungszustand
Die Zahlungsart entscheidet, ob das Angebot direkt angenommen, kurz bei PayPal bestätigt oder gar nicht angezeigt wird. Es qualifizieren nur die vier offenen Standard-Zahlungsarten und die unterstützten SwagPayPal-Pfade – eine offene Rechnung eines Drittanbieters erhält kein Angebot.
| Zahlungszustand | Status | Kundenaktion | Ergebnis in Shopware | Bedingung |
|---|---|---|---|---|
| Rechnung, Vorkasse, Nachnahme oder Lastschrift – offen/unbezahlt | Direkt unterstützt | Angebot annehmen | Zusatzartikel zur noch offenen Bestellung hinzufügen; keine Nachbelastung | Nur solange der Bestell- und Zahlungszustand geeignet bleibt |
| PayPal-Wallet oder Express mit gespeicherter Autorisierung | Direkt unterstützt | Angebot annehmen | Stille Nachbelastung, danach Änderung derselben Bestellung | Offizielle SwagPayPal-Erweiterung, Vault-Token und Live-Fähigkeit erforderlich |
| PayPal-Wallet oder Express ohne gespeicherte Autorisierung | Mit kurzer Bestätigung | Annehmen und kurz bei PayPal bestätigen | Nachbelastung und Bestelländerung nach erfolgreicher Bestätigung | Bestätigungspfad muss aktiviert und vom PayPal-Konto unterstützt sein |
| PayPal-Kartenfelder mit gespeicherter Autorisierung | Direkt unterstützt | Angebot annehmen | Stille Nachbelastung, danach Änderung derselben Bestellung | Wiederverwendbarer ACDC-Vault-Token erforderlich |
| PayPal-Kartenfelder ohne gespeicherte Autorisierung | Nicht unterstützt | Kein gültiger Annahmepfad | Kein Angebot | Für Karten gibt es keinen Wallet-Bestätigungspfad |
| „Später Bezahlen“ innerhalb des PayPal-Wallet-Ablaufs | Mit kurzer Bestätigung | Kurz bei PayPal bestätigen | Nachbelastung und Bestelländerung nach erfolgreicher Bestätigung | Die Bestellung muss den PayPal-Wallet-Zahlungsweg verwenden |
| Eigenständige Zahlungsart „Später Bezahlen“ | Nicht unterstützt | Keine Aktion | Kein Angebot | Die eigenständige „Später Bezahlen“-Zahlungsart wird nicht unterstützt |
| Stripe, Mollie, Klarna, Adyen und andere bereits bezahlte Anbieter | Nicht unterstützt | Keine Aktion | Keine automatische Nachbelastung; normalerweise kein Angebot | Kein unterstützter Nachbelastungs-Handler |
Wählt der Käufer „Später Bezahlen“ über den Button innerhalb des PayPal-Wallet-Ablaufs, erhält er das Angebot mit kurzer Bestätigung – nie still. Die eigenständige Zahlungsart „Später Bezahlen“ erhält kein Angebot. Der Zusatzartikel selbst läuft nie auf Ratenzahlung.
Rechnung, Vorkasse, Nachnahme, Lastschrift
Solange die Bestellung noch unbezahlt ist, wird der Zusatzbetrag einfach zur Gesamtsumme der Bestellung hinzugefügt. Der Kunde zahlt die neue Gesamtsumme auf demselben Weg wie ohnehin geplant. Mehr ist nicht nötig – da wird nichts eingezogen.

Ist eine solche Bestellung bereits als bezahlt markiert, gibt es keinen offenen Betrag mehr, dem man etwas hinzufügen könnte – daher wird für sie kein Angebot gemacht.
PayPal (mit SwagPayPal)
PayPal meint hier die PayPal-Wallet-Methode und die PayPal-eigene Kartenmethode ACDC. Es gibt zwei Wege, den Zusatzbetrag einzuziehen, und die Erweiterung wählt automatisch:
- Stille Nachbelastung (am besten): Hat der Kunde eine gespeicherte (vaultete) PayPal-Zahlung oder ACDC-Karte, wird der Zusatzbetrag im Hintergrund nachbelastet, bevor der Artikel hinzugefügt wird – kein zweiter PayPal-Schritt.
- Kurze Bestätigung (nur PayPal-Wallet): Hat eine PayPal-Wallet-Bestellung keine gespeicherte Zahlung und haben Sie PayPal-Wallet: Upsell über eine kurze Bestätigung einziehen, wenn kein Vault-Token vorhanden aktiviert, wird der Kunde noch einmal zu PayPal geschickt, um nur den Zusatzbetrag freizugeben. Nach der Bestätigung wird der Artikel hinzugefügt. Bricht er ab, wird nichts hinzugefügt und nichts belastet.
Die Kartenmethode (ACDC) gilt nur für gespeicherte Karten. Eine Kartenbestellung ohne gespeicherte Karte erhält gar kein Angebot: Der einzig mögliche Rückfall wäre eine PayPal-Wallet-Bestätigung, die jemanden, der mit Karte bezahlt hat, auf ein PayPal-Konto umleiten würde. Deshalb zeigt die Erweiterung kein Angebot statt eines zur Zahlungsart unpassenden Schritts. In der Praxis erhalten Gast-Kartenzahlungen (die keine Karte speichern können) kein Angebot; Kunden mit gespeicherter Karte bekommen weiterhin die stille Nachbelastung mit einem Klick.
Die Nachbelastung wird als eigene PayPal-Transaktion erfasst, sodass die Bestellung die ursprüngliche Zahlung plus den Zusatzbetrag zeigt und Sie beide einzeln über den PayPal-Reiter der Bestellung erstatten können. Die vollständige Einrichtung steht in PayPal-Einrichtung.
Der Rückfall auf die kurze Bestätigung gilt nur für Kunden ohne gespeicherte Zahlung. Wird die stille Nachbelastung eines vaulteten Kunden abgelehnt, wird der Zusatzartikel nicht hinzugefügt – in diesem Fall gibt es keinen Rückfall auf die kurze Bestätigung.
Karten und andere Anbieter
Kredit-/Debitkarten über andere Anbieter (z. B. Stripe, Mollie, Klarna, Adyen) werden in dieser Version nicht automatisch nachbelastet. Beschränken Sie solche Kampagnen auf die unterstützten Zahlungsarten oder bieten Sie für solche Bestellungen nicht an. (Die Auswahl Erlaubte Zahlungsarten der Kampagne listet ohnehin nur Methoden, auf die das Angebot anwendbar ist.)
Erlaubte Zahlungsarten der Kampagne
Angebote erscheinen zusätzlich nur für Zahlungsarten, die die Kampagne unter Erlaubte Zahlungsarten ausdrücklich erlaubt. Eine leere Auswahl bedeutet: keine Angebote. Wie Sie Auslöser, Filter und diese Auswahl setzen, steht in Kampagnen.
Fehlerfälle: die Ausnahmesequenz
Ablehnen, Schließen, ein abgelaufener Link oder eine nicht sicher abgeschlossene Verarbeitung fügen keinen Zusatzartikel hinzu. Die bestätigte Ausgangsbestellung bleibt unverändert. Bei offenen Zahlungsarten wird der Artikel einfach der offenen Bestellung hinzugefügt – da wird nichts eingezogen. Bei PayPal-Zahlungen gilt eine feste Reihenfolge:
- Bei der Annahme werden Kampagne, Zahlungszustand, Bestand und Betragsgrenzen erneut geprüft; pro Bestellung gewinnt genau ein Angebot.
- Die Nachbelastung muss abgeschlossen sein, bevor der Zusatzartikel geschrieben wird. Wiederholungssicherheit verhindert eine doppelte Belastung.
- Scheitert die Bestelländerung nach erfolgreicher Nachbelastung, versucht die Erweiterung eine ausgleichende Erstattung.
- Schlägt auch die ausgleichende Erstattung fehl, wird der Fall als kritisch protokolliert und erfordert einen manuellen Eingriff.
Kritische Ausnahmen müssen über Aktivität, Status, Logs und Support abgeglichen werden. Der Demo-Shop kann solche Fehler nach dem Einzug nicht nachstellen – er zeigt den Ablauf, nicht die Ausnahmen.
Kritische Fälle und Support
Den Verlauf einzelner Bestellungen sehen Sie im Reiter Aktivität (siehe Analyse); die Diagnose vor dem Live-Betrieb übernimmt der Status (Health-Check). Einen kritischen Zahlungsfall besprechen Sie direkt mit dem Entwicklungsteam unter support@commercewerk.de.