# Bankkonten mit tokenisierten Kontonummern verwalten Erfahren Sie mehr über tokenisierte Kontonummern, deren Auswirkungen auf Ihre Integration und das Verwalten von TAN-Konten. Tokenisierte Kontonummern (TANs) sind temporäre Bankkonto-Anmeldedaten, die von Finanzinstituten anstelle von echten Kontonummern ausgestellt werden. Chase, PNC Bank und die US Bank stellen TANs aus. ## Before you begin 1. [Basiswissen](https://docs.stripe.com/financial-connections/fundamentals.md) zu Financial Connections 1. Informieren Sie sich über [Webhook-Ereignisse](https://docs.stripe.com/financial-connections/webhooks.md) für ein Financial Connections-Konto, um zu erfahren, wie Sie Aktualisierungen zu Änderungen an Financial Connections-Konten erhalten können. ## Die Funktionsweise von TANs TANs verhalten sich ähnlich wie echte Konto- und Routingnummern. Wenn ihr Status aktiv ist, können Sie sie zum Akzeptieren von ACH-Zahlungen und zum Senden von Auszahlungen verwenden. Im Gegensatz zu echten Kontonummern kann eine TAN deaktiviert werden, was dazu führen kann, dass nachfolgende ACH-Transaktionen auf dem [Financial Connections-Konto](https://docs.stripe.com/financial-connections/fundamentals.md#financial-connections-account) fehlschlagen. > Das TAN-Verhalten variiert je nach Finanzinstitut. Einige Banken unterstützen den Widerruf durch Kundinnen und Kunden sowie den Ablauf, andere hingegen nicht. Um das spezifische Verhalten je Institut einzusehen, lesen Sie die [TAN-Details nach Bank](https://docs.stripe.com/financial-connections/tokenized-account-numbers.md#tan-details-by-bank). ### Echte Kontonummern mit TAN vergleichen Dies sind die Unterschiede zwischen echten Kontonummern und TANs: | | Echte Kontonummern | Tokenisierte Kontonummern | | -------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Langfristige Stabilität** | Geben bei jedem Verknüpfen des Kontos dieselben Konto- und Routingnummern zurück. | Geben Sie jedes Mal eine neue tokenisierte Konto- und Routingnummer zurück, wenn das Konto beim Institut autorisiert wird. | | **Ablauf** | Laufen nicht ab | Kann nach Ermessen des ausstellenden Instituts ablaufen (variiert je nach Bank) | | **Widerruflich** | Kunde/Kundin kann nicht widerrufen | Kundinnen und Kunden haben möglicherweise ein Widerrufsrecht (variiert je nach Bank) | | **Für Kundinnen und Kunden erkennbar** | Ja | Nein | ### Deaktivierte TANs TANs können je nach den Richtlinien der ausstellenden Bank deaktiviert werden. Um Zahlungsausfälle zu vermeiden, können Sie [mit deaktivierten TANs verfahren](https://docs.stripe.com/financial-connections/tokenized-account-numbers.md#handle-deactivated-tans). Zu den üblichen Deaktivierungsszenarien gehören: - **Widerruf**: Wenn eine Kundin oder ein Kunde den Zugriff auf ihre/seine Kontodaten über das Online-Banking-Portal seines Finanzinstituts (z. B. über das Chase Security Center) aktiv widerruft. Diese Option ist nur bei einigen Instituten verfügbar. - **Ablauf:** Die TAN verfällt nach einer von der Institution festgelegten Zeitspanne. Nicht alle Banken wenden eine zeitbasierte Gültigkeitsdauer an. Wenn eine TAN deaktiviert wurde, müssen Ihre Kundinnen und Kunden ihr [Bankkonto erneut verknüpfen](https://docs.stripe.com/financial-connections/relink.md) oder ein anderes Bankkonto verknüpfen, damit sie weiterhin Zahlungen tätigen oder Auszahlungen empfangen können. Um zu erfahren, welche Institutionen die Widerrufs- und Ablauffunktion unterstützen, konsultieren Sie bitte die [TAN-Details der jeweiligen Bank](https://docs.stripe.com/financial-connections/tokenized-account-numbers.md#tan-details-by-bank). ## So verwalten Sie TANs ### Kundinnen und Kunden echte Kontodetails in Ihrer Nutzeroberfläche anzeigen Wenn Sie Kontokennungen anzeigen, damit Kundinnen und Kunden ein Bankkonto in Ihrer Anwendung erkennen und auswählen können, zeigen Sie das Feld [last4](https://docs.stripe.com/api/financial_connections/accounts/object.md#financial_connections_account_object-last4) aus dem Objekt [Financial Connections-Konto](https://docs.stripe.com/api/financial_connections/accounts/object.md) an. Dieses Feld zeigt unabhängig davon, ob das Institut TANs oder echte Kontonummern verwendet, die letzten vier Ziffern der echten Konto Nummer. ### Financial Connections-Konten mit TANs und deren Status identifizieren Verwenden Sie die [Financial Connections API](https://docs.stripe.com/api/financial_connections/accounts.md), um festzustellen, ob ein Bankkonto eine TAN oder eine echte Kontonummer hat und ob diese TAN für ACH-Transaktionen verwendet werden kann. Um festzustellen, ob ein [Financial Connections-Konto](https://docs.stripe.com/api/financial_connections/accounts.md) eine TAN hat, sehen Sie im Feld [identifier_type](https://docs.stripe.com/api/financial_connections/accounts/object.md#financial_connections_account_object-account_numbers-identifier_type) der Objekte im Array [account_numbers](https://docs.stripe.com/api/financial_connections/accounts/object.md#financial_connections_account_object-account_numbers) nach. Dieses Feld ist auf `tokenized_account_number` gesetzt, wenn es sich bei der Kontonummer um eine TAN handelt. Der `identifier_type` einer echten Kontonummer ist auf `account_number` gesetzt. ```curl curl https://api.stripe.com/v1/financial_connections/accounts/fca_zbyrdjTrwcYZJZc6WBs6GPid \ -u "<>:" ``` Diese Beispielanfrage gibt ein Financial Connections-Konto mit Informationen zu einer TAN zurück. ```json { "id": "fca_zbyrdjTrwcYZJZc6WBs6GPid", "object": "financial_connections.account", "account_holder": { "customer": "cus_NfjonN9919dELB", "type": "customer" }, "institution_name": "PNC Bank", "status": "active", "account_numbers": [ { "identifier_type": 'tokenized_account_number, "expected_expiry_date": null, "status": "transactable", "supported_networks" : ["ach"] } ] } ``` Prüfen Sie in der Anfrage den [Status](https://docs.stripe.com/api/financial-connections/accounts/object.md#financial_connections_account_object-status) der TAN. Der Status einer TAN kann folgendermaßen lauten: | Status | Beschreibung | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `transactable` | Sie können dieses Konto und dessen tokenisierte Kontonummer weiterhin für Geldbewegungen einschließlich ACH-Zahlungen und -Auszahlungen verwenden. | | `deaktiviert` | Die Kundin oder der Kunde hat den Zugriff auf die TAN in seinem/ihrem Bankportal widerrufen. Transaktionen mit dieser TAN schlagen fehl. | Es kann vorkommen, dass ein Financial Connections-Konto auch dann einen aktiven `Status` hat, wenn seine TAN deaktiviert ist, sofern das Konto weiterhin für Bankdatenaktualisierungen nutzbar ist. > Die PNC Bank ließ einige Konten zwischen dem 18. August und dem 9. September 2025 ablaufen, bevor sie das einjährige rollierende Ablaufen aussetzte. Das zeitbasierte Ablaufen könnte wiederaufgenommen werden, wenn Banken ihre TAN-Richtlinien weiterentwickeln. Banken können zu TANs zeitbasierte Ablaufregeln hinzufügen. Wenn für TANs von einer Bank ein Ablaufdatum festgelegt wurde, können Sie Folgendes tun: 1. Überprüfen Sie das Feld `expected_expiry_date`. Es zeigt das Ablaufdatum an. 1. Überwachen Sie das Webhook-Ereignis `financial_connections.account.upcoming_account_number_expiry`, das Stripe 30 Tage vor Ablauf der TAN sendet. ## Deaktivierte TANs verwalten In diesem Leitfaden wird beschrieben, wie Sie die Deaktivierung von TANs in folgenden Fällen handhaben: - ACH-Lastschriftzahlungen - Externe Bankkonten, die für Auszahlungen verwendet werden > Falls Sie dies noch nicht getan haben, müssen Sie einen Webhook-Endpoint einrichten (verwenden Sie dazu die Seite [Webhooks](https://dashboard.stripe.com/webhooks) im Dashboard oder befolgen Sie die [Anleitung zu Webhooks](https://docs.stripe.com/webhooks/quickstart.md)), um die für Ihre Integration relevanten [Ereignisse](https://docs.stripe.com/financial-connections/webhooks.md) zu überwachen. ### ACH-Lastschriftzahlungen ACH Direct Debit [PaymentMethods](https://docs.stripe.com/api/payment_methods.md) werden bei Deaktivierung der zum Konto gehörenden TAN unbrauchbar. Bearbeiten Sie TAN-Deaktivierungen in Ihrer ACH Direct Debit-Integration, um fehlgeschlagene Zahlungen zu vermeiden. Wenn ein Bankkonto mit einer für eine ACH Direct Debit PaymentMethod verwendeten TAN deaktiviert wird, sendet Stripe das Ereignis [payment_method.automatically_updated](https://docs.stripe.com/api/events/types.md#event_types-payment_method.automatically_updated). Um PaymentMethods mit deaktivierten TANs in Ihrem Webhook-Handler zu identifizieren, überprüfen Sie, ob das Feld `payment_method.us_bank_account.status_details.blocked.reason` der PaymentMethod auf `tokenized_account_number_deactivated` gesetzt ist. Wenn Sie versuchen, eine Zahlung per ACH Direct Debit mit einer deaktivierten TAN zu bestätigen, gibt Stripe eventuell die Fehlermeldung `bank_account_unusable` zurück. Wenn dieser Fehler auftritt, während Ihre Kundin oder Ihr Kunde in der Sitzung ist, müssen Sie eine neue Zahlungsmethode erfassen. Wenn Stripe erwartet, dass die Transaktion aufgrund einer deaktivierten TAN fehlschlägt, versucht es anders als bei einer ACH-Rückgabe, die Zahlung vor dem Übermitteln der ACH-Transaktion an das Netzwerk zu blockieren. Die Zahlung schlägt also bereits zum Zahlungszeitpunkt fehl und nicht erst 2 bis 3 Tage später. Dadurch vermeiden Sie Gebühren für fehlgeschlagene Zahlungen. > #### Vermeiden Sie die Verarbeitung deaktivierter TANs > > ACH-Zahlungen, die mit der deaktivierten TAN außerhalb von Stripe abgewickelt werden, schlagen ebenfalls fehl, aber Ihr Abwickler lehnt die Zahlung zum Zeitpunkt der Übermittlung eventuell nicht ab. Um nachgelagerte Fehler zu vermeiden, sollten Sie keine Zahlungen mit deaktivierten TANs übermitteln. Um sicherzustellen, dass zukünftige Zahlungen erfolgreich sind, erfassen Sie das Bankkonto erneut oder erfassen Sie ein neues Bankkonto Ihrer Kundin oder Ihres Kunden und erstellen Sie eine neue PaymentMethod. ### Externe Bankkonten [Externe Bankkonten](https://docs.stripe.com/api/external_account_bank_accounts/object.md), die mit Financial Connections verknüpft wurden, werden durch das Deaktivieren einer TAN unbrauchbar. Bearbeiten Sie TAN-Deaktivierungen in Ihrer Auszahlungsintegration, um fehlgeschlagene Auszahlungen zu vermeiden. Wenn ein Bankkonto mit einer TAN für ein externes Bankkonto deaktiviert wird, sendet Stripe das Webhook-Ereignis [account.external_account.updated](https://docs.stripe.com/api/events/types.md#event_types-account.external_account.updated). Um festzustellen, ob Stripe das Ereignis `account.external_account.updated` aufgrund einer deaktivierten TAN gesendet hat, überprüfen Sie in Ihrem Webhook Handler, ob das Feld `status` für den Status des externen Bankkontos auf `"tokenized_account_number_deactivated"` festgelegt ist. Um sicherzustellen, dass zukünftige Auszahlungen erfolgreich sind, erfassen Sie das Bankkonto erneut oder erfassen Sie ein neues Bankkonto Ihrer Kundin oder Ihres Kunden und erstellen Sie ein neues externes Bankkonto. ## TAN-Details nach Banken Die folgenden Institutionen geben TANs zurück, wenn Ihre Kundinnen und Kunden Konten über Financial Connections verknüpfen: | Name des Instituts | Details | Datum des Inkrafttretens | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | Chase | Kundinnen und Kunden können den Zugriff auf das TAN-Konto über das Chase Security Center widerrufen. | Alle Konten | | PNC Bank | Kundinnen und Kunden können den Zugriff auf die TAN über das PNC-Online-Banking-Portal widerrufen. Die PNC hat vorübergehend eine zeitbasierte Ablaufrichtlinie eingeführt, die TANs deaktiviert, die nach dem 18. August 2024 und vor dem 9. September 2024 ausgestellt wurden. Es ist denkbar, dass die PNC zukünftig erneut eine zeitbasierte Ablaufrichtlinie für TANs einführt. | Konten, die nach dem 18. August 2024 verknüpft wurden | | US Bank | TANs der US Bank verfallen nicht und können von Kundinnen und Kunden nicht widerrufen werden. | Einführung auf rollierender Basis für einige Konten zwischen dem 30. November 2025 und dem 31. März 2026 | > #### Verzögerte Aktivierung von tokenisierten Kontonummern > > Die Aktivierung von tokenisierten Kontonummern von US Bank und PNC kann nach der Ausstellung bis zu 45 Minuten dauern und Banken können sofort eingereichte Zahlungen ablehnen. Wenn Sie ACH-Zahlungen mit Stripe verarbeiten, kümmern wir uns automatisch um die verzögerte Aktivierung. Wenn Sie ACH-Zahlungen außerhalb von Stripe verarbeiten, warten Sie bitte 90 Minuten nach der Ausstellung, bevor Sie ACH-Überweisungen einreichen. ## See also - [TAN-Verhalten prüfen](https://docs.stripe.com/financial-connections/testing.md#simulating-tokenized-account-number-behavior)