PayPal in Magento 2.4.7 ohne zusätzlichen PSP
Direkte PayPal-Anbindung oder Braintree?
Ja, Magento 2.4.7 kann PayPal direkt anbinden. Ein zusätzlicher Zahlungsanbieter außerhalb von PayPal ist dafür grundsätzlich nicht erforderlich. Die klassische Möglichkeit ist PayPal Express Checkout. Daneben steht PayPal über Braintree zur Verfügung. Braintree gehört ebenfalls zum PayPal-Angebot, benötigt jedoch eine eigene Einrichtung. [1][3][4]
Für Shopbetreiber stellt sich deshalb vor allem die Frage, welche Lösung zu den benötigten Zahlungsarten und den Abläufen im Unternehmen passt. Soll lediglich PayPal ergänzt werden? Oder sollen auch Kartenzahlungen und weitere Zahlverfahren über eine gemeinsame technische Anbindung laufen?
Dieser Beitrag betrachtet Magento Open Source und Adobe Commerce der Versionsreihe 2.4.7. Der tatsächliche Funktionsumfang hängt zusätzlich von der installierten Erweiterungsversion, dem Checkout und dem Händlerkonto ab.
Was bedeutet PayPal ohne zusätzlichen PSP?
PSP steht für Payment Service Provider, also Zahlungsdienstleister. Auch PayPal übernimmt diese Funktion. Gemeint ist hier eine PayPal-Zahlung ohne einen weiteren Anbieter zwischen Magento und PayPal.
Bei der direkten Anbindung kommuniziert die PayPal-Integration des Shops mit PayPal. Bei „PayPal through Braintree“ läuft die technische Anbindung über die Braintree-Plattform.
Ein bereits mitgeliefertes Magento-Modul bedeutet dabei nicht, dass die Zahlungsabwicklung ohne Freischaltung oder Gebühren genutzt werden kann. Technische Installation, Händlerkonto und Konditionen sind getrennt zu prüfen.
Welche Unterschiede gibt es zwischen Express Checkout und Braintree?
| Frage | Klassisches PayPal Express Checkout | PayPal über Braintree |
|---|---|---|
| Wie wird PayPal angebunden? | Über die direkte PayPal-Integration | Über die Braintree-Integration |
| Welche Konten werden benötigt? | Ein geeignetes PayPal-Geschäftskonto | Ein Braintree-Konto sowie die Verknüpfung mit einem PayPal-Geschäftskonto |
| Welche Zugangsdaten verwendet Magento? | Bei API-Signatur API Username, API Password und API Signature | Merchant ID, Public Key und Private Key |
| Wofür kommt die Lösung infrage? | PayPal als einzelne zusätzliche Zahlungsart | PayPal und weitere Zahlungsarten in einer gemeinsamen Integration |
| Was muss besonders geprüft werden? | Eignung der älteren Integration und Unterstützung des Checkouts | Freischaltung, Modulversion und Verfügbarkeit der gewünschten Zahlverfahren |
Die technischen Unterschiede und Zugangsdaten sind in der Adobe- und PayPal-Dokumentation beschrieben. [1][2][3][4]
Unsere Einordnung: Für einen bestehenden Shop, der ausschließlich PayPal ergänzen möchte, sollte zunächst die vorhandene direkte Anbindung geprüft werden. Werden mehrere Zahlungsarten benötigt, gehört Braintree in den Vergleich. Bei einer Neueinrichtung sollten zusätzlich aktuelle PayPal-Erweiterungen berücksichtigt werden.
Was bietet die direkte PayPal-Anbindung?
PayPal Express Checkout ist als eigenständige Zahlungsoption nutzbar. Kunden können den Bezahlvorgang beispielsweise aus dem Warenkorb starten, sich bei PayPal anmelden und anschließend zur Bestellprüfung in den Shop zurückkehren. Ein Braintree-Konto ist für diesen direkten Weg nicht erforderlich.
Für einen Shop, der andere Zahlungsarten bereits separat abwickelt, kann das eine passende Ergänzung sein. Die Entscheidung sollte auch berücksichtigen, wie Zahlungen, Rechnungen und Erstattungen im Unternehmen bearbeitet werden.
Die klassische Integration gehört zur älteren API-Generation
Die hier betrachtete Express-Anbindung verwendet klassische PayPal-Zugangsdaten aus dem NVP/SOAP-Umfeld. PayPal bezeichnet diese Schnittstellen als Legacy und verweist für neue Integrationen auf neuere Lösungen. Die Dokumentation beschreibt zugleich eine fortbestehende Unterstützung. Daraus lässt sich kein konkretes Abschaltdatum für einen Magento-Shop ableiten.
Für eine neue Einrichtung empfehlen wir daher, den aktuellen Integrationsweg zu prüfen, bevor Zeit in die klassische Anbindung investiert wird.
PayPal nennt in seinem Upgrade-Leitfaden für Magento 2.4.6 und 2.4.7 unter anderem die PPCP-Erweiterung von GENE Commerce, wenn europäische lokale Zahlverfahren benötigt werden. PPCP steht für PayPal Complete Payments. Braintree wird dort außerdem für weitergehende Anforderungen aufgeführt.
Neben der klassischen Express-Anbindung und Braintree kommen somit weitere Integrationen infrage. Eine zusätzliche Erweiterung kann technisch erforderlich sein, ohne dass deshalb ein weiterer Zahlungsdienstleister außerhalb von PayPal eingebunden wird.
Wann lohnt sich ein Blick auf Braintree?
Braintree kommt insbesondere dann infrage, wenn neben PayPal auch Karten und weitere Wallets angebunden werden sollen. Adobe dokumentiert unter anderem Apple Pay und Google Pay. Welche Verfahren tatsächlich nutzbar sind, muss für Händlerland, Konto und installierte Modulversion geprüft werden. (Quelle: https://experienceleague.adobe.com/en/docs/commerce-admin/stores-sales/payments/braintree)
Die Versionshinweise zu Magento Open Source 2.4.7 nennen für Braintree beispielsweise Express-Zahlungsbuttons und erweiterte Möglichkeiten, Zahlungsmittel für spätere Einkäufe zu speichern. Ob diese Funktionen im eigenen Checkout funktionieren und gewünscht sind, gehört in die Projektprüfung. (Quelle: https://experienceleague.adobe.com/en/docs/commerce-operations/release/notes/magento-open-source/2-4-7)
Für PayPal-Zahlungen wird das PayPal-Geschäftskonto mit Braintree verbunden. Die Einrichtung besteht deshalb aus mehr als dem Aktivieren eines Schalters im Magento-Backend. (Quelle: https://developer.paypal.com/braintree/articles/guides/payment-methods/paypal/setup-guide/)
Ein sinnvoller Vergleich berücksichtigt auch die tägliche Arbeit. Wo werden Zahlungen gesucht? Wie bearbeitet der Kundenservice Rückzahlungen? Welche Transaktionsinformationen benötigt die Buchhaltung?
Wie wird PayPal Express Checkout in Magento eingerichtet?
Der grundsätzliche Einstieg im Backend lautet:
Stores → Configuration → Sales → Payment Methods
Dort werden Händlerland, Konfigurationsbereich und PayPal Express Checkout ausgewählt. Für die klassische API-Signatur werden die zugehörigen API-Zugangsdaten hinterlegt. Die genauen Beschriftungen können je nach Sprache und installiertem Stand abweichen. (vgl. https://experienceleague.adobe.com/en/docs/commerce-admin/stores-sales/payments/paypal/paypal-express-checkout)
Vor der Aktivierung sollte feststehen, wann der Betrag eingezogen werden soll. Bei einer Autorisierung wird die Zahlung zunächst genehmigt. Der anschließende Einzug wird als Capture bezeichnet. Welche Zahlungsaktion passt, hängt beispielsweise davon ab, ob die Rechnung sofort oder erst im weiteren Bestellablauf erzeugt wird. Die verfügbaren Optionen sind in der Konfiguration der jeweiligen Integration zu prüfen.
Für die Einrichtung empfehlen wir folgende Reihenfolge:
- Verwendete PayPal-Integration und Checkout-Kompatibilität feststellen.
- Testumgebung mit passenden Sandbox-Zugangsdaten konfigurieren.
- Zahlungsablauf und Bestellverarbeitung testen.
- Live-Zugangsdaten hinterlegen und Testmodus deaktivieren.
- Einen kontrollierten Live-Kauf einschließlich Rückzahlung prüfen.
Warum funktionieren Client ID und Secret nicht in den API-Signatur-Feldern?
Die klassische Konfiguration erwartet API Username, API Password und API Signature. Eine Client ID und ein Secret einer REST-App gehören zu einem anderen Authentifizierungsverfahren. Diese Werte lassen sich nicht einfach in die klassischen Felder übernehmen.
Entscheidend ist deshalb zuerst die Frage, welche Integration der Shop tatsächlich verwendet. Die Bezeichnung „PayPal“ allein reicht zur Auswahl der Zugangsdaten nicht aus.
Woher kommen die Sandbox-Zugangsdaten?
Im PayPal Developer Dashboard werden Sandbox-Konten verwaltet. Für einen vollständigen Zahlungstest werden ein Business-Konto als Händler und ein Personal-Konto als Käufer verwendet. (Quelle: https://developer.paypal.com/sandbox-testing/accounts)
Die klassischen Testzugangsdaten sind laut PayPal beim jeweiligen Business-Testkonto über „View/Edit account“ im Bereich „NVP/SOAP Sandbox API credentials“ zu finden. Die Navigation kann sich ändern. (Quelle: https://www.paypal.com/sg/cshelp/article/how-do-i-find-my-sandbox-or-live-nvpsoap-api-credentials-ts1500)
In Magento müssen Testzugangsdaten und Sandbox-Modus zusammenpassen. Für den produktiven Betrieb werden die passenden Live-Daten benötigt.
Wie wird PayPal über Braintree eingerichtet?
Auch die Braintree-Konfiguration wird in Magento unter den Zahlungsarten geöffnet. Zunächst werden die zur Umgebung passenden Braintree-Zugangsdaten hinterlegt. Anschließend wird PayPal im Bereich „PayPal through Braintree“ aktiviert. Die PayPal-Verknüpfung im Braintree-Konto gehört ebenfalls zur Einrichtung.
Als praktische Reihenfolge bietet sich an:
- Braintree-Konto und Freigabe der benötigten Zahlverfahren klären.
- Die PayPal-Verknüpfung nach der Braintree-Dokumentation einrichten.
- In Magento die Sandbox-Umgebung und deren Braintree-Zugangsdaten auswählen.
- PayPal aktivieren und Darstellung sowie Zahlungsaktion konfigurieren.
- Den vollständigen Bestellablauf testen und erst danach auf Produktion umstellen.
Die Sandbox für Braintree und die PayPal-Sandbox sind unterschiedliche Testumgebungen. Zugangsdaten sollten deshalb nach Anbieter und Umgebung eindeutig zugeordnet werden. Ein häufiger Ansatzfehler ist, PayPal-Zugangsdaten in Felder einzutragen, die Braintree-Schlüssel erwarten.
Welche Zahlungsarten zusätzlich aktiviert werden, sollte sich nach dem Bedarf des Shops richten. Eine lange Liste verfügbarer Optionen ist noch kein Grund, alle Verfahren gleichzeitig einzuführen.
Welche Tests sollten vor der Freischaltung durchgeführt werden?
Ein sichtbarer PayPal-Button bestätigt noch keinen funktionierenden Bestellprozess. Wir empfehlen mindestens diese Prüfungen:
| Testfall | Was kontrolliert werden sollte |
|---|---|
| Gastbestellung und Kundenkonto | Bestellung und Zahlung werden korrekt zugeordnet |
| Smartphone und Desktop | Buttons, Weiterleitung und Rückkehr funktionieren |
| Abbruch bei PayPal | Kunde kann weiter einkaufen; Bestell- und Zahlungsstatus bleiben nachvollziehbar |
| Rabatt, Versandkosten und Steuern | Magento und Zahlungsanbieter zeigen denselben Endbetrag |
| Geänderte Lieferadresse | Versandart, Kosten und Steuern werden korrekt neu berechnet |
| Autorisierung und Einzug | Geld wird zum vorgesehenen Zeitpunkt eingezogen |
| Vollständige und teilweise Erstattung | Rückzahlung und Magento-Gutschrift stimmen überein |
| Verzögerte Zahlungsrückmeldung | Bestellung bleibt bis zur Klärung im vorgesehenen Bearbeitungszustand |
Besondere Aufmerksamkeit verdienen angepasste Checkouts, Hyvä-Installationen und zusätzliche Checkout-Erweiterungen. Deren Kompatibilität sollte mit der konkret eingesetzten Zahlungsintegration geprüft werden.
Für virtuelle Produkte, Abonnements und Bestellungen an mehrere Lieferadressen ist eine gesonderte Prüfung sinnvoll. Adobe nennt für die klassische Express-Integration Einschränkungen bei digitalen Gütern und Mehrfachlieferadressen. [1]
Ist die direkte Anbindung günstiger?
Das lässt sich ohne die konkreten Konditionen nicht verlässlich beantworten. Eine direkte Anbindung allein belegt keinen Kostenvorteil.
Für den Vergleich sollten Shopbetreiber Transaktionskosten, mögliche Währungsumrechnungen, Erweiterungskosten sowie Einrichtung und laufende Betreuung berücksichtigen. Auch der Aufwand für Buchhaltung und Erstattungen gehört dazu.
Die Entscheidung sollte deshalb auf den tatsächlichen Zahlungsarten und dem vorhandenen Angebot für das Unternehmen beruhen.
Häufige Fragen zur PayPal-Anbindung
Muss eine zusätzliche Magento-Erweiterung installiert werden?
Für die klassische Express-Anbindung ist in einer regulären Magento-2.4.7-Installation eine PayPal-Integration vorhanden. Bei einem bestehenden Shop muss geprüft werden, ob das Modul aktiviert und mit dem verwendeten Checkout kompatibel ist. Für neuere PayPal-Lösungen kann eine zusätzliche Erweiterung erforderlich sein. [1][6]
Ist Braintree dasselbe wie die direkte PayPal-Anbindung?
Braintree ist ein PayPal-Dienst mit einer eigenen technischen Plattform. PayPal über Braintree verwendet deshalb eine andere Einrichtung als die klassische direkte Express-Anbindung. Das betrifft insbesondere die Kontoverknüpfung und die Zugangsdaten. [3][4]
Reicht ein erfolgreicher Sandbox-Test für die Freischaltung?
Wir empfehlen zusätzlich einen kontrollierten Live-Test. So lässt sich prüfen, ob auch das produktive Händlerkonto, die Live-Zugangsdaten und die Zuordnung zur richtigen Magento-Website passen. Zum Test gehören die Zahlung, die Bestellverarbeitung und eine Rückzahlung.
Was ist bei einem späteren Wechsel zu beachten?
Vor dem Wechsel sollte festgelegt werden, wie offene Zahlungen und Rückzahlungen zu älteren Bestellungen bearbeitet werden. Außerdem ist zu prüfen, ob gespeicherte Zahlungsmittel weiterverwendet werden können. Das lässt sich nicht pauschal für alle Kombinationen von Modulen beantworten.
Welche Lösung passt zu welchem Magento-Shop?
Bestehender Shop mit funktionierendem PayPal Express Checkout: Die technische Eignung und weitere Wartung prüfen. Aus der Verfügbarkeit von Braintree allein ergibt sich kein Anlass für einen Wechsel.
Bestehender Shop, der nur PayPal ergänzen möchte: Direkte Integration und aktuelle PayPal-Erweiterungen vergleichen. Besonders wichtig sind Kontofreigabe, Checkout-Kompatibilität und der vorgesehene Integrationsweg.
Shop mit mehreren benötigten Zahlungsarten: Braintree in die Auswahl aufnehmen und die tatsächlich verfügbaren Verfahren sowie die betrieblichen Abläufe vergleichen.
Neuaufbau oder größere Checkout-Überarbeitung: Eine aktuelle Integration anhand der Anforderungen auswählen. Die vorhandene Backend-Konfiguration sollte dabei nur ein Ausgangspunkt sein.
Sie möchten weitere Informationen zu Magento Onlineshop Betreuung?
Sprechen Sie uns gerne für ein unverbindliches und natürlich kostenlose Gespräch an. Gerne tauschen wir uns über mögliche Ideen/Gedanken aus.
Weitere Informationen finden Sie auch hier:
Informationen zu Magento Betreuung und Verbesserungen
Informationen zu Programmierung individueller Magento Erweiterungen (Funktionen)
Ausführliche Informationen bzw. Quellen
- Adobe, PayPal Express Checkout
https://experienceleague.adobe.com/en/docs/commerce-admin/stores-sales/payments/paypal/paypal-express-checkout - Adobe, Konfigurationsreferenz PayPal Express Checkout
https://experienceleague.adobe.com/en/docs/commerce-admin/config/sales/payment-methods/paypal-express-checkout - Adobe, Braintree
https://experienceleague.adobe.com/en/docs/commerce-admin/stores-sales/payments/braintree - PayPal, PayPal über Braintree einrichten
https://developer.paypal.com/braintree/articles/guides/payment-methods/paypal/setup-guide/ - PayPal, Status der NVP/SOAP-Schnittstellen
https://developer.paypal.com/api/nvp-soap/troubleshooting - PayPal, Upgrade-Leitfaden für Adobe Commerce und Magento Open Source
https://developer.paypal.com/upgrade/platforms/Adobe%20Commerce/ - Adobe, Magento Open Source 2.4.7 Release Notes
https://experienceleague.adobe.com/en/docs/commerce-operations/release/notes/magento-open-source/2-4-7 - PayPal, Sandbox-Konten
https://developer.paypal.com/sandbox-testing/accounts - PayPal, REST-basierte Checkout-Integration
https://developer.paypal.com/platforms/checkout/standard/integrate - PayPal, NVP/SOAP-Zugangsdaten für Sandbox und Live
https://www.paypal.com/sg/cshelp/article/how-do-i-find-my-sandbox-or-live-nvpsoap-api-credentials-ts1500
