> For the complete documentation index, see [llms.txt](https://docs.payrexx.com/merchant/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payrexx.com/merchant/zahlungen/funktionalitaeten/abonnemente/abonnemente-mittels-tokenisierung-api.md). # Abonnemente mittels Tokenisierung (API) In diesem Artikel erfährst Du, wie Du in Payrexx wiederkehrende Zahlungenn (Abonnemente) mittels Tokenisierung über die API empfangen kannst. {% hint style="info" %} 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. {% endhint %} ## 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: {% content-ref url="/pages/-MZCkS8Ie-bJt1KXgavb" %} [Tokenisierung](/merchant/zahlungen/funktionalitaeten/tokenisierung.md) {% endcontent-ref %} Payrexx bietet zwei Möglichkeiten, Abonnemente einzurichten: 1. Bei den [durch Payrexx verwalteten Abonnementen](/merchant/zahlungen/funktionalitaeten/abonnemente/abonnemente-verwaltet-durch-payrexx.md) ü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". {% hint style="info" %} Sind Deine Abonnemente hingegen regelmässig in Zeitraum, Produkt, Preis und Zahlungsmittel, empfiehlt sich in der Regel die [von Payrexx verwaltete Variante](/merchant/zahlungen/funktionalitaeten/abonnemente/abonnemente-verwaltet-durch-payrexx.md), da Du sie ohne technische Kenntnisse einrichten kannst. {% endhint %} ## 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](https://docs.payrexx.com/developer): {% embed url="" %} ## 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.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.payrexx.com/merchant/zahlungen/funktionalitaeten/abonnemente/abonnemente-mittels-tokenisierung-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.