トークン化された銀行アカウント番号の処理のサポートを追加する
新機能
API を使用してトークン化された銀行口座番号 (TAN) を管理する方法を追加します。TAN は、実際のアカウント番号の代わりに金融機関が発行する一時的な銀行口座の認証情報であり、有効な間は ACH 支払いと入金に使用できます。TAN が無効になるか、有効期限が切れたり、取り消されたりすると、その銀行口座を使用した以降の送金は失敗します。
Financial Connections
トークン化された銀行口座番号に関する情報を提供する account_numbers プロパティを Financial Connections アカウントに追加します。これには、アカウント番号の有効期限と、アカウントがトークン化されたアカウント番号 (TAN) を使用するかどうかの詳細が含まれます。
また、アカウント番号の変更に関する情報を把握しやすくするために、2 つの新しいイベントが導入されました。
- financial_connections.account.account_numbers_up: Financial Connections アカウントの口座番号情報が変更されたときにこのイベントが送信されます。
- financial_connections.account.upcoming_account_number_expiry: このイベントは、トークン化された口座番号の有効期限が近づいたときに送信されます。
決済とトップアップ
payment_method_us_bank_account_blocked.reason プロパティに、新しい列挙値 tokenized_ を追加します。銀行口座が、パートナー銀行によってトークン化された口座番号 (TAN) が無効化されたためにブロックされた場合、blocked_ プロパティによって、その銀行口座が支払い方法として使用できなくなった理由を把握できるように、特定の情報が表示されるようになりました。
この銀行口座が支払い方法としてブロックされた場合に通知されるpayment_method.automatically_updatedイベントをリッスンできます。
入金
新しい値 tokenized_ を bank_account.status に追加します。
account.external_account.updated イベントをリッスンして、外部の銀行口座のステータスが tokenized_ に変わったときに通知を受け取ることができます。
影響
Financial Connections を介して連結された銀行口座がトークン化された口座番号を使用するタイミングを特定し、そのステータスを把握できるようになりました。これにより、トークン化された口座番号が無効になったときに発生する支払いと入金の失敗を事前に管理できます。
連携で Financial Connections アカウントを使用して ACH 決済または Payouts を処理している場合は、トークン化された番号の有効期限が切れる前にこの情報を使用して顧客にアカウントを再連結するように促すことで、取引の失敗や関連手数料を回避できます。
イベントを使用すると、アカウント番号情報が変更されたとき、または有効期限が近づいたときに、顧客に通知したり、システムを更新したりする自動化ワークフローを構築できます。