Post-Purchase Upselling & Cross-Selling

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.

Post-Purchase Upselling & Cross-Selling 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.

Was wem gehört

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. Die Erweiterung nutzt den von SwagPayPal bereitgestellten Zahlungs-Token, um den Zusatzbetrag nachzubelasten. Für die PayPal-Wallet bietet sie eine einmalige kurze Bestätigung an, wenn kein Token vorhanden ist und Sie diese Einstellung aktiviert haben. (Für eine Kartenbestellung ohne gespeicherte Karte wird kein Angebot angezeigt.)

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. Voraussetzungen sind aktiviertes PayPal-Vaulting, ein registrierter Kunde mit gespeicherter PayPal-Zahlung und im Live-Betrieb aktivierte Reference Transactions auf Ihrem PayPal-Konto.

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. Dafür muss die Erweiterungseinstellung PayPal-Wallet: Upsell über eine kurze Bestätigung einziehen, wenn kein Vault-Token vorhanden aktiviert sein. Die kurze Bestätigung wird für PayPal-Wallet-Kunden ohne gespeicherten (vaulteten) Token genutzt. Für Bestellungen mit der Kartenmethode (ACDC) wird ohne gespeicherte Karte kein Angebot angezeigt.

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.

  1. Öffnen Sie PayPal unter Einstellungen (oder Einstellungen → Erweiterungen → Meine Erweiterungen → PayPal → Konfigurieren).
  2. Suchen Sie die Option Vaulting („Kunden erlauben, ihr PayPal-Konto zu speichern …“) und schalten Sie sie an. Speichern.
  3. 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). Für eine Kartenbestellung ohne gespeicherte Karte wird kein Angebot angezeigt.
    • 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.

  1. Stellen Sie unter developer.paypal.com→ Testing Tools → Sandbox Accounts sicher, dass Sie ein Business (Händler)- und ein Personal (Käufer)-Testkonto haben.
  2. 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).
  3. Aktivieren Sie Vaulting (Schritt 1) im Sandbox-Modus.
  4. Durchlaufen Sie den vollen Ablauf in Ihrer Storefront: registrieren und anmelden (nicht als Gast), ein Produkt kaufen, PayPal wählen, als Sandbox-Käufer freigeben und der Speicherung der Zahlung zustimmen. Nehmen Sie das Angebot auf der Angebotsseite an und prüfen Sie, ob der Artikel hinzugefügt wurde und die Bestellung eine separate PayPal-Transaktion für den Zusatzbetrag zeigt.

Schritt 3: Live gehen

  1. Schalten Sie in SwagPayPal den Sandbox-Modus aus und verbinden Sie Ihr Live-PayPal-Business-Konto. Sandbox- und Live-Einstellungen werden getrennt gespeichert.
  2. Prüfen Sie erneut, ob Vaulting in der Live-Konfiguration aktiviert ist. Die Aktivierung in der Sandbox gilt nicht für Live.
  3. 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 Kunden mit gespeicherter PayPal-Zahlung abgelehnt und der Zusatzartikel nicht hinzugefügt (in diesem Fall gibt es keine kurze Bestätigung als Fallback).
  4. 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, ob der Zusatzbetrag erfasst wurde, und erstatten Sie ihn dann über den PayPal-Reiter der Bestellung.
Echtgeld-Test, bevor Sie sich auf stille Nachbelastungen verlassen

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, ob 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 über eine kurze Bestätigung einziehen, wenn kein Vault-Token vorhanden ist aus – schalten Sie sie an. (Für eine Kartenbestellung ohne gespeicherte Karte wird kein Angebot angezeigt; diese Einstellung gilt nicht für die Kartenmethode.)
  • 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).