PayPal Commerce ist die moderne PayPal-Integration von Charitable – eine einzige Verbindung, mit der Ihre Spender mit PayPal, Venmo, Pay Later, Kredit- und Debitkarten, Apple Pay und Google Pay bezahlen können. Diese Seite führt Sie durch die Aktivierung auf Ihrer Website und erklärt, was zu tun ist, wenn es nicht in Ihrer Gateway-Liste angezeigt wird.

PayPal Commerce ersetzt die älteren PayPal Standard-, Express Checkout- und Card Processing-Einrichtungen durch eine Integration, die auch Venmo, Pay Later, Apple Pay und Google Pay freischaltet. Spender sehen moderne Wallet-Buttons und einen schnelleren Checkout, und Sie verwalten Rückerstattungen und wiederkehrende Spenden direkt in WordPress, ohne mehrere PayPal-Produkte oder -Konten jonglieren zu müssen. Den vollständigen Hintergrund finden Sie unter PayPal Commerce vorstellen.

Verfügbar in Charitable Pro 1.8.15+.

PayPal Commerce aktivieren

1. Gehen Sie in Ihrem WordPress-Adminbereich zu Charitable → Einstellungen → Zahlungs-Gateways.
2. Finden Sie PayPal Commerce in der Gateway-Liste und klicken Sie auf Aktivieren.
3. Klicken Sie bei PayPal Commerce auf Einstellungen und dann auf Mit PayPal verbinden.
4. PayPal öffnet sich in einem neuen Fenster. Melden Sie sich bei Ihrem PayPal-Geschäftskonto an (oder erstellen Sie eines) und genehmigen Sie die Verbindung.
5. PayPal leitet Sie zurück zu WordPress. Das Verbindungspanel zeigt Ihre Händler-ID und die für Ihr Konto gewährten Funktionen an.

Das war's – Ihre Spendenformulare bieten PayPal Commerce sofort als Zahlungsoption an.

Testmodus – PayPal Commerce berücksichtigt den standardmäßigen Testmodus-Schalter von Charitable. Lassen Sie den Testmodus aktiviert, während Sie den Spenderfluss validieren, und schalten Sie ihn dann aus, wenn Sie bereit sind, Live-Spenden anzunehmen.

PayPal Commerce nicht in Ihrer Gateway-Liste?

Um die Dinge vorhersehbar zu halten, wird nur eine PayPal-Integration pro Website gleichzeitig angezeigt. Wenn Ihre Website bereits mit dem vorhandenen PayPal-Gateway (PayPal Standard / IPN) eingerichtet ist, bleibt PayPal Commerce standardmäßig ausgeblendet und die Gateway-Liste zeigt stattdessen Ihre vorhandene PayPal-Konfiguration an.

Charitable entscheidet, welche während des 1.8.15-Upgrades angezeigt wird, indem es zwei Signale prüft:

• Ist das vorhandene PayPal-Gateway derzeit in Ihren Einstellungen aktiviert?
• Gibt es bereits Spenden auf Ihrer Website, die über das vorhandene PayPal-Gateway abgewickelt wurden?

Wenn eine dieser Bedingungen zutrifft, behält Ihre Website ihre vorhandene PayPal-Konfiguration bei und PayPal Commerce wird ausgeblendet.

Dies ist das richtige Verhalten für die überwiegende Mehrheit der Websites – die gleichzeitige Ausführung beider Integrationen erschwert die Spendererfahrung und die Buchhaltung. Aber wenn Sie trotzdem zu PayPal Commerce wechseln möchten, können Sie das tun.

Wechsel zu PayPal Commerce

Bevor Sie wechseln – lesen Sie dies

Wenn Sie aktive wiederkehrende Spenden haben, die über das vorhandene PayPal-Gateway laufen, lesen Sie dies bitte sorgfältig durch:

• PayPal wird Ihre Spender weiterhin abrechnen gemäß dem von Ihnen festgelegten Zeitplan. Keiner Ihrer Spender wird storniert.
• Nach dem Wechsel wird Charitable diese Verlängerungen jedoch nicht mehr in Ihrem Dashboard aufzeichnen, da der IPN-Handler für das vorhandene PayPal-Gateway deaktiviert wird, wenn Sie wechseln.

Wenn die Berichterstattung über diese Verlängerungen für Sie wichtig ist, kündigen Sie die wiederkehrenden Spenden in Ihrem PayPal-Dashboard, bevor Sie wechseln. Oder kontaktieren Sie unser Support-Team – wir können Ihnen helfen, aktive Spender zu migrieren, wenn unser Migrationstool in einer zukünftigen Version verfügbar ist.

Wenn Sie nur einmalige historische Spenden und keine aktiven wiederkehrenden Spenden haben, hat der Wechsel keine Auswirkungen auf die Spender.

Drei Wege zum Wechseln

Wählen Sie den Weg, der Ihrem Zugriffslevel entspricht. Alle drei Wege erreichen dasselbe Ziel.

Weg 1 – WP-CLI (empfohlen für Entwickler und Agenturen)

Wenn Sie Shell-Zugriff auf Ihren Server haben (SSH, Hosting-CLI usw.), ist dies der sauberste Weg:

wp charitable paypal force-commerce-tier --confirm-recurring-impact

Das Flag --confirm-recurring-impact ist erforderlich, wenn Sie aktive wiederkehrende Spenden im bestehenden PayPal-Gateway haben. Der Befehl wird sonst nicht ausgeführt, mit einer Angabe, wie viele Spenden betroffen wären.

Sehen Sie in der Vorschau, was mit dem Flag --dry-run passieren würde, bevor Sie Änderungen vornehmen:

wp charitable paypal force-commerce-tier --dry-run

Gehen Sie nach dem Wechsel zu Charitable → Einstellungen → Zahlungs-Gateways und schließen Sie den Flow Mit PayPal verbinden auf der PayPal Commerce-Karte ab, um Spenden anzunehmen.

Weg 2 – functions.php-Filter (für Entwickler ohne Shell-Zugriff)

Fügen Sie diesen Codeausschnitt zu functions.php Ihres Themes oder einem kleinen benutzerdefinierten Plugin hinzu:

add_filter( 'pre_option_charitable_paypal_user_tier', function () {
    return 'commerce';
} );

Der Filter wird bei jedem get_option()-Aufruf ausgeführt, sodass PayPal Commerce beim nächsten Laden einer Admin-Seite sofort sichtbar wird.

Dies ist eine Laufzeitüberschreibung – sie ändert nicht den gespeicherten Wert in Ihrer Datenbank. Die Überschreibung bleibt aktiv, solange der Filter in Ihrem Code vorhanden ist; entfernen Sie den Filter und die ursprüngliche Sichtbarkeit wird wiederhergestellt. Wenn Sie die Änderung dauerhaft vornehmen möchten, ohne den Filter beizubehalten, lassen Sie ihn vorerst aktiv, um zu überprüfen, ob alles funktioniert, und führen Sie dann den WP-CLI-Befehl aus Weg 1 aus.

Weg 3 – SQL-Update (für Benutzer von Hosting-Panels / phpMyAdmin)

Wenn Sie mit phpMyAdmin, Adminer oder dem Datenbank-Tool Ihres Hosting-Panels vertraut sind, führen Sie diese Abfrage gegen Ihre WordPress-Datenbank aus:

UPDATE wp_options
SET option_value = 'commerce'
WHERE option_name = 'charitable_paypal_user_tier';

Ersetzen Sie wp_options durch Ihr tatsächliches Tabellenpräfix, falls es nicht das Standardpräfix ist. Die Änderung ist sofort wirksam – aktualisieren Sie die Seite mit den Gateway-Einstellungen und PayPal Commerce wird angezeigt.

⚠️ Erinnerung: Wenn Sie aktive wiederkehrende Spenden im bestehenden PayPal-Gateway haben, wird PayPal die Spender weiterhin abbuchen, aber Charitable wird diese Verlängerungen nicht erfassen. Kündigen Sie diese zuerst bei PayPal oder fahren Sie fort und seien Sie sich des Kompromisses bewusst.

Was nach dem Wechsel passiert

• Das bestehende PayPal-Gateway verschwindet aus Ihrer Liste der Gateway-Einstellungen. Seine gespeicherten API-Anmeldeinformationen bleiben in der Datenbank, falls ein zukünftiger umgekehrter Weg hinzugefügt wird.
• PayPal Commerce erscheint in der Gateway-Liste. Sein Button Mit PayPal verbinden ist aktiviert. Klicken Sie darauf, um mit der Einrichtung bei PayPal zu beginnen.
• Bis Sie die Einrichtung abgeschlossen haben, zeigt PayPal Commerce den Status „nicht verbunden“ an und Spender sehen PayPal nicht als Zahlungsoption im Spendenformular.
• Spenden, die vor dem Wechsel erfasst wurden, sind nicht betroffen – sie behalten ihr ursprüngliches Gateway-Tag und bleiben in Ihren Berichten sichtbar.

So machen Sie einen Wechsel rückgängig

Es gibt keine Schaltfläche zum Rückgängigmachen in der Benutzeroberfläche. Der Wechsel ist nach dem aktuellen Modell einseitig.

Wenn Sie versehentlich gewechselt haben oder auf ein unerwartetes Problem gestoßen sind, wenden Sie sich bitte an unser Support-Team. Wir können Ihre vorherige Konfiguration direkt wiederherstellen und verfolgen diese Anfragen, um zu entscheiden, ob wir in einer zukünftigen Version einen ordnungsgemäßen Rückweg einbauen sollten.

Benötigen Sie Hilfe?

Wenn etwas unklar ist oder Sie Hilfe beim Wechsel benötigen, hilft Ihnen unser Support-Team gerne weiter. Eröffnen Sie ein Ticket von Ihrem Charitable-Konto aus und erwähnen Sie „PayPal Commerce-Aktivierung“ – wir kümmern uns um den Rest.