Gestion des notifications de modification ACH
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_number , last4 , fingerprint |
Numéro de routage | routing_number , fingerprint |
Catégorie de compte (par exemple, compte courant ou compte d’épargne) | account_type , 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_payment_method_data
), 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 marchands, ni pour les mises à jour des comptes externes associés à des objets Customer
.