Abonnemente mittels Tokenisierung (API)

In diesem Artikel erfährst Du, wie Du in Payrexx wiederkehrende Zahlungenn (Abonnemente) mittels Tokenisierung über die API empfangen kannst.

Die Abkürzung "API" steht für Application Programming Interface. Man versteht darunter einen Satz von Befehlen, Funktionen und Protokollen, mit dem eine Software mit einem anderen System interagieren kann.

Was ist eine Tokenisierung?

Unter einer Tokenisierung versteht man die Speicherung einer Zahlungsmethode für zukünftige Zahlungen. Welche Vorteile Tokenisierungen bieten und wie sie in Payrexx eingerichtet werden können, erfährst Du im folgenden Artikel:

Tokenisierung

Payrexx bietet zwei Möglichkeiten, Abonnemente einzurichten:

1. Bei den durch Payrexx verwalteten Abonnementen übernimmt Payrexx automatisch die Belastungen, Zahlungserinnerungen und Kundeninformation.

2. Bei den Abonnementen mittels Tokenisierung läuft es über die API, was in diesem Artikel erklärt wird.

Für wen eignet sich die API-Methode?

Bei der API-Variante verwaltest Du Belastungen und Benachrichtigungen vollständig selbst. Diese Methode eignet sich besonders, wenn:

• Deine wiederkehrenden Zahlungen keine feste Regelmässigkeit haben (unterschiedliche Intervalle oder Zeitpunkte)

• Deine Kunden keine langfristige Verpflichtung eingehen sollen

• der abzubuchende Betrag variabel ist, zum Beispiel "Pay-per-Use".

Sind Deine Abonnemente hingegen regelmässig in Zeitraum, Produkt, Preis und Zahlungsmittel, empfiehlt sich in der Regel die von Payrexx verwaltete Variante, da Du sie ohne technische Kenntnisse einrichten kannst.

Wie funktioniert es?

Der Ablauf besteht aus den folgenden drei Schritten:

1. Token-Erstellung: Beim Erstkontakt mit dem Kunden wird über das Payrexx-Gateway mit dem Parameter preAuthorization statt einer einmaligen Zahlung ein Token erstellt. Optional kann mit dem Parameter chargeOnAuthorization direkt im Anschluss eine erste Belastung ausgelöst werden.

2. Transaktions-ID ermitteln: Nach der Autorisierung erhältst Du die entsprechende Transaktions-ID entweder über den Transaction-Webhook oder beim Abruf des Gateways über die API (Status authorized).

3. Belastung auslösen: Mit der Transaktions-ID kannst Du über den Endpunkt zur Belastung einer vorautorisierten Transaktion beliebig oft Beträge Deiner Wahl abbuchen.

Wichtige Eigenschaften dieser Methode:

• Für jede Belastung kann ein individueller Betrag angegeben werden

• Es gibt keine Erfolgsgarantie für eine einzelne Belastung

• Ein einmal erstelltes Token verfällt nicht

Technische Informationen

Technische Informationen und eine Anleitung, um Abonnements-Zahlungen mittels Tokenisierung zu ermöglichen, findest Du im entsprechenden Artikel in unserer Entwickler-Dokumentation:

Tokenization | Developerdocs.payrexx.com

Häufig gestellte Fragen

In welchen Fällen werden bei Abonnementen die Webhhoks "Transaction" und "Subscription" ausgeführt?

• Kündigung: Der Webhook "Subscription" (Status: cancelled) wird ausgelöst.

• Aktualisieren eines Zahlungsmittels: Der Webhook "Subscription" mit den neuen Token-Daten wird ausgelöst.

• Abbuchung: Der Webhook "Transaction" wird in jedem Fall ausgelöst. Bei einer erfolgreichen Abbuchung folgt zusätzlich der Webhook "Subscription" mit dem neuen Abbuchungsdatum (next_pay_date).

Ist es über die API möglich, ein Abonnement auf das nächste Ablaufdatum zu kündigen?

Nein, über die API ist nur das sofortige Löschen eines Abonnements (DELETE) möglich. Eine Kündigung per Ende der Laufzeit kann nur in der Händler-Administration von Payrexx eingestlelt werden, über die API jedoch nicht.

Ist es möglich, die Adressdaten eines Kunden über die API zu aktualisieren?

Nein, die Adressdaten sind an den Zahlungsprozess gebunden und können nicht isoliert über die API aktualisiert werden.

Wann versendet Payrexx Bestätigungs-E-Mails?

Wenn der Versand der Bestätigungs-E-Mails unter Einstellungen > Benachrichtigungen aktiviert ist, versendet Payrexx die E-Mails. Wenn der Versand deaktiviert ist, versendet Payrexx keine E-Mails.