PayPal-Einrichtung
Dieser Abschnitt ist nur wichtig, wenn Sie Angebote bei PayPal-Bestellungen wollen. Die übrigen Zahlungsarten (Rechnung, Vorkasse, Nachnahme, Lastschrift) benötigen nichts davon.
Cross-Selling & Upselling nach dem Kauf 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; diese Erweiterung nutzt dann, was bereits da ist. Getestet mit SwagPayPal 8.x auf Shopware 6.5, 9.x auf Shopware 6.6 und 10.x auf Shopware 6.7.
Die Schritte zu Vaulting, Sandbox/Live und Reference Transactions unten sind PayPal-Konto- und SwagPayPal-Einstellungen – nicht Teil dieser Erweiterung. Folgen Sie der eigenen Dokumentation von SwagPayPal und PayPal für die genauen Bildschirme; die Schritte hier dienen der Orientierung. Der Teil dieser Erweiterung ist nur: den von SwagPayPal bereitgestellten Zahlungs-Token nutzen, um den Zusatzbetrag nachzubelasten – und, für die PayPal-Wallet, eine einmalige kurze Bestätigung anbieten, wenn kein Token vorhanden ist und Sie diese Einstellung aktiviert haben. (Die Kartenmethode gilt nur für gespeicherte Karten; eine Kartenbestellung ohne gespeicherte Karte wird nicht angeboten.)
Die zwei Wege, einen PayPal-Zusatzbetrag einzuziehen
Stille Nachbelastung (am besten): Der Zusatzbetrag wird im Hintergrund nachbelastet; 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.
Kurze Bestätigung (nur PayPal-Wallet): 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 Erweiterungseinstellung PayPal-Wallet: Upsell per zweiter Freigabe einziehen, wenn kein Vault-Token vorhanden aktiviert. Wird für einen PayPal-Wallet-Kunden genutzt, der keinen gespeicherten (vaulteten) Token hat. Die Kartenmethode (ACDC) gilt nur für gespeicherte Karten und wird ohne gespeicherte Karte nicht angeboten.
Lassen Sie diese Einstellung als Sicherheitsnetz an (sie ist standardmäßig an): Ein Wallet-Kunde ohne gespeicherten Token durchläuft dann die einmalige kurze Bestätigung, während die stille Nachbelastung automatisch genutzt wird, sobald ein gespeicherter Token verfügbar ist. (Die Einstellung gilt nur für die Wallet; eine Kartenbestellung ohne gespeicherte Karte erhält kein Angebot.)
Schritt 1: Vaulting in SwagPayPal aktivieren
Vaulting ermöglicht es einem registrierten Kunden, sein PayPal-Konto zu speichern, sodass der Zusatzbetrag nachbelastet 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-Konto zu speichern. Ein Wallet-Kunde ohne gespeicherten Token durchläuft stattdessen die kurze Bestätigung (dies steuert SwagPayPal; typischerweise hat ein Gast oder Erstkäufer keinen gespeicherten Token). Eine Karten-Bestellung ohne gespeicherte Karte wird gar nicht angeboten.
- Die Zahlung eines Kunden wird beim Bezahlen gespeichert; die stille Nachbelastung steht dann für Angebote 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 Nachbelastung 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 den Zusatzbetrag 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 Nachbelastung ist eine händlerinitiierte Belastung, die ein Live-PayPal-Business-Konto nur vornehmen darf, wenn Reference Transactions (auch händlerinitiierte Transaktionen oder Billing Agreements genannt) aktiviert sind – das ist eine PayPal-Konto-Anforderung, die bei PayPal beantragt wird. Bis sie aktiv ist, wird die stille Nachbelastung für einen vaulteten Kunden abgelehnt und der Zusatzartikel nicht hinzugefügt (für einen bereits vaulteten Kunden gibt es keinen Rückfall auf die kurze Bestätigung). Erst Reference Transactions lässt die stille Nachbelastung 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 Angebot an, prüfen Sie, dass der Zusatzbetrag 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 Nachbelastung, die in der Sandbox lief, live abgelehnt werden kann. Führen Sie deshalb eine kleine echte Live-Bestellung durch, prüfen Sie, dass der Zusatzbetrag tatsächlich erfasst wurde, und erstatten Sie die Nachbelastung 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.
- Wallet-Bestätigung (Einstellung in den Globalen Einstellungen): 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-Angebot sich nicht wie erwartet verhält
- Fragt immer nach der kurzen Bestätigung (nie still): Der Kunde hat noch keine gespeicherte (vaultete) Zahlung (z. B. ein PayPal-Erstkäufer) oder Vaulting ist in SwagPayPal aus.
- Der Zusatzartikel wird für einen PayPal-Wallet-Kunden ohne gespeicherte Zahlung nicht hinzugefügt: Die Einstellung PayPal-Wallet: Upsell per zweiter Freigabe einziehen, wenn kein Vault-Token vorhanden ist aus – schalten Sie sie an. (Eine Kartenbestellung ohne gespeicherte Karte wird bewusst nicht angeboten; auf die Kartenmethode wirkt dies nicht.)
- Stille Nachbelastung lief in der Sandbox, wird aber live abgelehnt (und der Zusatzartikel nicht hinzugefügt): Fast immer sind Reference Transactions auf Ihrem Live-PayPal-Konto noch nicht aktiviert (Schritt 3, Punkt 3).
