ACH の変更通知の処理

(たとえば、InboundTransfer オブジェクト、OutboundTransfer オブジェクト、OutboundPayment オブジェクトを Treasury で使用して) Stripe で ACH 取引を開始すると、取引を受け取る金融機関から変更通知 (NOC) が返される場合があります。これは、送金先口座に関する新しい情報 (新しい口座番号や金融番号など) が利用可能になったことを示すメッセージです。

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 が (OutboundPayment オブジェクトで使用するために) Customer に関連付けられている場合、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 オブジェクトに関連付けられている外部口座の更新の場合には、メールは送信されません。