PayPal

PayPal Checkout verwaltet die Verbindung zum PayPal-Händlerkonto, die PayPal-Zahlarten, alternative Zahlarten, Apple Pay, Google Pay, Webhooks, Statusfolgen, Rechnungserstellung, Rückzahlungen und Checkout-Logs.

Einordnung und Voraussetzungen

PayPal ist eine Anbieter-Unterseite der Zahlungsarten. Allgemeine Regeln wie Aktivstatus, Reihenfolge, Kosten, Wertgrenzen, Kundengruppen, Versandarten und Versandzonen bleiben auf der Hauptseite der Zahlungsarten gepflegt. Diese Seite erklärt die PayPal-spezifische Konfiguration.

• Shop-Bezug: Die PayPal-Konfiguration wird je Multishop gepflegt. Bei mehreren Shops muss die Verbindung und Freischaltung für den jeweiligen Shop geprüft werden.
• PayPal-Händlerkonto: Für Live-Zahlungen muss der Shop mit dem passenden PayPal-Händlerkonto verbunden sein.
• Freischaltungen: Einzelne PayPal-Zahlarten benötigen zusätzliche Freigaben im PayPal-Händlerkonto, zum Beispiel Rechnungskauf, Apple Pay und Google Pay.
• Checkout-Freigabe: PayPal erscheint im Checkout nur, wenn die allgemeine Zahlungsart und die gewünschte PayPal-Zahlart passend aktiv sind.

Verbindung und Betriebsmodus

• Mit PayPal verbinden: öffnet den PayPal-Onboarding-Prozess. Nach erfolgreicher Rückgabe werden Händlerkennung, Zugangsdaten und Webhook automatisch im Shop gespeichert.
• Verbindung aufheben: trennt die gespeicherte PayPal-Verbindung. Danach ist eine neue Verbindung erforderlich, bevor PayPal wieder produktiv genutzt werden kann.
• Betriebsmodus: legt fest, ob die Verbindung im Live-Modus oder im Sandbox-Modus arbeitet. Live- und Sandbox-Daten dürfen nicht gemischt werden.
• Händlerkennung, Zugangsdaten und Webhook: werden aus dem Onboarding übernommen und im Formular nur zur Kontrolle angezeigt.

Bildertyp und Darstellung

Über Bildertyp steuerst du, welche Logos der Shop bei den PayPal-Zahlarten verwendet.

• Eigene Bilder: verwendet die bei der jeweiligen Zahlart hinterlegten Bildpfade oder Bild-URLs. Das ist sinnvoll, wenn die Zahlungsarten optisch zum eigenen Theme passen sollen.
• PayPal-Icons: verwendet die von PayPal bereitgestellten Icons beziehungsweise Standarddarstellungen.
• Bezeichnung: legt fest, wie die Zahlart im Checkout benannt wird.
• Bild: legt das Bild für die Zahlart fest, sofern eigene Bilder verwendet werden oder die Zahlart ein eigenes Logo anzeigen soll.

PayPal-Zahlarten

Die PayPal-Zahlarten sind Zahlungswege, die über PayPal Checkout abgewickelt werden. Einige werden direkt über die PayPal-Verbindung angeboten, andere benötigen eine zusätzliche Freischaltung.

• PayPal: klassische Zahlung über das PayPal-Konto des Käufers. Diese Basiszahlart hängt an der allgemeinen PayPal-Zahlungsart und der verbundenen PayPal-Konfiguration.
• Lastschrift: ermöglicht SEPA-Lastschrift über PayPal, sofern PayPal diese Zahlungsquelle für den Käufer und das Land anbietet.
• Kreditkarte: ermöglicht Kartenzahlungen über PayPal Checkout.
• Später bezahlen: bündelt PayPals Ratenzahlungs- und Später-bezahlen-Angebote. Ob die Option erscheint, entscheidet PayPal anhand von Händlerkonto, Käuferdaten, Betrag und Land.
• Rechnung: aktiviert PayPal-Rechnungskauf. Diese Zahlart ist erst nutzbar, wenn PayPal die Rechnungskauf-Freigabe für das Händlerkonto aktiv meldet.
• Apple Pay: ermöglicht Zahlung über Apple Pay innerhalb von PayPal Checkout. Dafür sind Wallet-Freischaltung, Apple-Pay-Domainregistrierung und ein geeignetes Apple-Gerät beziehungsweise ein passender Browser nötig.
• Google Pay: ermöglicht Zahlung über Google Pay innerhalb von PayPal Checkout. Dafür muss PayPal die Wallet-Freischaltung für den Händler bestätigen und der Käuferkontext muss Google Pay unterstützen.

Eine im Backend aktivierte Zahlart ist keine Garantie, dass PayPal sie jedem Käufer anzeigt. PayPal berücksichtigt zusätzlich Land, Währung, Käuferdaten, Warenkorb, Gerät, Browser und die Freischaltung im Händlerkonto.

Rechnungskauf freischalten

Der Rechnungskauf wird separat durch PayPal freigeschaltet. Wenn PayPal die Freigabe für das Händlerkonto noch nicht aktiv meldet, zeigt das Backend beim Rechnungskauf die Anmeldung an und deaktiviert die Aktivierung der Zahlart.

1. PayPal-Händlerkonto über Mit PayPal verbinden verbinden.
2. Im PayPal-Formular den Bereich Rechnung prüfen.
3. Wenn die Freigabe fehlt, Zum Rechnungskauf anmelden öffnen.
4. Den PayPal-Dialog abschließen und die PayPal-Seite im Backend erneut laden.
5. Wenn PayPal die Freigabe aktiv meldet, Rechnung aktivieren? auf ja setzen und speichern.
6. Danach eine Testbestellung mit passendem Land und passenden Kundendaten durchführen.

Apple Pay und Google Pay freischalten

Apple Pay und Google Pay werden als Wallet-Zahlarten über PayPal Checkout angebunden. Im Backend erscheinen sie in der PayPal-Zahlartenliste, sind aber erst aktivierbar, wenn PayPal die jeweilige Händlerfreischaltung bestätigt.

1. PayPal-Händlerkonto über Mit PayPal verbinden verbinden.
2. Im PayPal-Formular den Bereich Wallet-Freischaltung prüfen.
3. Wenn die Freischaltung fehlt, Wallets bei PayPal freischalten öffnen.
4. Den PayPal-Dialog abschließen. Danach lädt das Backend die PayPal-Seite neu und prüft den Wallet-Status.
5. Wenn Apple Pay freigeschaltet ist, zusätzlich die Apple-Pay-Domain registrieren.
6. Danach Apple Pay aktivieren? und/oder Google Pay aktivieren? auf ja setzen, Bezeichnung und Bild prüfen und speichern.
7. Zum Schluss den Checkout mit einem passenden Gerät und Browser testen.

Apple-Pay-Domain registrieren

Apple Pay benötigt zusätzlich zur Händlerfreischaltung eine einmalige Registrierung der Shopdomain im PayPal-Händlerkonto. Sobald PayPal Apple Pay freigeschaltet meldet, zeigt das Backend den Bereich Apple-Pay-Domain mit der erkannten Shopdomain an.

• Apple-Pay-Domain registrieren: öffnet einen Dialog, in dem der Shop die erforderliche Domaindatei bereitstellt und den Link zum PayPal-Händlerkonto anbietet.
• Domain prüfen: Im PayPal-Dialog muss genau die angezeigte Shopdomain registriert werden.
• Multishop: Bei mehreren Shopdomains muss jede verwendete Domain separat registriert werden.

Google Pay prüfen

Google Pay benötigt keine separate Domainregistrierung im Shopdialog. Nach der Freischaltung durch PayPal kann die Zahlart aktiviert werden. Im Checkout prüft der Shop zusätzlich, ob Google Pay im aktuellen Browser, Gerät und Käuferkontext verfügbar ist.

Alternative Zahlarten

Alternative Zahlarten sind länderspezifische Zahlungswege, die PayPal Checkout zusätzlich anbieten kann. Das Backend zeigt bei jeder Methode die unterstützten Länder an. Ob die Zahlart im Checkout erscheint, entscheidet PayPal zusätzlich anhand des Käufer- und Warenkorbkontexts.

• giropay: Zahlungsart für Deutschland.
• Bancontact: Zahlungsart für Belgien.
• BLIK: Zahlungsart für Polen.
• eps: Zahlungsart für Österreich.
• iDEAL: Zahlungsart für die Niederlande.
• MyBank: Zahlungsart für Italien.
• Przelewy24: Zahlungsart für Polen.

Warenkorb-Checkout und Button-Stil

• Checkout im Warenkorb anzeigen? blendet PayPal bereits im Warenkorb ein und ermöglicht einen Express-Einstieg vor dem klassischen Checkout.
• Zusätzliche Config-Parameter für Buttons im Warenkorb: erlaubt ergänzende Style-Parameter für die PayPal-Buttons im Warenkorb. Nutze dieses Feld nur, wenn die Darstellung gezielt angepasst werden soll.

Status und Rechnung

Für erfolgreiche und fehlgeschlagene PayPal-Zahlungen legst du fest, welche Bestellstatus gesetzt werden und ob bei erfolgreicher Zahlung automatisch eine Rechnung erstellt oder versendet wird.

• Bestellstatus bei erfolgreicher Zahlung: Status nach erfolgreicher PayPal-Zahlung.
• Bestellstatus bei erfolgreicher Zahlung (Rechnungskauf): eigener Status für erfolgreichen Rechnungskauf.
• Bestellstatus bei fehlgeschlagener Zahlung: Status nach fehlgeschlagener PayPal-Zahlung.
• Bestellstatus bei PayPal-Rückbuchung: Status, der bei einer von PayPal gemeldeten Rückbuchung gesetzt wird. Die Auswahl keine Statusänderung lässt den bisherigen Bestellstatus unverändert.
• Bestellstatus bei fehlgeschlagener Zahlung (Rechnungskauf): eigener Status für fehlgeschlagenen Rechnungskauf.
• Rechnung bei erfolgreicher Zahlung erstellen: steuert, ob der Shop automatisch eine Rechnung erzeugt.
• Rechnung bei erfolgreicher Zahlung an Kunde senden: steuert, ob die erzeugte Rechnung direkt per E-Mail versendet wird.

Webhook-Ereignisse

Der PayPal-Webhook verarbeitet Zahlungsereignisse wie erfolgreiche, offene, abgelehnte, erstattete oder rückgebuchte Zahlungen. Bei einer PayPal-Rückbuchung speichert der Shop die Rückbuchungsdaten an der Zahlung und kann abhängig von der Statusauswahl den Bestellstatus ändern. Wenn PayPal für Abonnements aktiv ist, werden zusätzlich Abo-Ereignisse verarbeitet, zum Beispiel Erstellung, Aktivierung, Änderung, Ablauf, Kündigung, Pausierung und fehlgeschlagene Zahlung.

Checkout-Ablauf

1. Im Checkout oder im Warenkorb wird eine PayPal-Zahlart ausgewählt.
2. Das Modul erstellt eine PayPal-Zahlung für den aktuellen Warenkorb.
3. Bei normalen PayPal-Zahlungen bestätigt der Käufer die Zahlung über PayPal.
4. Bei Apple Pay und Google Pay prüft der Shop zuerst die technische Verfügbarkeit der Wallet und bestätigt die Zahlung anschließend über PayPal.
5. Bei Rechnungskauf können zusätzliche Kundendaten wie Telefonnummer und Geburtsdatum erforderlich sein.
6. Nach der PayPal-Rückmeldung verarbeitet der Shop Zahlung, Bestellstatus, Rechnungserstellung und Rechnungsversand nach den hinterlegten Einstellungen.

Bestellansicht und Rückzahlung

In der Bestellung zeigt PayPal Transaktionsdetails an, wenn Zahlungsdaten zur Bestellung gespeichert sind. Dazu gehören Status, Zahlungsart, Zeitpunkt, Transaktionskennung, Betrag, Währung, Gebühr und Nettobetrag.

• Rückzahlung senden: erscheint bei Zahlungen, für die noch ein rückzahlbarer Betrag vorhanden ist.
• Rückzahlungsbetrag: muss innerhalb des noch verfügbaren Rückzahlungsbetrags liegen.
• Erfolg: Nach erfolgreicher Rückzahlung schließt das Modal und zeigt eine Erfolgsmeldung.
• Fehler: Bei Ablehnung bleibt das Formular geöffnet und zeigt die PayPal-Fehlermeldung.

Logs und Prüfung

PayPal stellt einen Admin-Logviewer für tägliche Checkout-Logs bereit. Secrets und Tokens werden in der Anzeige zusätzlich maskiert.

• Nach einer neuen Verbindung prüfen, ob Händlerkennung, Zugangsdaten und Webhook vorhanden sind.
• Nach Aktivierung zusätzlicher Zahlarten einen Checkout mit passendem Rechnungsland testen.
• Nach Freischaltung des Rechnungskaufs eine Testbestellung mit vollständigen Kundendaten durchführen.
• Nach der Wallet-Freischaltung Apple Pay auf einem Apple-Pay-fähigen Gerät und Google Pay in einem geeigneten Browser testen.
• Nach Änderung der Statusfelder eine Testbestellung inklusive Rechnungserstellung und Rechnungsversand prüfen.
• Wenn ein Rückbuchungsstatus verwendet wird, PayPal-Rückbuchungen im Log und am Bestellstatus nachvollziehen.
• Nach Aktivierung des Abo-Checkouts prüfen, ob der Webhook mit den Abo-Ereignissen eingerichtet wurde.