ACH NOC および SEC の取り扱い
外部口座情報の更新方法をご紹介します。
When you originate an ACH transaction with Stripe (for example, using InboundTransfer
, OutboundTransfer
, or OutboundPayment
objects with Financial Accounts for platforms), the financial institution receiving the transaction might return a Notification of Change (NOC). This is a message indicating that new information is available about the destination account (such as a new account number or routing number).
ACH ネットワークのルールでは、Stripe は NOC の受信時に、保存されているアカウント情報を更新する必要があります。Stripe は、関連するPaymentMethod
オブジェクトまたはBankAccount
オブジェクトを更新して NOC を自動的に処理し、Webhook で通知します。これらの Webhook を監視して、アカウント情報が変更されたことをユーザーに通知したり、Stripe の外部で保持しているアカウント情報を更新したりすることができます。
NOC タイプ | 更新されるフィールド |
---|---|
口座番号 | account_ 、last4 、フィンガープリント |
金融番号 | routing_ 、フィンガープリント |
口座の用途 (当座預金や普通預金など) | account_ 、フィンガープリント |
決済手段の詳細が (destination_
を使用して) インラインで提供されるOutboundPayment
オブジェクトに対して NOC は処理されません。この場合には、保持されている更新対象のPaymentMethod
オブジェクトまたはBankAccount
オブジェクトがないためです。
PaymentMethod に対する NOC
PaymentMethod
オブジェクトで開始された取引に対して NOC を受信した場合、以下のようになります。
- Stripe は
PaymentMethod
を更新してpayment_
Webhook をトリガーします。method. updated PaymentMethod
がCustomer
(OutboundPayment
オブジェクトで使用するために) に関連付けられている場合、Stripe はcustomer.
Webhook をトリガーします。source. updated PaymentMethod
が (InboundTransfer
オブジェクトまたはOutboundTransfer
オブジェクトで使用するために) Stripe アカウントに直接関連付けられている場合、Stripe はaccount.
Webhook をトリガーします。external_ account. updated
BankAccount に対する NOC
BankAccount
オブジェクトで開始された取引に対して NOC を受信した場合、以下のようになります。
- Stripe は
BankAccount
オブジェクトを更新します。 BankAccount
が (OutboundPayment
オブジェクトで使用するために)Customer
に関連付けられている場合、Stripe はcustomer.
Webhook をトリガーします。source. updated BankAccount
が (InboundTransfer
オブジェクトまたはOutboundTransfer
オブジェクトで使用するために) Stripe アカウントに直接関連付けられている場合、Stripe はaccount.
Webhook をトリガーします。external_ account. updated
プラットフォームの主要外部口座として設定されているBankAccount
が更新された場合、Stripe はメールでも通知を行います。連結アカウントの Stripe アカウントに関連付けられている外部口座の更新、またはCustomer
オブジェクトに関連付けられている外部口座の更新の場合には、メールは送信されません。
標準 SEC の取り扱い
各 ACH 取引には、関連するアカウントおよび取引が認可された経緯を示す、関連付けられた Standard Entry Class (SEC) コードがあります。
Financial Accounts for platforms determines the SEC code based on whether the account receiving the ACH entry is owned by a company or an individual. You specify the account holder type in destination_payment_method_data.us_bank_account.account_holder_type when:
- You make OutboundPayments
- You set up a stored PaymentMethod
Only send InboundTransfers and OutboundTransfers to accounts owned by the FinancialAccount owner and with a company
owner type.
SEC コードは、受け取り口座の所有者種別に基づいて次のように決定されます。
資金移動 | 所有者タイプ | SEC コード |
---|---|---|
InboundTransfer | company | CCD |
OutboundTransfer | company | CCD |
OutboundPayment | company | CCD |
OutboundPayment | individual | PPD |