ACH NOC および SEC の取り扱い
外部口座情報の更新方法をご紹介します。
(たとえば、InboundTransfer
、OutboundTransfer
、またはOutboundPayment
オブジェクトを Treasury で使用して) Stripe で ACH 取引を開始すると、取引を受け取る金融機関から変更通知 (NOC) が返される場合があります。これは、送金先口座に関する新しい情報 (新しい口座番号や金融番号など) が利用可能になったことを示すメッセージです。
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) コードがあります。
Stripe Treasury は、ACH エントリを受け取る口座の所有者が会社か個人かに基づいて SEC コードを決定します。口座所有者のタイプは、destination_payment_method_data.us_bank_account.account_holder_typeで指定します。
- OutboundPaymentsを行う場合
- 保存された PaymentMethodを設定する場合
InboundTransfersおよびOutboundTransfersのみを、FinancialAccount 所有者が所有し、company
所有者タイプを持つ口座に送信します。
SEC コードは、受け取り口座の所有者種別に基づいて次のように決定されます。
資金移動 | 所有者タイプ | SEC コード |
---|---|---|
InboundTransfer | company | CCD |
OutboundTransfer | company | CCD |
OutboundPayment | company | CCD |
OutboundPayment | individual | PPD |