Traitement des NOC pour l’ACH et des codes SEC
Apprenez comment les informations des comptes externes sont mises à jour.
Lorsque vous initiez une transaction ACH avec Stripe (en utilisant par exemple des objets InboundTransfer, OutboundTransfer, ou OutboundPayment avec Financial Accounts pour les plateformes), l’institution financière qui reçoit la transaction peut renvoyer une notification de changement (NOC). Il s’agit d’un message indiquant que de nouvelles informations sont disponibles concernant le compte de destination (comme un nouveau numéro de compte ou numéro de routage).
Conformément aux règles du réseau ACH, Stripe est tenu de mettre à jour les informations de compte enregistrées lorsqu’il reçoit une NOC. Nous traitons automatiquement la NOC en mettant à jour l’objetPaymentMethod ouBankAccount 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 les 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 dont les informations de moyen de paiement sont fournies en ligne via destination_ car il n’existe pas d’objet PaymentMethod ou BankAccountenregistré.
NOC pour un PaymentMethod
Lorsque nous recevons une NOC provenant d’une transaction avec un objetPaymentMethod :
- Stripe met à jour le
PaymentMethodet déclenche un webhookpayment_.method. updated - Si le
PaymentMethodest associé à unCustomer(dans le cadre de l’utilisation d’objetsOutboundPayment), Stripe déclenche un webhookcustomer..source. updated - Si le
PaymentMethodest directement associé à un compte Stripe (dans le cadre de l’utilisation d’objetsInboundTransferouOutboundTransfer), Stripe déclenche un webhookaccount..external_ account. updated
NOC pour un BankAccount
En cas de réception d’une NOC pour une transaction provenant d’un objet BankAccount :
- Stripe met à jour l’objet
BankAccount. - Si le
BankAccountest associé à unCustomer(dans le cadre de l’utilisation d’objetsOutboundPayment), Stripe déclenche un webhookcustomer..source. updated - Si le
BankAccountest directement associé à un compte Stripe(dans le cadre de l’utilisation d’objetsInboundTransferouOutboundTransfer), Stripe déclenche un webhookaccount..external_ account. updated
Lorsqu’unBankAccount configuré comme compte externe principal de votre plateforme est mis à jour, Stripe vous en informe également par e-mail. Nous n’envoyons pas d’e-mail pour les mises à jour de comptes externes associés aux comptes Stripe de vos comptes connectés, ni pour les mises à jour de comptes externes associés aux objets Customer.
Traitement standard SEC
Chaque transaction ACH est associée à un code SEC (Standard Entry Class), qui décrit les comptes concernés et la façon dont la transaction a été autorisée.
Financial Accounts pour les plateformes établit le code SEC en fonction du fait que le compte recevant l’entrée ACH appartient à une entreprise ou à un particulier. Vous spécifiez le type de titulaire du compte dans destination_payment_method_data.us_bank_account.account_holder_type lorsque :
- Vous effectuez des OutboundPayments
- Vous configurez un PaymentMethod sauvegardé
N’envoyez des InboundTransfers et desOutboundTransfers qu’aux comptes dont le propriétaire est FinancialAccount et dont le type de propriétaire est une entreprise.
Les codes SEC sont déterminés en fonction du type de titulaire du compte bénéficiaire, comme suit :
| Transfert de fonds | Type de propriétaire | Code SEC |
|---|---|---|
| InboundTransfer | company | CCD |
| OutboundTransfer | company | CCD |
| OutboundPayment | company | CCD |
| OutboundPayment | individual | PPD |