# 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](https://docs.stripe.com/api/financial_connections/accounts.md?api-version=2025-11-17.clover) die Eigenschaft [account_numbers](https://docs.stripe.com/api/financial_connections/accounts/object.md?api-version=2025-11-17.clover#financial_connections_account_object-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](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-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](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-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](https://docs.stripe.com/api/payment_methods/object.md?api-version=2025-11-17.clover#payment_method_object-us_bank_account-status_details-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](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-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](https://docs.stripe.com/api/external_account_bank_accounts/object.md?api-version=2025-11-17.clover#account_bank_account_object-status) hinzu.

You can listen for the [account.external_account.updated](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-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](https://docs.stripe.com/financial-connections.md) 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

#### REST API

| Values                                                                                                                  | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tokenized_account_number_deactivated`                                                                                  | Added  | [ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-payment_method_preview-us_bank_account-status_details-blocked-reason), [PaymentMethod.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-us_bank_account-status_details-blocked-reason)                                    |
| `financial_connections.account.account_numbers_updated`, `financial_connections.account.upcoming_account_number_expiry` | Added  | [Event](/api/events/object?api-version=2025-11-17.clover#event_object-type), [FinancialConnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), [WebhookEndpoint#update](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), [WebhookEndpoint#create](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), `FinancialConnections.Account` |

#### Ruby

| Parameter         | Change | Resources or methods                                                                                      |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| `account_numbers` | Added  | [FinancialConnections::Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover) |

#### Python

| Values                                                                                                                  | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tokenized_account_number_deactivated`                                                                                  | Added  | [ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-payment_method_preview-us_bank_account-status_details-blocked-reason), [PaymentMethod.UsBankAccount.StatusDetail.Blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-us_bank_account-status_details-blocked-reason)                                                         |
| `financial_connections.account.account_numbers_updated`, `financial_connections.account.upcoming_account_number_expiry` | Added  | [Event](/api/events/object?api-version=2025-11-17.clover#event_object-type), [FinancialConnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), [WebhookEndpointModifyParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), [WebhookEndpointCreateParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), `financial_connections.Account` |

#### PHP

| Values                                                                                                                  | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tokenized_account_number_deactivated`                                                                                  | Added  | [ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-payment_method_preview-us_bank_account-status_details-blocked-reason), [PaymentMethod.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-us_bank_account-status_details-blocked-reason) |
| `financial_connections.account.account_numbers_updated`, `financial_connections.account.upcoming_account_number_expiry` | Added  | [Event](/api/events/object?api-version=2025-11-17.clover#event_object-type), [FinancialConnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), `FinancialConnections.Account`                                                                                                                                                                                                                          |

#### Java

| Parameter        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `accountNumbers` | Added  | [financialconnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), [WebhookEndpointUpdateParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabledEvents), [WebhookEndpointCreateParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabledEvents), `financialconnections.Account` |

#### Node.js

| Values                                                                                                                  | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tokenized_account_number_deactivated`                                                                                  | Added  | [ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-payment_method_preview-us_bank_account-status_details-blocked-reason), [PaymentMethod.us_bank_account.status_details.blocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-us_bank_account-status_details-blocked-reason)                                              |
| `financial_connections.account.account_numbers_updated`, `financial_connections.account.upcoming_account_number_expiry` | Added  | [Event](/api/events/object?api-version=2025-11-17.clover#event_object-type), [FinancialConnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), [WebhookEndpointUpdateParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), [WebhookEndpointCreateParams](/api/webhook_endpoints/update?api-version=2025-11-17.clover#update_webhook_endpoint-enabled_events), `FinancialConnections.Account` |

#### Gehen Sie zu

| Values                                                                                                                  | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tokenized_account_number_deactivated`                                                                                  | Added  | [ConfirmationTokenPaymentMethodPreviewUsBankAccountStatusDetailsBlocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-payment_method_preview-us_bank_account-status_details-blocked-Reason), [PaymentMethodUsBankAccountStatusDetailsBlocked](/api/confirmation_tokens/object?api-version=2025-11-17.clover#confirmation_token_object-us_bank_account-status_details-blocked-Reason) |
| `financial_connections.account.account_numbers_updated`, `financial_connections.account.upcoming_account_number_expiry` | Added  | [Event](/api/events/object?api-version=2025-11-17.clover#event_object-Type), [FinancialConnectionsAccount](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), `FinancialConnectionsAccount`                                                                                                                                                                                                             |

#### .NET

| Parameter        | Change | Resources or methods                                                                                                                     |
| ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `AccountNumbers` | Added  | [FinancialConnections.Account](/api/financial_connections/accounts/object?api-version=2025-11-17.clover), `FinancialConnections.Account` |

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. 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](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-11-17.clover`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf [v17.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf [v13.2.0](https://github.com/stripe/stripe-python/releases/tag/v13.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf [v18.2.0](https://github.com/stripe/stripe-php/releases/tag/v18.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf [v30.2.0](https://github.com/stripe/stripe-java/releases/tag/v30.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf [v19.3.0](https://github.com/stripe/stripe-node/releases/tag/v19.3.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf [v83.2.0](https://github.com/stripe/stripe-go/releases/tag/v83.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf [v49.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.2.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).