Umgang mit ACH-NOC und SEC
Erfahren Sie, wie externe Kontoinformationen aktualisiert werden.
Wenn Sie eine ACH-Transaktion mit Stripe durchführen (z. B. mit InboundTransfer-, OutboundTransfer- oder OutboundPayment- Objekten mit Finanzkonten für Plattformen) kann das Finanzinstitut, das die Transaktion erhält, eine Änderungsbenachrichtigung (Notification of Change, NOC) zurückgeben. Dies ist eine Meldung, die darauf hinweist, dass neue Informationen über das Zielkonto verfügbar sind (z. B. eine neue Kontonummer oder Routingnummer).
ACH network rules require Stripe to update saved account information when we receive an NOC. We automatically process the NOC by updating the relevant PaymentMethod or BankAccount object and notify you through a webhook. You might want to monitor these webhooks to inform your users that account information has changed or to update account information that you’ve persisted outside of Stripe.
| NOC-Typ | Felder aktualisiert |
|---|---|
| Kontonummer | account_, last4, Fingerabdruck |
| Routingnummer | routing_, Fingerabdruck |
| Kontonutzung (zum Beispiel Giro- oder Sparkonten) | account_, Fingerabdruck |
NOCs werden nicht für OutboundPayment-Objekte verarbeitet, bei denen Details zur Zahlungsmethode inline (mithilfe von destination_) angegeben werden, da in diesem Fall kein dauerhaftes PaymentMethod- oder `BankAccount``-Objekt vorhanden ist.
NOC für eine PaymentMethod
Wenn wir eine NOC für eine Transaktion erhalten, die von einem PaymentMethod -Objekt stammt:
- Stripe aktualisiert die
PaymentMethodund löst denWebhook payment_aus.method. updated - Wenn die
PaymentMethodan einenKundenangehängt ist (zur Verwendung mitOutboundPayment-Objekten), löst Stripe den Webhookcustomer.aus.source. updated - Wenn die
PaymentMethoddirekt mit einem Stripe-Konto verknüpft ist (zur Verwendung mitInboundTransfer- oderOutboundTransfer-Objekten), löst Stripe den Webhookaccount.aus.external_ account. updated
NOC für ein BankAccount
Wenn wir eine NOC für eine Transaktion erhalten, die von einem BankAccount-Objekt stammt:
- Stripe aktualisiert das
BankAccount-Objekt. - Wenn das
BankAccountan einenKundenangehängt ist (zur Verwendung mitOutboundPayment-Objekten), löst Stripe den Webhookcustomer.aus.source. updated - Wenn das
BankAccountdirekt mit einem Stripe-Konto verknüpft ist (zur Verwendung mitInboundTransfer- oderOutboundTransfer-Objekten), löst Stripe den Webhookaccount.aus.external_ account. updated
In Fällen, in denen das BankAccount, das als primäres externes Konto Ihrer Plattform eingerichtet ist, aktualisiert wird, benachrichtigt Stripe Sie auch per E-Mail. Wir senden keine E-Mails zu Updates an externe Konten, die mit den Stripe-Konten Ihrer verbundenen Konten verknüpft sind, oder zu Updates für externe Konten, die mit Kunden-Objekten verknüpft sind.
Standard SEC-Behandlung
Jede ACH-Transaktion hat einen zugehörigen Standard-Eingabecode (Standard Entry Class Code, SEC), der Informationen dazu liefert, welche Konten an der Transaktion beteiligt sind und wie diese autorisiert wurde.
Die Lösung Finanzkonten für Plattformen bestimmt den SEC-Code, je nachdem, ob das Konto, das die ACH-Buchung erhält, einem Unternehmen oder einer Einzelperson gehört. Sie geben den Kontoinhabertyp in destination_payment_method_data.us_bank_account.account_holder_type, wenn:
- Sie führen OutboundPayments durch
- Sie richten eine gespeicherte PaymentMethod ein
Senden Sie InboundTransfers und OutboundTransfers nur an Konten, die dem/der Inhaber/in des FinancialAccount gehören und die den Typ Unternehmen haben.
Die SEC-Codes werden basierend auf dem Inhabertyp des Empfängerkontos wie folgt bestimmt:
| Geldbewegungen | Inhabertyp | SEC-Code |
|---|---|---|
| InboundTransfer | Unternehmen | CCD |
| OutboundTransfer | Unternehmen | CCD |
| OutboundPayment | Unternehmen | CCD |
| OutboundPayment | Einzelperson | PPD |