Braintree Account Updater und ablaufende Karten

Wenn die Karte eines Kunden abläuft oder ersetzt wird, ist jedes Abo auf der alten Karte eine fehlgeschlagene Zahlung, die nur darauf wartet, zu passieren. Braintree bietet zwei Dienste, die neue Kartendaten von den Netzwerken holen, ohne den Kunden zu fragen: Account Updater und Network Tokens. Keiner deckt jede Karte ab, Sie brauchen also weiterhin einen Weg, die Kunden zu erreichen, die sie verpassen.

Dieser Ratgeber erklärt, wie jeder Dienst funktioniert, welche Details für Abos zählen, und einen Plan für den Rest. Er hält sich an Braintrees eigene Dokumentation: Account Updater, den Account-Updater-Webhook, den Bericht Expiring Cards, die Übersicht zu Network Tokens, How network tokens work, Updating vault records und Recurring billing advanced settings (alle abgerufen im November 2026). Das allgemeine Bild über alle Anbieter hinweg finden Sie unter Network Tokens und Card Account Updater und ablaufende Karten.

Account Updater

Was er tut

Laut Braintrees Leitfaden zu Account Updater fordert Account Updater automatisch Aktualisierungen für im Vault gespeicherte Zahlungsmethoden an, wenn die Karte eines Kunden abläuft oder ersetzt wird, um fehlgeschlagene Transaktionen zu vermeiden. Er arbeitet über die Updater-Programme der Kartennetzwerke, eine Aktualisierung kommt also nur, wenn die kartenausgebende Bank teilnimmt.

Wer ihn nutzen kann

Account Updater ist nicht standardmäßig aktiviert. Braintree sagt, dass die meisten Braintree-Direct-Händler mit Sitz in den USA oder mit überwiegend US-Kunden ihn aktivieren können, und bittet andere, Kontakt aufzunehmen. Die Gebühren stehen in Ihrem Vertrag: Braintrees Disbursement Fee Report führt Account Updater unter den Produktgebühren, die als Ereignisgebühren abgerechnet werden. Prüfen Sie den Preis in Ihrem Vertrag.

Was er nicht abdeckt

• Prepaid-Karten werden nicht unterstützt.
• Über Apple Pay oder Google Pay genutzte Karten werden nicht unterstützt.
• Kartenmarken: Braintrees Entwicklerleitfaden nennt Visa, Mastercard und Discover, während die Marketingseite auch American Express nennt. Die beiden Quellen widersprechen sich bei Amex; klären Sie es für Ihr Konto mit Braintree.

Wann Karten geprüft werden

Nach einem ersten Batch sendet Braintree Aktualisierungsanfragen fortlaufend. Der Leitfaden beschreibt mehrere Auslöser, darunter:

• eine wiederkehrende Zahlung, die innerhalb von zwei Wochen fällig ist;
• eine Ablehnung der Karte, mit einer dokumentierten Ausnahme, die für Abos zählt: Eine Karte bei einem Monatsabo, die 30 Tage zuvor erfolgreich belastet wurde, wird bei der ersten Ablehnung nicht in einen Batch aufgenommen.

Diese Ausnahme bedeutet, dass die erste fehlgeschlagene Monatsverlängerung auf einer ersetzten Karte allein womöglich keine Aktualisierung auslöst. Ihre Wiederholungsversuche und Kunden-E-Mails müssen das abdecken.

Next Day Card Refresh

Braintree beschreibt außerdem Next Day Card Refresh, das versucht, gespeicherte Karten zu aktualisieren, nachdem eine Autorisierung mit bestimmten Ablehnungscodes abgelehnt wurde. Das hilft nur, wenn danach etwas die Zahlung wiederholt, entweder die Wiederholungsversuche von Braintrees Recurring Billing oder Ihre eigene Logik. Wenn Ihre Retry-Einstellungen aus sind, bleibt die aktualisierte Karte bis zum nächsten Abrechnungszyklus ungenutzt. Prüfen Sie sie unter Account Settings, Recurring Billing, Options (erweiterte Einstellungen).

Sehen, was sich geändert hat

Sie können Aktualisierungen im Control Panel, in einem erzeugten Bericht oder über den Webhook Account Updater daily report prüfen. Laut Webhook-Referenz:

• ist er nur für Händler verfügbar, die Account Updater nutzen;
• wird er einmal am Tag mit den in den letzten 24 Stunden aktualisierten Zahlungsmethoden ausgelöst, und nicht, wenn es keine gab;
• enthält die Nutzlast ein Berichtsdatum und eine Berichts-URL, und der Link läuft nach einer Woche ab.

Laden Sie den Bericht herunter und speichern Sie ihn, sobald er eintrifft. Wenn eine Karte aktualisiert wurde, müssen Sie diesem Kunden deswegen keine E-Mail mehr schreiben.

Network Tokens

Network Tokens sind ein separater Dienst von Braintree. Laut Übersicht zu Network Tokens und Funktionsweise:

• Das Kartennetzwerk gibt Aktualisierungen der Bank (Neuausstellung, Diebstahl, Verlust und Änderungen wie ein nahendes Ablaufdatum) an Braintree weiter, das die Kartendaten in Ihrem Vault aktualisiert.
• Es ist keine Änderung der Integration nötig, um sie zu nutzen.
• Sie stehen Händlern in den USA und in ausgewählten Regionen Nord- und Südamerikas und Europas zur Verfügung, die Full Stack mit Braintree abwickeln.
• Ein Token wird nicht unbedingt immer für eine bestimmte Transaktion verwendet.

Braintree dokumentiert außerdem, dass vom Händler ausgelöste wiederkehrende Belastungen zusätzliche Parameter tragen (etwa die Transaktionsquelle und die vorherige Network Transaction ID), wenn Sie wiederkehrende Zahlungen außerhalb von Braintrees eigenem Recurring Billing ausführen. Wenn Sie Braintree-Abos nutzen, klären Sie mit Braintree, wie Tokens in Ihrem Setup greifen.

	Account Updater	Network Tokens
Wie aktualisiert wird	Anfragen an die Updater-Programme der Netzwerke, in Batches und bei Auslösern	Lebenszyklus-Updates vom Netzwerk an das Token
Einrichtung	Muss aktiviert werden; Berechtigung vor allem USA	Keine Änderung der Integration; regionale Verfügbarkeit
Lücken	Prepaid, Apple Pay, Google Pay; nicht teilnehmende Banken	Token wird nicht immer verwendet

Der Bericht Expiring Cards

Für Karten, die keiner der Dienste erfasst, hat Braintrees Control Panel einen Bericht Expiring Cards: Gehen Sie zu Reports, suchen Sie den Bereich Vault und führen Sie Expiring Cards aus. Sie können nach einem eigenen Zeitraum filtern oder alle abgelaufenen Karten ansehen. Führen Sie ihn monatlich für den kommenden Monat aus.

Die Abo-Falle: Neue Karten verschieben keine Abos

Braintrees Vault-Dokumentation weist darauf hin, dass das Hinzufügen einer neuen Zahlungsmethode zum Vault eines Kunden seine bestehenden Abos nicht aktualisiert. Wenn ein Kunde über Ihre App eine neue Karte hinzufügt, müssen Sie auch jedes Abo auf die neue Zahlungsmethode umstellen und dann jede überfällige Belastung mit Subscription: Retry Charge wiederholen. Diesen Schritt zu vergessen, ist ein häufiger Grund, warum ein Kunde „seine Karte aktualisiert” hat und trotzdem gechurnt ist.

Ein Plan für ablaufende Karten bei Braintree

1. Aktivieren Sie Account Updater, wenn Sie berechtigt sind, und Network Tokens, wo verfügbar.
2. Schalten Sie automatische Wiederholungsversuche für Recurring Billing ein, damit Next Day Card Refresh etwas bewirken kann.
3. Speichern Sie den täglichen Account-Updater-Bericht und markieren Sie aktualisierte Karten in Ihrem System.
4. Führen Sie den Bericht Expiring Cards monatlich aus, für Karten, die im nächsten Monat ablaufen.
5. Schreiben Sie Kunden, deren Karten nicht aktualisiert wurden, 30 Tage und erneut etwa 7 Tage vor dem Ablauf, mit einem einzigen Link zu einer Seite zur Kartenaktualisierung.
6. Auf der Aktualisierungsseite speichern Sie die neue Karte, stellen jedes Abo darauf um und wiederholen jede überfällige Belastung.
7. Decken Sie die erste fehlgeschlagene Monatsverlängerung ab. Da eine Karte eines Monatsabos bei der ersten Ablehnung nicht in einen Batch kommt, senden Sie sofort eine Mahnmail, statt auf den Updater zu warten.
8. Schließen Sie nicht unterstützte Karten (Prepaid, Apple Pay, Google Pay) von der Annahme aus, dass der Updater sie erledigt.

Umsetzung mit NoChurn

Account Updater, Network Tokens und die Belastung selbst bleiben bei Braintree. NoChurn liest Art der Zahlungsmethode, Marke, letzte vier Ziffern und Ablaufdatum aus Braintree und ergänzt KI-geschriebene E-Mails, die Sie vor dem Versand prüfen, mit einer gehosteten Seite, auf der der Kunde die Zahlungsmethode aktualisiert. Wenn eine Verlängerung trotzdem fehlschlägt, folgen Mahnmails neben den Abo-Wiederholungsversuchen von Braintree. Siehe NoChurn + Braintree.