Gestion des notifications de modification ACH
Pour comprendre comment sont mises à jour les informations des comptes externes.
Lorsque vous initiez une transaction ACH avec Stripe (par exemple, en utilisant des objets InboundTransfer
, OutboundTransfer
ou OutboundPayment
avec Treasury), l’institution financière qui reçoit la transaction peut renvoyer une notification de modification (NOC, Notification of Change). Celle-ci vise à avertir que de nouvelles informations sont disponibles concernant le compte de destination (par exemple, un nouveau numéro de compte ou de routage).
Conformément aux règles du réseau ACH, Stripe est tenu de mettre à jour les informations de compte enregistrées lorsque nous recevons une NOC. Nous traitons automatiquement la NOC en mettant à jour l’objet PaymentMethod
ou BankAccount
correspondant, puis nous vous en informons à l’aide d’un webhook. Vous pouvez surveiller ces webhooks pour avertir vos utilisateurs que des informations de compte ont été modifiées ou pour mettre à jour des informations de compte stockées en dehors de Stripe.
Type de NOC | Champs mis à jour |
---|---|
Numéro de compte | account_ , last4 , fingerprint |
Numéro de routage | routing_ , fingerprint |
Catégorie de compte (par exemple, compte courant ou compte d’épargne) | account_ , fingerprint |
Les NOC ne sont pas traitées pour les objets OutboundPayment
ayant des informations du moyen de paiement fournies en ligne (à l’aide de destination_
), car il n’y a pas d’objet PaymentMethod
ou BankAccount
persistant à mettre à jour.
NOC pour un PaymentMethod
En cas de réception d’une NOC pour une transaction créée à l’aide d’un objet PaymentMethod
:
- Stripe met à jour le
PaymentMethod
et déclenche un webhookpayment_
.method. updated - Si le
PaymentMethod
est associé à unCustomer
(en vue d’une utilisation avec des objetsOutboundPayment
), Stripe déclenche un webhookcustomer.
.source. updated - Si le
PaymentMethod
est directement associé à un compte Stripe (en vue d’une utilisation avec des objetsInboundTransfer
ouOutboundTransfer
), Stripe déclenche un webhookaccount.
.external_ account. updated
NOC pour un BankAccount
En cas de réception d’une NOC pour une transaction créée à l’aide d’un objet BankAccount
:
- Stripe met à jour l’objet
BankAccount
. - Si le
BankAccount
est associé à unCustomer
(en vue d’une utilisation avec des objetsOutboundPayment
), Stripe déclenche un webhookcustomer.
.source. updated - Si le
BankAccount
est directement associé à un compte Stripe (en vue d’une utilisation avec des objetsInboundTransfer
ouOutboundTransfer
), Stripe déclenche un webhookaccount.
.external_ account. updated
En cas de mise à jour du BankAccount
défini pour le compte externe principal de votre plateforme, Stripe vous en informe également par e-mail. Nous n’envoyons pas d’e-mails pour les mises à jour des comptes externes associés aux comptes Stripe de vos comptes connectés, ni pour les mises à jour des comptes externes associés à des objets Customer
.