Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Clover
    Basil
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenChangelogClover2025-11-17.clover

Fügt Unterstützung für die Verarbeitung von tokenisierten Bankkontonummern hinzu

Das ändert sich

Fügt Möglichkeiten hinzu, mit denen Sie tokenisierte Bankkontonummern (TANs) über die API verwalten können. TANs sind temporäre Bankkontodaten, die von Finanzinstituten anstelle von echten Kontonummern ausgegeben werden und während ihrer Gültigkeitsdauer für ACH-Zahlungen und -Auszahlungen verwendet werden können. Wenn eine TAN durch Ablauf oder Widerruf deaktiviert wird, schlagen nachfolgende Überweisungen über das Bankkonto fehl…

Financial Connections

Fügt Financial Connections Accounts die Eigenschaft account_numbers hinzu, um Informationen zu tokenisierten Bankkontonummern bereitzustellen. Dazu gehören Details zum Ablaufdatum der Kontonummer und dazu, ob für ein Konto eine tokenisierte Kontonummer (TAN) verwendet wird.

Wir führen außerdem zwei neue Funktionen ein, die Sie über Änderungen Ihrer Kontonummer auf dem Laufenden halten:en:

  • financial_connections.account.account_numbers_updated: Wir senden dieses Ereignis, wenn sich die Kontonummer für ein Financial Connections-Konto ändert.
  • financial_connections.account.upcoming_account_number_expiry: Wir senden dieses Ereignis, wenn sich eine tokenisierte Kontonummer ihrem Ablaufdatum nähert

Zahlungen und Aufstockungen

Fügt einen neuen Enum-Wert tokenized_account_number_deactivated zur Eigenschaft payment_method_us_bank_account_blocked.reason hinzu. Wenn ein Bankkonto gesperrt wird, wurde seine tokenisierte Kontonummer (TAN) von der Partnerbank deaktiviert. Die Eigenschaft blocked_reason enthält spezifische Informationen, die Ihnen helfen zu verstehen, warum das Bankkonto nicht mehr als Zahlungsmethode verwendet werden kann.

Sie können das Ereignis payment_method.automatically_updated verfolgen, um benachrichtigt zu werden, wenn dieses Bankkonto als Zahlungsmethode gesperrt wird.

Auszahlungen

Fügt einen neuen Wert tokenized_account_number_deactivated zum bank_account.status hinzu.

You can listen for the account.external_account.updated event to be notified when an external bank account’s status changes to tokenized_account_number_deactivated.

Auswirkungen

Sie können nun feststellen, wann über Financial Connections verbundene Bankkonten tokenisierte Kontonummern verwenden, und deren Status nachvollziehen. Dies unterstützt Sie dabei, Zahlungs- und Auszahlungsfehler, die auftreten können, wenn tokenisierte Kontonummern deaktiviert werden, proaktiv zu verwalten.

Wenn Ihre Integration ACH-Zahlungen oder -Auszahlungen über Financial Connections-Konten verarbeitet, können Sie diese Informationen nutzen, um Kundinnen und Kunden dazu aufzufordern, ihre Konten vor Ablauf der tokenisierten Nummern erneut zu verbinden. So vermeiden Sie fehlgeschlagene Transaktionen und damit verbundene Gebühren.

Mit diesen neuen Ereignissen können Sie automatisierte Workflows erstellen, die Kundinnen und Kunden benachrichtigen oder Ihre Systeme aktualisieren, wenn sich Kontonummern ändern oder das Ablaufdatum näher rückt.

Änderungen

WerteÄndernAufzählungen
tokenized_account_number_deactivatedHinzugefügt
ConfirmationToken.payment_method_preview.us_bank_account.status_details.blockedPaymentMethod.us_bank_account.status_details.blocked
financial_connections.account.account_numbers_updatedfinancial_connections.account.upcoming_account_number_expiryHinzugefügt
EventFinancialConnections.AccountWebhookEndpoint#update
 + 2 weitere
WebhookEndpoint#createFinancialConnections.Account

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-11-17.clover
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc