PayPal-Einrichtung
Dieser Abschnitt ist nur wichtig, wenn Sie Upsells bei PayPal-Bestellungen wollen. Die übrigen Zahlungsarten (Rechnung, Vorkasse, Nachnahme, Lastschrift) benötigen nichts davon.
Post-Purchase Upsell verbindet sich nicht selbst mit PayPal. Es setzt auf der offiziellen Erweiterung SwagPayPal auf und nutzt das PayPal-Konto, die Zugangsdaten und die gespeicherten Zahlungs-Tokens, die SwagPayPal verwaltet. „PayPal konfigurieren“ bedeutet hier also, SwagPayPal und Ihr PayPal-Konto zu konfigurieren; dieses Plugin nutzt dann, was bereits da ist. Getestet mit SwagPayPal 10.x auf Shopware 6.7.
Die Schritte zu Vaulting, Sandbox/Live und Reference Transactions unten sind PayPal-Konto- und SwagPayPal-Einstellungen, nicht Teil dieses Plugins. Folgen Sie der eigenen Dokumentation von SwagPayPal und PayPal für die genauen Bildschirme; die Schritte hier dienen der Orientierung. Der Teil dieses Plugins ist nur: den von SwagPayPal bereitgestellten Zahlungs-Token nutzen, um das Add-on abzubuchen, und, wenn kein Token vorhanden ist, eine einmalige zweite Freigabe anbieten, falls Sie diese Einstellung aktiviert haben.
Die zwei Wege, einen PayPal-Zusatzbetrag einzuziehen
Stille Vault-Abbuchung (am besten): Das Add-on wird im Hintergrund abgebucht; der Kunde sieht nur den hinzugefügten Artikel, ohne zweiten PayPal-Schritt. Nötig sind PayPal-Vaulting aktiviert, ein registrierter Kunde mit gespeicherter PayPal-Zahlung und (nur Live) Reference Transactions auf Ihrem PayPal-Konto aktiviert.
Zweite Freigabe (Ausweichweg): Der Kunde wird noch einmal zu PayPal geschickt, um nur den Zusatzbetrag freizugeben, kehrt zurück und der Artikel wird hinzugefügt. Nötig ist die Plugin-Einstellung PayPal: Upsell per zweiter Freigabe einziehen aktiviert. Wird für einen PayPal-Kunden genutzt, der keinen gespeicherten (vaulteten) Token hat.
Lassen Sie die Zweitfreigabe-Einstellung an (ist an ausgeliefert) als Sicherheitsnetz: Ein Kunde ohne gespeicherten Token kann dann die einmalige Freigabe erhalten, während die stille Abbuchung automatisch genutzt wird, sobald ein gespeicherter Token verfügbar ist.
Schritt 1: Vaulting in SwagPayPal aktivieren
Vaulting ermöglicht es einem registrierten Kunden, sein PayPal-Konto zu speichern, sodass das Add-on erneut abgebucht werden kann, ohne ihn zurück zu PayPal zu schicken.
- Öffnen Sie PayPal unter Einstellungen (oder Einstellungen → Erweiterungen → Meine Erweiterungen → PayPal → Konfigurieren).
- Suchen Sie die Option Vaulting („Kunden erlauben, ihr PayPal-Konto zu speichern …“) und schalten Sie sie an. Speichern.
- Gut zu wissen:
- Vaulting speichert einen Token für einen Kunden, der zustimmt, sein PayPal zu speichern. Ein Kunde ohne gespeicherten Token nimmt stattdessen den Zweitfreigabe-Weg (dies steuert SwagPayPal; typischerweise hat ein Gast oder Erstkäufer keinen gespeicherten Token).
- Die Zahlung eines Kunden wird beim Bezahlen gespeichert; die stille Abbuchung steht dann für das Add-on bei dieser Bestellung und seinen künftigen Bestellungen zur Verfügung.
Schritt 2: Zuerst in der Sandbox testen
Die Sandbox ist die sichere Testumgebung von PayPal, es fließt kein echtes Geld. Reference Transactions sind in der Sandbox automatisch verfügbar, sodass die stille Abbuchung dort ohne zusätzliche Anfrage funktioniert.
- Stellen Sie unter developer.paypal.com→ Testing Tools → Sandbox Accounts sicher, dass Sie ein Business (Händler)- und ein Personal (Käufer)-Testkonto haben.
- Schalten Sie in SwagPayPal den Sandbox-Modus an und tragen Sie Ihre Sandbox-REST-API-Zugangsdaten ein (oder nutzen Sie das „Mit PayPal verbinden“-Onboarding im Sandbox-Modus).
- Aktivieren Sie Vaulting (Schritt 1) im Sandbox-Modus.
- Durchlaufen Sie den vollen Ablauf in Ihrer Storefront: registrieren und anmelden (kein Gast), ein Produkt kaufen, PayPal wählen, als Sandbox-Käufer freigeben und der Speicherung der Zahlung zustimmen. Klicken Sie auf der Angebotsseite auf hinzufügen und prüfen Sie, dass der Artikel hinzugefügt wurde und die Bestellung eine separate PayPal-Transaktion für das Add-on zeigt.
Schritt 3: Live gehen
- Schalten Sie in SwagPayPal den Sandbox-Modus aus und verbinden Sie Ihr Live-PayPal-Business-Konto. Sandbox- und Live-Einstellungen werden getrennt gespeichert.
- Prüfen Sie erneut, dass Vaulting in der Live-Konfiguration aktiviert ist: es in der Sandbox einzuschalten aktiviert es nicht für Live.
- Aktivieren Sie Reference Transactions auf Ihrem Live-PayPal-Konto. Das ist der leicht zu übersehende Schritt. Die stille Abbuchung ist eine händlerinitiierte Abbuchung, die ein Live-PayPal-Business-Konto nur vornehmen darf, wenn Reference Transactions (auch händlerinitiierte Transaktionen oder Abbuchungsvereinbarungen genannt) aktiviert sind: das ist eine PayPal-Konto-Anforderung, die bei PayPal beantragt wird. Bis sie aktiv ist, wird die stille Abbuchung für einen vaulteten Kunden abgelehnt und das Add-on nicht hinzugefügt (für einen bereits vaulteten Kunden gibt es keine zweite Freigabe als Ausweichweg). Erst Reference Transactions lässt die stille Abbuchung live funktionieren.
- Führen Sie einen kleinen Echtgeld-Test durch: Geben Sie als registrierter Kunde eine günstige Live-PayPal-Bestellung auf, nehmen Sie das Upsell an, prüfen Sie, dass das Add-on erfasst wurde, und erstatten Sie es dann über den PayPal-Reiter der Bestellung.
Verlassen Sie sich nicht allein auf den Sandbox-Erfolg. Reference Transactions sind in der Sandbox automatisch verfügbar, müssen für Live aber erst aktiviert werden, sodass eine stille Abbuchung, die in der Sandbox lief, live abgelehnt werden kann. Führen Sie vor dem Verlassen auf stille PayPal-Upsells eine kleine echte Live-Bestellung durch, prüfen Sie, dass das Add-on tatsächlich erfasst wurde, und erstatten Sie die Add-on-Abbuchung anschließend.
Schnelle Checkliste
- SwagPayPal installiert und verbunden: Sandbox (Sandbox-Zugangsdaten), Live (Live-Zugangsdaten).
- Sandbox-Modus in SwagPayPal: Sandbox an, Live aus.
- Vaulting aktiviert: Sandbox ja, Live ja (getrennt einzustellen).
- Reference Transactions auf dem Konto: Sandbox automatisch, Live bei PayPal beantragen.
- Plugin-Zweitfreigabe-Einstellung: Sandbox und Live an (Sicherheitsnetz).
- Mit echtem Ablauf geprüft: Sandbox per Testkäufer-Bestellung, dann annehmen; Live per kleiner Echtgeld-Bestellung, dann erstatten.
Wenn das PayPal-Upsell sich nicht wie erwartet verhält
- Fragt immer nach einer zweiten Freigabe (nie still): Der Kunde hat noch keine gespeicherte (vaultete) Zahlung (z. B. ein PayPal-Erstkäufer) oder Vaulting ist in SwagPayPal aus.
- Add-on wird für PayPal-Kunden ohne gespeicherte Zahlung nicht hinzugefügt: Die Zweitfreigabe-Einstellung ist aus, schalten Sie sie an.
- Stille Abbuchung lief in der Sandbox, wird aber live abgelehnt (und das Add-on nicht hinzugefügt): Fast immer sind Reference Transactions auf Ihrem Live-PayPal-Konto noch nicht aktiviert (Schritt 3, Punkt 3).