Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compteConnectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
API et SDKAide
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Clover
    Basil
    Acacia
    Versions précédentes
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Essentials
SDK
API
Tests
CLI Stripe
Exemples de projets
Outils
Dashboard Stripe
Workbench
Dashboard des développeurs
Shell Stripe
Stripe pour Visual Studio Code
Fonctionnalités
Workflows
Destinations d'événements
Alertes d'intégrité de StripeChargements de fichiers
Solutions d'IA
Boîte à outils des agents
Modèle de protocole contextuelCréer des flux de facturation SaaS avec l’IA agentique
Sécurité et confidentialité
Sécurité
Robot d'exploration Web Stripebot
Confidentialité
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
États-Unis
Français (France)
AccueilRessources pour les développeursChangelogClover2025-11-17.clover

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 à Financial Connections Account 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 : 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 : 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. 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 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.

Vous pouvez écouter l’événement 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 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

valeursModifierénumérations
tokenized_account_number_deactivatedAjouté
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_expiryAjouté
EventFinancialConnections.AccountWebhookEndpoint#update
 + 2 de plus
WebhookEndpoint#createFinancialConnections.Account

Mise à niveau

  1. Consultez la version actuelle de votre API dans Workbench.
  2. 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 pour inclure la version Stripe : 2025-11-17.clover
  3. Mettez à niveau la version de l’API utilisée pour les endpoints de webhook.
  4. Testez votre intégration avec la nouvelle version.
  5. Si vous utilisez Connect, testez votre intégration Connect.
  6. Effectuez la mise à niveau dans Workbench. Vous pourrez revenir à la version précédente pendant 72 heures.

En savoir plus sur les mises à niveau de l’API Stripe.

Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc