Fehlgeschlagene Abo-Zahlungen bei Braintree zurückholen

Das Recurring Billing von Braintree ist bewusst schlank. Es belastet Abos, wiederholt fehlgeschlagene Belastungen nach einem Zeitplan, den Sie wählen, und teilt Ihnen über Webhooks mit, was passiert ist. Alles andere, einschließlich E-Mails an Kunden, einer Seite zur Kartenaktualisierung und dem, was Ihr Produkt tut, während ein Abo überfällig ist, liegt bei Ihnen. Dieser Ratgeber behandelt, was Braintree nativ tut, welche Einstellungen zählen und welche Teile Sie ergänzen müssen. Er endet mit einem kurzen Abschnitt zu Disputes, weil eine fehlgeschlagene oder bestrittene Verlängerung oft zu einem wird.

Er hält sich an Braintrees eigene Dokumentation: Recurring billing advanced settings, die Übersicht zu Recurring Billing, Statuses, Subscription: Retry Charge, Subscription-Webhooks, Account Updater und Managing disputes via the API (alle abgerufen im November 2026).

Was passiert, wenn eine Abo-Belastung fehlschlägt

Wenn Braintree ein Abo abrechnet und die Transaktion vom Prozessor abgelehnt (processor declined) oder vom Gateway zurückgewiesen (gateway rejected) wird, wechselt das Abo zu Past Due. Von dort aus gilt laut Leitfaden zu den erweiterten Einstellungen:

• Braintree wiederholt automatisch, wenn Wiederholungsversuche im Control Panel aktiviert sind.
• Ein erfolgreicher Wiederholungsversuch setzt das Abo wieder auf Active, solange es sein letztes Abrechnungsdatum nicht überschritten hat.
• Automatische Wiederholungsversuche ändern Start- und Enddatum des aktuellen Abrechnungszeitraums nicht.
• Manche Ablehnungscodes, etwa bei einer abgelaufenen oder gestohlenen Karte, werden nie wiederholt, weil sie darauf hindeuten, dass die Transaktion wahrscheinlich nie gelingen wird.

Das Abo-Objekt hilft Ihnen, das zu verfolgen: daysPastDue gibt die Anzahl der Tage an, die das Abo überfällig ist, und failureCount zählt aufeinanderfolgende fehlgeschlagene Belastungsversuche.

Abo-Status im Überblick

Status	Bedeutung (laut Braintrees Statusreferenz)
Active	Normale Abrechnung
Past Due	Eine Belastung ist fehlgeschlagen; Wiederholungsversuche können ausstehen
Canceled	Es findet keine weitere Abrechnung statt
Expired	Das Abo hat seine festgelegte Zahl an Abrechnungszyklen erreicht

Expired ist kein Fehlerzustand; ein Abo, das wegen Nichtzahlung endet, erscheint je nach Ihren Einstellungen als Canceled oder bleibt Past Due.

Die Retry-Einstellungen

Wiederholungsversuche werden im Control Panel unter Account Settings, Recurring Billing, Options konfiguriert, nicht über die API. Die von Braintree dokumentierten Einstellungen:

• Ob fehlgeschlagene Transaktionen automatisch wiederholt werden.
• Tage bis zum ersten Wiederholungsversuch, zwischen 1 und 10 Tagen.
• Was nach fehlgeschlagenen Wiederholungsversuchen passiert: das Abo kündigen, weiter wiederholen oder es überfällig lassen.

Die letzte Einstellung verdient eine bewusste Entscheidung:

Option	Was Braintree tut	Wann es sinnvoll ist
Kündigen	Beendet das Abo	Sie wollen einen klaren Endzustand und gewinnen Kunden separat zurück
Weiter wiederholen	Wiederholt einmal pro Abrechnungszyklus, zum üblichen Abrechnungsdatum	Günstige Pläne, bei denen Kunden oft später Guthaben aufladen
Überfällig lassen	Der Saldo wächst mit jedem Zyklus, keine weiteren Versuche	Sie treiben selbst ein und brauchen die Historie

Bei „überfällig lassen” wächst der Saldo mit jedem Zyklus ohne neuen Versuch, also muss jemand den Kunden kontaktieren. Bei „weiter wiederholen” gibt es nur einen Versuch pro Zyklus, das ersetzt also keine zeitnahen Wiederholungsversuche nach dem ersten Fehlschlag.

Manuelle Wiederholungsversuche

Sie können ein überfälliges Abo mit Subscription: Retry Charge selbst erneut belasten, über die API oder das Control Panel. Übergeben Sie true, um die Transaktion bei Erfolg automatisch zur Abwicklung (settlement) einzureichen. Ein erfolgreicher manueller Versuch bringt das Abo zurück auf Active; ein fehlgeschlagener manueller Versuch zählt nicht als einer der automatischen Versuche. Das rufen Sie direkt auf, nachdem ein Kunde seine Karte aktualisiert hat, statt auf den nächsten geplanten Versuch zu warten.

Account Updater

Account Updater fordert aktualisierte Daten für gespeicherte Karten an, die abgelaufen sind oder ersetzt wurden, und verhindert so manche Fehlschläge, bevor sie passieren. Laut Braintrees Dokumentation:

• Aktualisierungen hängen davon ab, ob die kartenausgebende Bank teilnimmt; Prepaid-Karten und über Apple Pay oder Google Pay genutzte Karten werden nicht unterstützt.
• Nach dem ersten Batch gehen Anfragen fortlaufend raus, unter anderem wenn eine wiederkehrende Zahlung innerhalb von zwei Wochen fällig ist und nach manchen Ablehnungen.
• Sie können Aktualisierungen im Control Panel, in einem Bericht oder über einen täglichen Webhook prüfen.

Ein wichtiges Detail: Das Hinzufügen einer neuen Zahlungsmethode zum Vault eines Kunden stellt bestehende Abos nicht darauf um. Wenn ein Kunde Ihnen eine neue Karte gibt, aktualisieren Sie das Payment Method Token des Abos und wiederholen dann die Belastung.

Webhooks für Abos

Braintree sendet diese Arten von Subscription-Webhooks:

Art	Wann er ausgelöst wird	Was zu tun ist
subscription_charged_unsuccessfully	Ein bestehendes Abo erzeugt keine erfolgreiche Belastung (nicht bei manuellen Versuchen, nicht bei der ersten Belastung)	Ablehnung protokollieren, Kundenkommunikation starten
subscription_went_past_due	Das Abo wechselt von Active zu Past Due (einmal pro Zyklus)	Banner in der App zeigen, erste E-Mail senden
subscription_charged_successfully	Eine Belastung gelingt	Kommunikation stoppen, Banner entfernen
subscription_went_active	Das Abo wird Active	Zugriff wiederherstellen
subscription_canceled	Das Abo wird gekündigt	Zugriff entziehen, Kündigungsdatum speichern
subscription_expired	Das Abo hat seinen letzten Zyklus erreicht	Zugriff wie geplant beenden

Braintree weist darauf hin, dass das Kündigungsdatum nicht in den Suchergebnissen für Abos zurückgegeben wird; wenn Sie es brauchen, speichern Sie es beim Eintreffen von subscription_canceled.

Was Sie selbst ergänzen müssen

Braintree dokumentiert einige E-Mail-Benachrichtigungen für Recurring Billing; prüfen Sie, was sie für Ihr Konto abdecken. Ein vollständiger Wiederherstellungsprozess braucht meist mehr:

1. Eine erste E-Mail bei subscription_went_past_due, am selben Tag gesendet, mit einem einzigen Link zur Kartenaktualisierung. Zitieren Sie nicht den rohen Ablehnungsgrund.
2. Eine Seite zur Kartenaktualisierung, gebaut mit Braintrees clientseitiger Integration, damit Kartendaten direkt zu Braintree gehen und nie Ihre Server berühren. Bei Erfolg aktualisieren Sie die Zahlungsmethode des Abos und rufen Retry Charge auf.
3. Erinnerungen, abgestimmt auf die Wiederholungsversuche, zum Beispiel einen Tag nach jedem fehlgeschlagenen geplanten Versuch.
4. Ein letzter Hinweis, bevor das Abo gekündigt wird, mit dem Datum.
5. Ein Banner in der App, solange das Abo überfällig ist.
6. Eigene Behandlung von Hard Declines. Wenn die Karte abgelaufen ist oder als gestohlen gemeldet wurde, wiederholt Braintree nicht, die E-Mail ist also der einzige Weg zur Wiederherstellung: Senden Sie sie sofort.

Braintree-Disputes

Disputes sind der andere Weg, auf dem Abo-Umsatz verloren geht, und Braintree bietet dafür eine vollständige API, beschrieben in Managing disputes via the API:

• Webhooks der Arten dispute_opened, dispute_won, dispute_lost, dispute_accepted, dispute_expired und weitere teilen Ihnen mit, wenn ein Fall eröffnet wird oder seinen Status ändert.
• Textbeweise (zum Beispiel eine Rückerstattung oder eine Sendungsnummer) fügen Sie mit Dispute: Add Text Evidence hinzu.
• Dateibeweise laden Sie mit einer Document-Upload-Anfrage hoch und hängen sie dann mit Dispute: Add File Evidence an. Braintrees Dokumentation nennt standardmäßig ein Limit von 4 MB pro Datei und 5 MB pro Dispute.
• Finalize sendet Ihre Antwort und Ihre Beweise an die Bank des Karteninhabers. Beweise können nur hinzugefügt werden, solange der Dispute offen ist.
• Antwortfrist: Jeder Dispute hat eine. Verpassen Sie sie, verlieren Sie das Recht auf Anfechtung, und der Dispute wird expired.
• Einen Dispute zu akzeptieren bedeutet, dass Sie ihn nicht anfechten und das Geld an den Kunden zurückgeht.

Für ein Abo-Geschäft ist der stärkste Beweis meist die Historie: wann sich der Kunde angemeldet hat, was er genutzt hat, welche Erinnerungen er erhalten hat und ob er jemals zu kündigen versucht hat. Sammeln Sie sie, bevor die Frist knapp wird.

Umsetzung mit NoChurn

Braintree behält die Kartenverarbeitung, Ihr Händlerkonto und die eigenen Abo-Wiederholungsversuche; NoChurn arbeitet daneben. NoChurn verbindet sich mit Ihrer Braintree-Merchant-ID und Ihren API-Schlüsseln, folgt den Braintree-Webhooks und ergänzt KI-geschriebene Mahnmails, die Sie vor dem Versand prüfen, mit einer gehosteten Seite zur Aktualisierung der Zahlungsmethode. Bei Disputes sammelt NoChurn automatisch Beweise (Antworten im Kündigungsflow, gesendete E-Mails, Nutzung, Support-Gespräche) und entwirft mit KI eine Antwort, die erst nach Ihrer Prüfung an Braintree gesendet wird. Dazu kommen Kündigungsflows mit Angeboten und einem Kündigen per Klick, das immer sichtbar ist, Win-back-Mails an Tag 30, 60 und 90 und ein Churn-Score von 0 bis 100. Siehe NoChurn + Braintree.