Braintree ist ein von PayPal entwickelter Zahlungsdienst, mit dem Sie Spenden sicher auf Ihrer Website annehmen können. Ihre Spender haben dabei die Flexibilität, über PayPal, Venmo (in den USA), Kredit- oder Debitkarten oder digitale Wallets wie Google Pay und Apple Pay zu bezahlen.

Installation

Die Installation von Charitable Braintree ist dieselbe wie die Installation jeder anderen Charitable-Erweiterung. Wenn Sie nicht sicher sind, wie das geht, empfehlen wir Ihnen, zuerst unseren Leitfaden zur Installation von Charitable-Erweiterungen zu lesen.

Gateway aktivieren

Nachdem Sie das Charitable Braintree-Plugin installiert und aktiviert haben, müssen Sie es als Zahlungsgateway aktivieren. Wenn Sie sich auf der Plugin-Seite befinden, können Sie dies direkt von dort tun, indem Sie auf den Link „Braintree-Gateway aktivieren“ klicken:

Alternativ können Sie das Gateway über die Einstellungsseite für Zahlungsgateways aktivieren:

1. Gehen Sie zu Charitable > Einstellungen > Zahlungsgateways
2. Klicken Sie im Braintree-Block auf Gateway aktivieren.

Einstellungen

Um Zahlungen mit Braintree abwickeln zu können, müssen Sie Charitable mit Ihren Braintree-Einstellungen konfigurieren.

1. Gehen Sie zu Charitable > Einstellungen > Zahlungsgateways.
2. Klicken Sie auf Gateway-Einstellungen.

Einrichtung Ihrer API-Schlüssel

Wenn Sie sich zum ersten Mal in Ihr Braintree-Konto einloggen oder wenn Sie noch keine Transaktionen darüber getätigt haben, werden Ihre Händler-ID, Ihr öffentlicher Schlüssel und Ihr privater Schlüssel sofort nach der Anmeldung angezeigt:

Kopieren Sie diese Schlüssel und fügen Sie sie in Ihre Charitable-Einstellungen ein.

Wenn dies nicht angezeigt wird, wenn Sie sich in Ihr Braintree-Konto einloggen, können Sie die folgenden Anweisungen befolgen, um die relevanten Details zu finden:

1. Klicken Sie in der oberen rechten Ecke Ihres Braintree-Dashboards auf das Zahnradsymbol und dann auf API.
2. Ihren öffentlichen Schlüssel finden Sie im Abschnitt „API-Schlüssel“ oben. Wenn keine API-Schlüssel angezeigt werden, klicken Sie auf Neuen API-Schlüssel generieren.
3. Klicken Sie in der Spalte „Privater Schlüssel“ auf den Link Anzeigen. Auf dem folgenden Bildschirm werden Ihr privater Schlüssel, Ihre Händler-ID und Ihr öffentlicher Schlüssel angezeigt.

Braintree im Testmodus verwenden

Um zu testen, wie Braintree funktioniert, empfehlen wir, es zuerst mit einem Sandbox-Konto zu testen. Sie können ein Sandbox-Konto unter https://sandbox.braintreegateway.com erstellen.

Ihren öffentlichen Schlüssel, Ihren privaten Schlüssel und Ihre Händler-ID finden Sie auf die gleiche Weise wie für ein Live-Konto (siehe obige Anweisungen). Kopieren Sie diese und fügen Sie sie in den Abschnitt „Testmodus-Einstellungen“ in Ihren Charitable Braintree-Einstellungen ein.

Einrichtung zusätzlicher Zahlungsmethoden

Neben Kartenzahlungen können Sie auch Zahlungen per PayPal, Venmo (nur USA), Apple Pay und Google Pay akzeptieren.

Um diese Zahlungsmethoden akzeptieren zu können, müssen Sie die Zahlungsmethoden sowohl in Braintree als auch in Ihren Charitable-Einstellungen aktivieren.

Schritt 1: Zahlungsmethoden in Braintree aktivieren

1. Klicken Sie in der oberen rechten Ecke Ihres Braintree-Dashboards auf das Zahnradsymbol und dann auf Verarbeitung.
2. Auf der Seite "Verarbeitung" aktivieren Sie alle Zahlungsmethoden, für die Sie die Unterstützung hinzufügen möchten. Die Integration von Charitable unterstützt derzeit PayPal, Venmo, Apple Pay und Google Pay.

Hinweis: Venmo ist nur für Braintree-Konten mit Sitz in den USA verfügbar. Möglicherweise wird es Ihnen daher nicht als aktivierbare Option angezeigt.

Schritt 2: Zahlungsmethoden in Charitable aktivieren

Sobald Sie die Zahlungsmethoden in Braintree aktiviert haben, können Sie sie in Charitable aktivieren, indem Sie einfach das Kontrollkästchen aktivieren:

3D Secure aktivieren

Charitable integriert sich nahtlos in die 3D Secure 2-Funktionalität von Braintree, die Betrug reduziert, die Sicherheit verbessert und die Anforderungen der starken Kundenauthentifizierung (SCA) erfüllt. Um sie zu aktivieren, aktivieren Sie einfach das Kontrollkästchen:

Einrichtung wiederkehrender Spenden

Wenn Sie Braintree zusammen mit unserer Erweiterung Wiederkehrende Spenden verwenden, sind einige zusätzliche Einrichtungsschritte erforderlich.

Einen wiederkehrenden Abrechnungsplan erstellen

Um eine wiederkehrende Spende über Braintree zu erstellen, benötigen Sie einen Abrechnungsplan. Wenn jemand eine wiederkehrende Spende startet, wird für ihn ein Abonnement erstellt, das diesen Plan verwendet.

Hinweis: Auch wenn die Pläne, die Sie in Braintree erstellen, einen Festpreis haben, ist dies ein Standardwert. Für einzelne Abonnements kann ein Spenderabonnement diese Werte überschreiben. Aus diesem Grund ist es möglich, einen einzigen wiederkehrenden Abrechnungsplan für alle wiederkehrenden Spenden desselben Zeitraums zu verwenden, die über Ihre Website erstellt werden.

Um einen Abrechnungsplan in Ihrem Braintree-Dashboard zu erstellen:

1. Klicken Sie in der oberen Navigation auf Abonnements.
2. Klicken Sie oben auf der Seite auf Pläne.
3. Wenn Sie einen neuen Plan erstellen, klicken Sie auf + Plan erstellen; wenn Sie einen neuen Plan hinzufügen, klicken Sie auf + Neuer Plan.
4. Geben Sie für die Plan-Einstellungen den Namen Ihres Plans, den Standardpreis, die Währung und die Abrechnungsfrequenz ein. Sie können auch eine Plan-ID und eine Beschreibung angeben, obwohl beides optional ist. Alle anderen Einstellungen sollten leer gelassen oder unverändert bleiben.
5. Klicken Sie auf Erstellen.

Nachdem Sie Ihren Plan erstellt haben, kehren Sie zum Dashboard Ihrer Website zurück und navigieren Sie zur Braintree-Einstellungsseite (Charitable > Einstellungen > Zahlungsgateways > Braintree Gateway-Einstellungen). Scrollen Sie nach unten zum Abschnitt "Wiederkehrende Abrechnung":

Wählen Sie die Standard-Abrechnungspläne aus, die Sie für jeden wiederkehrenden Spendenzeitraum verwenden möchten, sowohl für den Live-Modus als auch für den Testmodus. Für den Testmodus müssen Sie Abrechnungspläne in Ihrem Braintree-Sandbox-Dashboard erstellen.

Verwendung unterschiedlicher Pläne für verschiedene Kampagnen

Es kann nützlich sein, verschiedene wiederkehrende Abrechnungspläne für verschiedene Kampagnen zu definieren. Dies kann es Ihnen beispielsweise erleichtern, alle wiederkehrenden Spenden für eine bestimmte Kampagne in Ihrem Braintree-Dashboard zu finden.

Dazu müssen Sie zunächst so viele Pläne erstellen, wie Sie benötigen, in Ihrem Braintree-Dashboard, indem Sie die oben beschriebenen Schritte befolgen. Sie können die Standard-Planeinstellungen in Charitable unverändert lassen.

Um den wiederkehrenden Abrechnungsplan für eine bestimmte Kampagne zu ändern, bearbeiten Sie die Kampagne in Ihrem WordPress-Dashboard. Wählen Sie im Abschnitt „Wiederkehrende Spenden“ Ihren bevorzugten Abrechnungsplan für die Kampagne aus. Beachten Sie, dass es separate Einstellungen für den Live- und Testmodus gibt.

Einen Webhook hinzufügen

Wenn ein Spender eine wiederkehrende Spende hat, kann Braintree über einen Webhook Benachrichtigungen an Ihre Website senden, wann immer wichtige abonnementsbezogene Ereignisse auftreten, wie zum Beispiel:

• Eine Verlängerung wurde abgerechnet
• Die wiederkehrende Spende wurde storniert
• Braintree konnte die letzte Verlängerung nicht verarbeiten

Ohne einen Webhook würde Charitable nicht über diese Ereignisse informiert werden, daher ist es wichtig, einen Webhook hinzuzufügen.

1. Klicken Sie in der oberen rechten Ecke Ihres Braintree-Dashboards auf das Zahnradsymbol und dann auf API.
2. Klicken Sie oben auf den Link Webhooks.
3. Klicken Sie auf + Neuen Webhook erstellen, um Ihren Webhook hinzuzufügen.
4. Geben Sie für „Ziel-URL“ Ihre Website-URL ein, gefolgt von /charitable-listener/braintree/. Wenn Ihre Website beispielsweise example.com ist, lautet Ihre Ziel-URL https://example.com/charitable-listener/braintree/.
5. Aktivieren Sie unter „Benachrichtigungen“ alle Optionen unter „Abonnement“.

Nachdem Sie den Webhook hinzugefügt haben, klicken Sie auf URL überprüfen, um sicherzustellen, dass der Webhook ordnungsgemäß eingerichtet ist und Ihre Website erreichen kann. Ihr Server sollte mit dem Statuscode 200 antworten.

Wenn Sie Braintree Sandbox zum Testen verwenden, empfehlen wir außerdem, einen Webhook in Ihrem Sandbox-Konto hinzuzufügen, indem Sie den gleichen Prozess befolgen.