So fügen Sie Braintree-Abos einen Kündigungsflow hinzu

Das Recurring Billing von Braintree hat eine einzige Kündigungsoperation, und sie ist endgültig: Ein gekündigtes Abo kann weder bearbeitet noch reaktiviert werden. Es gibt keine eingebaute Kündigungsseite, keine Umfrage nach dem Grund und kein Halteangebot. Wenn Kunden vor dem Gehen eine Alternative sehen sollen und Sie festhalten wollen, warum sie gegangen sind, bauen Sie diesen Flow in Ihrer App und rufen Braintree am Ende auf.

Dieser Ratgeber behandelt die Braintree-Operationen, auf die ein Kündigungsflow angewiesen ist, die Grenzen, die ihn prägen, und einen Entwurf Schritt für Schritt. Er hält sich an Braintrees eigene Dokumentation: Subscription: Cancel, Subscription: Update, Manage subscriptions, Plans, Statuses, Subscription-Webhooks und den Leitfaden zu Abos (alle abgerufen im November 2026).

Wie die Kündigung bei Braintree funktioniert

Subscription: Cancel setzt ein Abo auf Canceled, was Braintrees Statusreferenz so beschreibt, dass keine weitere Abrechnung stattfindet. Die Referenz sagt ausdrücklich, dass Sie ein Abo nach der Kündigung nicht mehr bearbeiten oder reaktivieren können; ein zurückkehrender Kunde braucht ein neues Abo.

Drei Folgen für Ihren Flow:

• Die Kündigung ist der letzte Schritt, nie der erste. Spielen Sie jedes Angebot vor dem Aufruf aus.
• Es gibt kein Flag „zum Laufzeitende kündigen” in der Kündigungsoperation. Wenn Sie mitten im Zyklus kündigen, stoppt die Abrechnung, und worauf der Kunde noch Zugriff hat, entscheiden Sie in Ihrer App.
• Speichern Sie das Kündigungsdatum selbst. Braintree weist darauf hin, dass das Kündigungsdatum nicht in den Suchergebnissen für Abos enthalten ist, und schlägt vor, es aus dem Webhook subscription_canceled zu übernehmen.

Zum Ende des bezahlten Zeitraums beenden

Viele Unternehmen wollen, dass der Kunde den Zugriff bis zum Ende des Bezahlten behält, ohne weitere Belastung. Zwei Ansätze passen zu Braintrees Modell:

1. Jetzt kündigen, Zugriff in Ihrer App behalten bis zum Ende des aktuellen Abrechnungszeitraums, anhand des Enddatums, das Sie für das Abo gespeichert haben.
2. Die Anzahl der Abrechnungszyklen begrenzen. Mit Subscription: Update können Sie die Anzahl der Abrechnungszyklen festlegen, die größer oder gleich dem aktuellen Abrechnungszyklus sein muss, und „never expires” abschalten. Wenn ein Abo die festgelegte Zahl an Zyklen erreicht, markiert Braintree es als Expired. So endet das Abo nach dem aktuellen Zyklus von selbst, und ein Kunde, der es sich vorher anders überlegt, kann wiederhergestellt werden, indem Sie es wieder auf „never expires” setzen.

Der zweite Ansatz hält das Abo bis zu seinem Ende bearbeitbar, was ein „Rückgängig” einfach macht. Testen Sie es mit Ihren Planeinstellungen in der Sandbox, bevor Sie sich darauf verlassen.

Was Sie stattdessen anbieten können

Braintrees Update-Operation gibt Ihnen die Hebel für Halteangebote.

Rabatte

Sie können Rabatte (und Add-ons) auf einem bestehenden Abo hinzufügen, ändern oder entfernen. Die wichtigsten Regeln aus der Dokumentation:

• Die Details eines Rabatts (Name, Betrag, Dauer) werden im Control Panel verwaltet, nicht über die API. Legen Sie Ihre Halterabatte dort zuerst an und wenden Sie sie dann per ID an.
• Ein bestimmter Rabatt kann nur einmal auf ein Abo angewendet werden; um ihn mehrfach anzuwenden, nutzen Sie seine Menge.

Legen Sie einen eigenen Halterabatt an, zum Beispiel „Retention 30% x3”, damit angenommene Angebote in Berichten leicht zu finden sind und nie mit Verkaufsrabatten verwechselt werden.

Preis- und Planwechsel

Sie können den Preis des Abos ändern, mit einem Flag, das steuert, ob die Änderung anteilig verrechnet wird, oder es auf einen anderen Plan verschieben. Braintree weist darauf hin, dass der Wechsel zu einem Plan mit anderer Abrechnungsfrequenz nur ausgewählten Händlern auf Anfrage zur Verfügung steht und den aktuellen Abrechnungszyklus zurücksetzt. Für die meisten Kündigungsflows ist ein Downgrade auf einen günstigeren Plan mit derselben Frequenz das einfachere Angebot.

Eine Pause

Die von uns geprüfte Braintree-Dokumentation beschreibt keine Operation zum Pausieren oder „einen Zyklus überspringen” für Abos. Den Webhook subscription_billing_skipped gibt es, aber er wird ausgelöst, wenn ein Zyklus übersprungen wird, weil ein Guthaben von null oder ein negativer Saldo ihn bereits deckt, nicht auf Anfrage. Wenn Sie eine Pause anbieten wollen, bauen Sie sie auf Braintree auf (zum Beispiel mit einem vorübergehenden vollen Rabatt für eine festgelegte Zahl von Zyklen) und testen das Abrechnungsverhalten vorher sorgfältig.

Webhooks, auf die Ihr Flow hören sollte

Aus Braintrees Subscription-Webhooks:

Art	Nutzung im Kündigungsflow
subscription_canceled	Kündigungsdatum speichern, Zugriff bei Fälligkeit entziehen, Win-back starten
subscription_expired	Das Abo hat seinen letzten Zyklus erreicht (für den Ansatz mit begrenzten Zyklen)
subscription_charged_successfully	Bestätigt, dass ein Angebotspreis belastet wurde

Hören Sie auch auf Kündigungen, die Sie selbst auslösen. Support-Mitarbeiter können im Control Panel kündigen, und diese Kündigungen sollten in denselben Datensätzen landen.

Den Flow bauen

1. Leiten Sie den Kündigungsbutton auf Ihre eigene Seite, nie direkt zur API.

2. Fragen Sie nach dem Grund. Fünf bis sieben Gründe plus „Sonstiges”. Speichern Sie die Antwort mit der Braintree-Abo-ID. Ideen in Umfragen zu Kündigungsgründen.

3. Zeigen Sie ein Angebot, das zum Grund passt:

   Grund	Angebot	Braintree-Operation
   Zu teuer	Befristeter Rabatt	Update: Halterabatt hinzufügen
   Brauche weniger	Günstigerer Plan	Update: Plan oder Preis ändern
   Nutze es gerade nicht	Eine Pause, wenn Sie eine gebaut haben	Ihre eigene Logik (siehe oben)
   Technisches Problem	Hilfe vom Support	Keine, bis es gelöst ist
   Wechsel oder Schließung	Kein Angebot	Kündigen

4. Halten Sie „Abo kündigen” bei jedem Schritt sichtbar, genauso leicht anklickbar wie das Angebot. Regeln und gute Praxis in Click-to-Cancel-Regeln und Best Practices für Kündigungsflows.

5. Bei Annahme rufen Sie Subscription: Update auf und bestätigen per E-Mail den neuen Preis und wie lange er gilt.

6. Bei Kündigung rufen Sie Subscription: Cancel auf (oder begrenzen die Abrechnungszyklen), zeigen das Datum, an dem der Zugriff endet, und senden eine Bestätigung.

7. Behandeln Sie überfällige Abos. Ein Kunde, der kündigt, während er im Verzug ist, schuldet womöglich einen Betrag; legen Sie Ihre Richtlinie fest und zeigen Sie sie.

8. Prüfen Sie monatlich, welche Gründe am häufigsten vorkommen und welche Angebote nach drei Monaten noch zahlen.

Häufige Fehler

• Kündigen und dann versuchen, ein Angebot anzuwenden. Gekündigte Abos können nicht bearbeitet werden.
• Rabatte im Code anlegen. Die Details von Rabatten liegen im Control Panel; planen Sie sie im Voraus.
• Das Kündigungsdatum verlieren. Ohne gespeicherten Webhook können Sie Win-back-Mails nicht timen und Churn nicht nach Monat messen.
• Die Kündigungsoption hinter dem Angebot verstecken. Das kostet Vertrauen und verstößt vielerorts gegen die Regeln.

Umsetzung mit NoChurn

Braintree behält das Abo, die Zahlungen und die Kündigung selbst. Der Kündigungsflow von NoChurn fragt nach dem Grund, zeigt ein Angebot (einen Rabatt, einen Planwechsel oder eine Kündigung auf dem Braintree-Abo) und hält bei jedem Schritt ein Kündigen per Klick sichtbar, gehostet oder headless über die API. Die Antworten speisen Win-back-Mails an Tag 30, 60 und 90 und einen Churn-Score von 0 bis 100, und sie werden zu Beweisen, wenn der Kunde später einer Belastung widerspricht. Siehe NoChurn + Braintree.