ACH NOC および SEC の取り扱い

Stripe で ACH 取引をオリジネートする場合 (例えば、InboundTransfer、OutboundTransfer、OutboundPayment オブジェクトと Financial Accounts for platforms を使用する場合)、トランザクションを受け取る金融機関から NOC (Notification of Change) が返されることがあります。これは、宛先口座に関する新しい情報 (新しい口座番号や金融番号など) が利用可能であることを示すメッセージです。

ACH ネットワークのルールでは、Stripe は NOC の受信時に、保存されているアカウント情報を更新する必要があります。Stripe は、関連するPaymentMethodオブジェクトまたはBankAccountオブジェクトを更新して NOC を自動的に処理し、Webhook で通知します。これらの Webhook を監視して、アカウント情報が変更されたことをユーザーに通知したり、Stripe の外部で保持しているアカウント情報を更新したりすることができます。

決済手段の詳細が (destination_payment_method_dataを使用して) インラインで提供されるOutboundPaymentオブジェクトに対して NOC は処理されません。この場合には、保持されている更新対象のPaymentMethodオブジェクトまたはBankAccountオブジェクトがないためです。

PaymentMethod に対する NOC

PaymentMethodオブジェクトで開始された取引に対して NOC を受信した場合、以下のようになります。

• Stripe はPaymentMethodを更新してpayment_method.updated Webhook をトリガーします。
• PaymentMethodがCustomer (OutboundPaymentオブジェクトで使用するために) に関連付けられている場合、Stripe はcustomer.source.updated Webhook をトリガーします。
• PaymentMethodが (InboundTransferオブジェクトまたはOutboundTransferオブジェクトで使用するために) Stripe アカウントに直接関連付けられている場合、Stripe はaccount.external_account.updated Webhook をトリガーします。

BankAccount に対する NOC

BankAccountオブジェクトで開始された取引に対して NOC を受信した場合、以下のようになります。

• Stripe はBankAccountオブジェクトを更新します。
• BankAccountが (OutboundPaymentオブジェクトで使用するために) Customerに関連付けられている場合、Stripe はcustomer.source.updated Webhook をトリガーします。
• BankAccountが (InboundTransferオブジェクトまたはOutboundTransferオブジェクトで使用するために) Stripe アカウントに直接関連付けられている場合、Stripe はaccount.external_account.updated Webhook をトリガーします。

プラットフォームの主要外部口座として設定されているBankAccountが更新された場合、Stripe はメールでも通知を行います。連結アカウントの Stripe アカウントに関連付けられている外部口座の更新、またはCustomerオブジェクトに関連付けられている外部口座の更新の場合には、メールは送信されません。

標準 SEC の取り扱い

各 ACH 取引には、関連するアカウントおよび取引が認可された経緯を示す、関連付けられた Standard Entry Class (SEC) コードがあります。

プラットフォーム向け金融口座は、ACH エントリを受け取る口座が会社所有か個人所有かに基づいて SEC コードを決定します。口座所有者のタイプは、destination_payment_method_data.us_bank_account.account_holder_type で指定します。

• OutboundPayments を行う場合
• 保存された PaymentMethod を設定する場合

InboundTransfers および OutboundTransfers のみを、FinancialAccount 所有者が所有し、company 所有者タイプを持つ口座に送信します。

SEC コードは、受け取り口座の所有者種別に基づいて次のように決定されます。