Easy Digital Downloads verfügt über eine integrierte PayPal-Integration. Dieses Gateway nutzt das neueste PayPal-Checkout-Erlebnis mit Smart Buttons und einem „Mit PayPal bezahlen“-Modal, das die Benutzer während des gesamten Zahlungsvorgangs auf Ihrer Website hält. Diese Dokumentation behandelt alles, was Sie über die Verwaltung Ihrer PayPal-Einrichtung wissen müssen.
Upgrade von einem anderen PayPal-Gateway? Sehen Sie sich unsere Upgrade-Hinweise an.
HINWEIS: Diese PayPal-Integration erfordert ein SSL-Zertifikat. Wenn Sie noch keines haben, lesen Sie unseren Artikel darüber, wie Sie SSL einrichten.
PayPal konfigurieren
1. Mit Ihrem PayPal-Konto verbinden
Sie benötigen ein PayPal-Konto, um Zahlungen über dieses Gateway abwickeln zu können. Wenn Sie noch kein Konto haben, erhalten Sie während des Onboarding-Prozesses die Möglichkeit, eines zu erstellen.
Melden Sie sich bei Ihrem WordPress-Admin an und gehen Sie zu Downloads » Einstellungen » Zahlungen » PayPal. Sie sehen eine Schaltfläche, um sich mit PayPal in Ihrem aktuellen Shop-Modus (Sandbox oder Live) zu verbinden.
Klicken Sie auf die Schaltfläche, um ein PayPal-Modal zu öffnen. Sie werden aufgefordert, Ihre E-Mail-Adresse und Ihr Land einzugeben. Fahren Sie mit den Schritten fort, um sich entweder mit Ihrem bestehenden Konto anzumelden oder ein neues zu erstellen.
Wichtig: Sie müssen Browser-Popups aktiviert haben, damit die PayPal-Seite in einem Modal geöffnet werden kann. Wenn Sie kein Modal sehen, überprüfen Sie Ihre Browser-Popup-Einstellungen, schließen Sie den Browser und versuchen Sie es erneut. Wenn das Popup-Fenster immer noch nicht angezeigt wird, versuchen Sie es mit dem Chrome-Browser.
Wenn Sie beim Verbinden mit PayPal einen Fehler erhalten und das Problem weiterhin besteht, kann dies an Serverregeln liegen, die das Erscheinen des Verbindungsmodals verhindern. Dies kann sich als Fehler im Zusammenhang mit der Funktion `hash_equals` äußern. Um es zu beheben, müssen Sie oder Ihr Hoster möglicherweise `Cross-Origin-Opener-Policy` anpassen. Wenn der Wert „same-origin“ ist, kann dies das Problem verursachen.
Wenn Sie sich im Testmodus verbinden, müssen Sie sich mit den Anmeldedaten Ihres Sandbox-Kontos anmelden. Wenn Sie noch kein PayPal-Sandbox-Konto haben, lesen Sie unseren Artikel darüber, wie Sie eines erstellen.
Nachdem Sie alle Schritte abgeschlossen haben, sollten Sie diese Erfolgsmeldung sehen:
Stellen Sie sicher, dass Sie auf die Schaltfläche klicken, um zu Ihrem Shop zurückzukehren. Wenn Sie diese Schaltfläche nicht klicken, können wir den Onboarding-Prozess nicht abschließen und Sie müssen von vorne beginnen.
2. Überprüfen Sie Ihren Kontostatus
Zurück in den EDD-Admin-Einstellungen prüft der Bereich „Verbindungsstatus“ Ihre Verbindung zu PayPal. Es gibt drei Möglichkeiten:
Erfolg
Ihr Konto wurde erfolgreich verbunden, Sie sind bereit, Zahlungen anzunehmen, und EDD hat in Ihrem Namen einen Webhook erstellt. Sie können mehr über den Webhook im Webhook-Abschnitt lesen.
Erfolg, mit Webhook-Warnung
Das bedeutet, dass Ihr PayPal-Konto erfolgreich verbunden wurde und Sie Zahlungen entgegennehmen können. Allerdings konnte EDD keinen Webhook in Ihrem Namen erstellen. Dies ist nichts, worüber Sie sich in einer lokalen Umgebung Sorgen machen müssen, aber wenn es auf Ihrer Live-Website passiert, wenden Sie sich an den EDD-Support, um Hilfe zu erhalten. Sie können im Abschnitt Webhook mehr darüber erfahren, wofür der Webhook bestimmt ist.
Fehler
Sie erhalten möglicherweise auch eine Fehlermeldung wie diese. Die meisten Fehler im „Zahlungsstatus“ bedeuten, dass etwas mit Ihrem PayPal-Konto nicht bereit für den Empfang von Zahlungen ist. Das bedeutet, dass Sie entweder den PayPal-Kundensupport kontaktieren oder etwas in Ihrem PayPal-Konto tun müssen, z. B. Ihre E-Mail-Adresse bestätigen.
Sobald Sie Fehler behoben haben, klicken Sie auf „Zahlungsstatus erneut prüfen“, um Ihr Konto erneut bei PayPal zu verifizieren. Alle Fehler müssen behoben werden, bevor Sie mit der Annahme von Zahlungen beginnen können.
3. PayPal-Gateway aktivieren
Sobald Sie verbunden sind, stellen Sie sicher, dass das Gateway in den allgemeinen Gateway-Einstellungen aktiviert ist:
Im Live-Modus wiederholen
Wenn Sie sich zunächst im Testmodus verbinden, müssen Sie diesen Verbindungsprozess wiederholen, sobald Sie Ihren Shop in den Live-Modus wechseln.
Webhook
Easy Digital Downloads versucht automatisch, einen Webhook in Ihrem Namen zu erstellen. Der Webhook wird hauptsächlich verwendet, um Aktionen, die im PayPal-Dashboard stattfinden, an EDD zu übermitteln. Wenn Sie beispielsweise eine Zahlung in PayPal erstatten, wird EDD dies erkennen und den Zahlungsstatus in EDD automatisch für Sie aktualisieren.
Webhooks sind nicht erforderlich, um Zahlungen zu verarbeiten, werden aber für die vollständigste Integration empfohlen.
Webhook-Status prüfen
Sie können den Status Ihres Webhooks jederzeit überprüfen, indem Sie zu Downloads » Einstellungen » Zahlungen » PayPal gehen. Der Webhook-Status wird zusammen mit den registrierten Ereignissen angezeigt.
Die Schaltfläche „Webhook synchronisieren“ prüft einfach erneut den Status des Webhooks und registriert alle fehlenden Ereignisse. Normalerweise sollten Sie nicht darauf klicken müssen, es sei denn:
- Sie haben die URL Ihrer Website geändert; oder
- Sie sehen eine Warnmeldung, dass der Webhook nicht vollständig konfiguriert ist oder eine Warnung über fehlende Ereignisse.
Fallback IPN
Easy Digital Downloads ermöglicht Ihnen nun die Verwendung eines Fallback-IPN-Dienstes, der alle Szenarien behandelt, in denen ein Webhook-Ereignis möglicherweise nicht an Ihre Website geliefert wird.
Um die IPN zu konfigurieren, müssen Sie sich in Ihrem PayPal-Konto anmelden und mit der Maus über das Zahnradsymbol in der oberen rechten Ecke des Bildschirms fahren und dann Kontoeinstellungen auswählen.
Klicken Sie auf der linken Seite des Bildschirms auf Benachrichtigungen und dann auf Aktualisieren neben Sofortige Zahlungsbenachrichtigungen.
Wenn Sie die IPN zuvor nicht aktiviert hatten, sehen Sie eine Schaltfläche IPN-Einstellungen auswählen. Fügen Sie auf der IPN-Einstellungsseite Ihre Website-URL im Format hinzu: https://ihreseite.com/?edd-listener=eppe
Ersetzen Sie ihreseite.com im Link durch Ihre tatsächliche Website-URL.
Aktivieren Sie das Kontrollkästchen IPN-Nachrichten empfangen (aktiviert) und klicken Sie dann auf Speichern.
Das ist alles! Dies wird nun als Fallback für den Haupt-Webhook fungieren, den die PayPal-Einrichtung beim Verbinden Ihres Kontos verwendet.
PayPal Commerce Pro
PayPal Commerce Pro ist eine kostenpflichtige Erweiterung, mit der Kunden direkt auf Ihrer Website per Kredit- oder Debitkarte und alternativen Zahlungsmethoden (je nach Land) wie Venmo, Apple Pay und Google Pay bezahlen können, anstatt dass Kunden zu PayPals Website weitergeleitet werden.
Nach der Installation & Aktivierung erscheint eine neue Einstellung, „Erweiterte Kredit- und Debitkartenzahlungen aktivieren“, in den PayPal-Einstellungen unter Downloads » Einstellungen » Zahlungen » PayPal.
Nach der Aktivierung erscheinen die Schaltflächen „Debit- oder Kreditkarte“ und „Später bezahlen“ (falls von Ihrem PayPal-Konto unterstützt) zusammen mit der PayPal-Schaltfläche auf Ihrer Checkout-Seite.
Checkout-Erlebnis
Dieses Zahlungsgateway verwendet die modernen Checkout-Schaltflächen von PayPal. Anstelle einer normalen „Kaufen“-Schaltfläche sehen Ihre Kunden am Ende des Checkout-Formulars Folgendes:
Nach dem Klicken auf die Schaltfläche öffnet sich ein Modal auf PayPal.com, das den Benutzer auffordert, sich bei seinem PayPal-Konto anzumelden. Der Kunde kann den gesamten Checkout-Vorgang abschließen, ohne Ihre Website zu verlassen.
Integration von wiederkehrenden Zahlungen
Dieses PayPal-Gateway unterstützt die Recurring Payments-Erweiterung vollständig. Anweisungen zur Konfiguration finden Sie in der PayPal-Einrichtungsdokumentation für wiederkehrende Zahlungen.
Browserunterstützung
Die Unterstützung für die folgenden Desktop-Browser ist garantiert. Für Browser, die nicht auf dieser Liste stehen, können die Schaltflächen weiterhin funktionieren, die Kompatibilität ist jedoch nicht garantiert.
- Chrome Version 41 und höher
- Firefox Version 43 und höher
- Safari Version 8 und höher
- Opera Version 12 und höher
- Edge Version 14 und höher
- * Internet Explorer Version 11 und höher
* Hinweis: Obwohl die Schaltflächen unter IE11 funktionieren sollten, müssen wir mehrere Polyfills laden, um die Kompatibilität zu gewährleisten. Für das beste Checkout-Erlebnis empfehlen wir die Verwendung eines moderneren Browsers. Wenn Sie die IE11-Polyfills nicht laden möchten, können Sie sie deaktivieren, indem Sie diesen benutzerdefinierten Code zu Ihrer Website hinzufügen:
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Wenn Sie diesen Code-Snippet hinzufügen, funktioniert das PayPal-Gateway unter IE11 nicht.
Weitere Informationen zu den Browseranforderungen von PayPal Checkout finden Sie auf der Seite zur Browserunterstützung von PayPal.
Erstellen eines PayPal Sandbox-Kontos
Die PayPal Sandbox ermöglicht es Ihnen, Testkonten einzurichten, mit denen der vollständige Kaufvorgang in Easy Digital Downloads mit dem PayPal-Gateway getestet werden kann. Es erfolgen keine echten Abbuchungen, und Sie können sie beliebig lange nutzen, da es sich um Testkonten handelt, die den echten PayPal-Flow nachahmen.
Um ein Sandbox-Konto zu erstellen, besuchen Sie https://developer.paypal.com und klicken Sie auf Anmelden oder Registrieren , falls Sie noch kein PayPal-Konto haben. Sie können sich mit Ihrem bestehenden PayPal-Konto anmelden, wenn Sie eines haben.
Folgen Sie nach der Anmeldung den unten stehenden Schritten, um ein Sandbox-Konto zu erstellen
- Gehen Sie zu Testwerkzeuge > Sandbox-Konten.
- Klicken Sie auf „Konto erstellen“.
- Wählen Sie „Business“, wählen Sie das Land des Kontos und klicken Sie auf „Konto erstellen“.
- Klicken Sie erneut auf „Konto erstellen“ und wählen Sie dieses Mal „Personal“ als Kontotyp.
Die obigen Schritte erstellen ein Händlerkonto, das Sie zur Verbindung innerhalb von EDD verwenden, und ein persönliches Konto, das Sie während des Checkout-Vorgangs zur Simulation einer Zahlung verwenden.
Auf der Seite „Sandbox-Konten“ können Sie auf das Konto klicken, das Sie anzeigen/bearbeiten möchten, und das Standardpasswort anzeigen, das während der Erstellung festgelegt wurde, oder Ihr benutzerdefiniertes Passwort festlegen.
Woher weiß ich, dass ich mich im Testmodus befinde?
Um sicherzustellen, dass Ihre Website im Testmodus betrieben wird, gehen Sie zu Downloads » Einstellungen » Zahlungen und aktivieren Sie das Kontrollkästchen Testmodus oben auf der Seite.
Erinnerung
Bevor Sie Ihre Website live schalten, nehmen Sie sie aus dem Testmodus, sonst sind keine Ihrer Verkäufe gültig. Möglicherweise müssen Sie sich mit Ihrem Live-PayPal-Konto verbinden, sobald Sie den Testmodus deaktivieren.
Upgrade von anderen PayPal-Gateways
Das Upgrade auf das neue PayPal-Gateway ist einfach: Verbinden Sie sich, folgen Sie den obigen Konfigurationsschritten und deaktivieren Sie dann das/die alte(n) Gateway(s).
Wenn Sie zuvor eine unserer alten PayPal-Integrationen wie PayPal Standard, PayPal Express, PayPal Pro oder PayPal Payments Advanced verwendet haben, werden Sie nach der Aktualisierung auf Easy Digital Downloads Version 2.11 aufgefordert, zu diesem neuen Gateway zu wechseln.
Wie funktioniert das Upgrade?
Bis Sie sich mit dem neuen Gateway verbinden, werden Zahlungen weiterhin über Ihre Website mit dem von Ihnen ausgewählten bestehenden Gateway verarbeitet. Wenn Sie sich mit der neuen PayPal-Integration verbinden, sollten Sie sich mit demselben PayPal-Konto verbinden, das Sie zuvor verwendet haben. Sobald der Verbindungsprozess abgeschlossen ist und Sie das neue Gateway aktiviert haben, werden Zahlungen über die neue PayPal-Integration verarbeitet. Stellen Sie sicher, dass Sie das alte Gateway deaktivieren, damit nur das neue aktiv ist.
Innerhalb von PayPal selbst werden Sie keinen Unterschied bemerken. Zahlungen kommen weiterhin auf die gleiche Weise wie zuvor herein. Nur das Checkout-Erlebnis auf Ihrer Website wurde aktualisiert.
Was ist mit wiederkehrenden Zahlungen?
Wenn Sie unsere Erweiterung für wiederkehrende Zahlungen verwenden, können Sie sicher zu dem neuen PayPal-Gateway wechseln, ohne bestehende Abonnements zu beeinträchtigen. Alte Abonnements werden weiterhin normal verarbeitet und erneuert. Jedoch:
- Sobald das neue Gateway eingerichtet ist, können Sie das alte Gateway aus der Liste der aktivierten Zahlungs-Gateways abwählen.
- Für PayPal Express und Pro müssen Sie Ihre alte PayPal IPN-Konfiguration beibehalten (Express / Pro IPN Doku), da Abonnements, die mit dem alten Gateway erstellt wurden, weiterhin IPN verwenden, um EDD über Verlängerungszahlungen zu informieren. PayPal Standard ist nicht auf IPN angewiesen, da die URL fest in der IPN eingestellt ist. Wenn Sie Ihr PayPal-Konto nicht mit mehreren Shops verwenden, empfehlen wir, es so einzustellen, falls PayPal die Funktionalität in Zukunft ändert (Standard IPN Doku), aber es ist nicht erforderlich.
- Wenn Sie PayPal Express oder PayPal Pro verwenden, müssen Sie dieses Plugin aktiviert lassen. Das Gateway selbst sollte nicht aktiviert sein (Downloads » Einstellungen » Zahlungen), aber das Plugin sollte es sein. Dies stellt sicher, dass das Gateway weiterhin alte IPNs verarbeiten kann, wie in Schritt 2 beschrieben.
Hinweis: Verwenden Sie Aelia Currency Switcher?
PayPal muss in den Aelia Payment Gateways-Einstellungen für die auf Ihrer Website unterstützten Währungen erneut hinzugefügt werden. Andernfalls ist PayPal keine verfügbare Zahlungsoption mehr an der Kasse.
Muss ich auf die neue Integration upgraden?
Alle alten PayPal-Integrationen werden veraltet sein. Sie werden zukünftig keine Updates mehr erhalten. Darüber hinaus sind viele der alten Integrationen auch auf Seiten von PayPal veraltet und stellen ältere Checkout-Erlebnisse dar.
Alte Integrationen sollten in EDD 2.x weiterhin funktionieren, aber wir empfehlen, vor 3.0 auf das neue Gateway umzusteigen, da alte PayPal-Erweiterungen nicht auf 3.0-Kompatibilität aktualisiert werden.
FAQs
Ich sehe SANDHILLS DEVELOPMENT, LLC während des Verbindungsvorgangs, ist das zu erwarten?
Ja, Easy Digital Downloads ist ein Produkt von SANDHILLS DEVELOPMENT, LLC. Sie stimmen zu, Ihr PayPal-Konto mit Ihrem Easy Digital Downloads (ein Produkt von SANDHILLS DEVELOPMENT, LLC) Store zu verbinden. Leider verlangt PayPal die Verwendung des Firmennamens anstelle unseres Produktnamens.
Kann ich mich mit einem persönlichen Konto mit PayPal verbinden?
Ein Geschäftskonto ist erforderlich, um EDD mit PayPal zu verbinden. Sie können EDD nicht mit einem persönlichen PayPal-Konto verbinden. Wenn Sie kein Geschäftskonto haben, können Sie ein separates Geschäftskonto erstellen und mehrere PayPal-Konten haben, wenn Sie Ihr persönliches Konto nicht in ein Geschäftskonto umwandeln möchten.
Warum erscheint auf meiner Checkout-Seite die Meldung „Unerwarteter Authentifizierungsfehler“?
Dies liegt wahrscheinlich daran, dass PayPal nicht richtig mit Ihrem Shop verbunden ist. Überprüfen Sie den Status unter Downloads » Einstellungen » Zahlungen » PayPal. Sie sollten auch bestätigen, dass Ihr Live-PayPal-Konto nicht im Testmodus mit EDD verbunden ist und Ihr PayPal-Sandbox-Konto nicht mit Ihrer Live-PayPal-Verbindung verbunden ist (Verbindung mit PayPal bei deaktiviertem Testmodus).
Warum schlägt die Verbindung von PayPal mit EDD fehl?
Dies kann mehrere Ursachen haben.
– Versuchen Sie, sich über einen anderen Browser oder ein anderes Gerät zu verbinden.
– Bestätigen Sie, dass das Land, an das Ihr PayPal-Konto gebunden ist, ein unterstütztes Land ist, das in der Dropdown-Liste während des Verbindungsvorgangs aufgeführt ist.
– Bestätigen Sie, dass Ihr PayPal-Konto vollständig aktiv ist. Möglicherweise gibt es noch ausstehende Aktionen, die Sie abschließen müssen. Suchen Sie nach Hinweisen in Ihrem PayPal-Konto und/oder wenden Sie sich an den PayPal-Support, um zu bestätigen, dass Ihr Konto aktiv ist.
Können die Schaltflächen „In 3 oder 4 Raten zahlen“ hinzugefügt oder entfernt werden?
PayPal Commerce Pro ist erforderlich, damit die Schaltfläche „In 3 oder 4 Raten zahlen“ auf Ihrer Website angezeigt wird. Wenn die Schaltfläche angezeigt wird und Sie sie deaktivieren möchten, können Sie dies in Ihren EDD-PayPal-Einstellungen deaktivieren.
Sie können auch eine festgelegte Anzahl von Zahlungen mit unserer Erweiterung für wiederkehrende Zahlungen unterstützen.
Warum wird die PayPal-Gast-Checkout-Option nicht angezeigt?
Wenn Sie über eine Checkout-Seite auf PayPal.com bezahlen, besteht manchmal die Möglichkeit, mit Kreditkarte zu bezahlen, ohne sich bei PayPal anzumelden. Dies wird als „Gast“-Checkout-Modus oder „PayPal-Konto optional“ bezeichnet. In den PayPal-Anweisungen hier erfahren Sie, wie Sie dies aktivieren oder deaktivieren. So aktivieren Sie die Einstellung „PayPal-Konto optional“:
- Bewegen Sie den Mauszeiger über Ihren Namen in der oberen rechten Ecke.
- Klicken Sie im Dropdown-Menü auf Kontoeinstellungen.
- Klicken Sie auf der linken Seite der Seite unter „Produkte & Dienstleistungen“ auf Zahlungen an Websites.
- Klicken Sie neben „Website-Präferenzen“ auf Aktualisieren.
- Wählen Sie unter „PayPal-Konto optional“ die Option Ein.
Benötige ich SSL, wenn ich PayPal verwende?
Ja, Sie benötigen SSL auf Ihrer Website, auch wenn die Zahlungen extern über PayPal abgewickelt werden.
Kunden werden nach der Bezahlung nicht auf meine Website zurückgeleitet.
Wenn Leute mit PayPal bezahlen, erwarten sie, nach der Bezahlung auf Ihre Website zurückgeleitet zu werden. Wenn dies nicht richtig funktioniert, muss die Auto-Return-Option wahrscheinlich in Ihrem PayPal-Profil aktiviert werden.
Log into your PayPal account and go to your profile settings.
In your settings, click on Website Preferences.
There you will have an option to enable automatic return.
Im obigen Beispiel ist es deaktiviert. Um es zu aktivieren, wählen Sie die Ein-Schaltfläche und stellen Sie dann im Feld darunter sicher, dass Sie die Adresse eingeben, zu der Ihre Kunden weitergeleitet werden sollen.
