# Ajout d’un service de support pour la gestion des numéros de compte bancaire tokenisés

## Nouveautés

Ajoute des moyens de vous aider à gérer les numéros de compte bancaire tokenisés (TAN) via l’API. Les TAN sont des identifiants de compte bancaire temporaires émis par des institutions financières au lieu de numéros de compte réels, et peuvent être utilisés pour les paiements et les virements ACH lorsqu’ils sont actifs. Lorsqu’un TAN est désactivé, par expiration ou révocation, les transferts ultérieurs utilisant le compte bancaire échouent.

### Financial Connections

Ajoute une propriété [account_numbers](https://docs.stripe.com/api/financial_connections/accounts/object.md?api-version=2025-11-17.clover#financial_connections_account_object-account_numbers) à [Financial Connections Account](https://docs.stripe.com/api/financial_connections/accounts.md?api-version=2025-11-17.clover) qui fournit des informations sur les numéros de compte bancaires tokenisés. Cela inclut des détails sur les dates d’expiration des numéros de compte et précise si un compte utilise un numéro de compte tokenisé (TAN).

Nous présentons également deux nouveaux événements pour vous aider à rester informé des changements de numéro de compte :

- [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) : nous envoyons cet événement lorsque les informations de numéro de compte d’un compte Financial Connections changent.
- [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) : nous envoyons cet événement lorsqu’un numéro de compte tokenisé approche de sa date expiration.

### Paiements et recharges

Ajoute une nouvelle valeur d’énumération `tokenized_account_number_deactivated` à la propriété [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). Lorsqu’un compte bancaire est bloqué, son numéro de compte tokenisé (TAN) est désactivé par la banque partenaire. La propriété `blocked_reason` fournit des informations spécifiques pour vous aider à comprendre pourquoi le compte bancaire ne peut plus être utilisé comme moyen de paiement.

Vous pouvez écouter l’événement [payment_method.automatically_updated](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-payment_method.automatically_updated) afin d’être averti lorsque ce compte en banque est bloqué en tant que moyen de paiement.

### Virements

Ajoute une nouvelle valeur `tokenized_account_number_deactivated` à [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).

Vous pouvez écouter l’événement [account.external_account.updated](https://docs.stripe.com/api/events/types.md?api-version=2025-11-17.clover#event_types-account.external_account.updated) afin d’être averti si un compte bancaire externe change d’état pour `tokenized_account_number_deactivated`.

## Impact

Vous pouvez désormais identifier lorsque les comptes bancaires connectés via [Financial Connections](https://docs.stripe.com/financial-connections.md) utilisent des numéros de compte tokenisés et comprennent leur état. Cela vous permet de gérer de manière proactive les échecs de paiement et de virement qui peuvent se produire lorsque les numéros de compte tokenisés sont désactivés.

Si votre intégration traite les paiements ACH ou les paiements à l’aide de comptes Financial Connections, vous pouvez utiliser ces informations pour inviter les clients à reconnecter leurs comptes avant l’expiration des numéros tokenisés, ce qui permet d’éviter les échecs de transactions et les frais associés.

Les nouveaux événements vous permettent de créer des flux de travail automatisés qui informent les clients ou mettent à jour vos systèmes lorsque les informations sur le numéro de compte changent ou lorsque l’expiration approche.

## Modifications

#### 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` |

#### Go

| 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` |

## Mise à niveau

#### API REST

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
   - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-11-17.clover`
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Ruby vers [v17.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Python

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Python vers [v13.2.0](https://github.com/stripe/stripe-python/releases/tag/v13.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK PHP vers [v18.2.0](https://github.com/stripe/stripe-php/releases/tag/v18.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Java

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Java vers [v30.2.0](https://github.com/stripe/stripe-java/releases/tag/v30.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Node vers [v19.3.0](https://github.com/stripe/stripe-node/releases/tag/v19.3.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Go

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Go vers [v83.2.0](https://github.com/stripe/stripe-go/releases/tag/v83.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK .NET vers [v49.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.2.0)
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).