連結アカウントの入金口座を管理する

連結アカウントの外部銀行口座とデビットカードを管理する方法をご紹介します。

入金口座には、銀行口座かデビットカードのいずれかを使用できます。Stripe では、Connect アカウント登録のウェブフォームで外部口座の詳細を収集することをお勧めしています。こうすることで、以下のように利用することができます。

設計と開発の時間を節約する。
口座番号や金融番号などの機密データをサーバーに保存する必要がなくなる。
ユーザーがアカウントの詳細を入力する際のフォーム検証を構築する必要がなくなる。

アメリカでは、ユーザーが金融口座をお客様のビジネスに安全に関連付けることができるため、Stripe Financial Connections の使用もお勧めしています。これには以下のようなメリットがあります。

アカウントが口座番号と金融番号を見つけるためにプロセスを中断する必要がないようにすることで、アカウント登録の完了率を高めます。
口座番号と金融番号の手動入力に起因するエラーを排除することで、初回入金の失敗率を低減します。
口座番号や金融番号などの機密データをサーバーに保存する必要がなくなる。
アカウントがカスタムのアカウント登録フォームにアカウントの詳細を入力する際に、フォーム検証を構築する必要がなくなります。
(Accounts v1 のみ) アカウントでは Link に保存した銀行口座情報を再使用できるため、認証に必要な手順を少なくすることができます。Link を使用していずれかの Stripe ビジネスに口座情報を保存しているアカウントは、Financial Connections の次回使用時に口座情報を共有できます。
balances、所有権データ、取引などのアカウントの外部銀行口座に関する追加情報にアクセスします。外部の銀行口座保有者の名前や住所などの情報を確認することで、アカウント登録時の不正を減らすことができます。

Link を含めた場合は Financial Connections が無料になります。それ以外の場合は、使用時に手数料が発生します。

また、連結アカウントに API によるアカウント登録を使用している場合は、アカウント登録フローのカスタムフォームを使用して入金口座の詳細を収集できます。

外部アカウント収集のオプトアウト

Custom アカウントなど、プラットフォームが要件収集を担当するアカウントの場合、アカウント登録時に外部アカウント情報を収集しないようにすることができます。これは、外部アカウント情報を収集する独自のアカウント登録フローを構築する場合などに実行できます。

In embedded onboarding, you can disable external account collection by setting the external_account_collection feature on the Account Session to false. Alternatively, in hosted onboarding you can go to your Connect external accounts settings and then under Accounts where the platform is responsible for collecting requirements enable or disable collecting external account information. Note that this is off by default.

外部アカウントを収集する

連結アカウントに対する Stripe のホスティング登録では、Stripe がホストするウェブフォームを使用して、連結アカウントの登録に必要な情報を収集します。Stripe のホスティング登録では、銀行口座とデビットカードの両方を収集できます。Stripe のホスティング登録で Financial Connections を使用して、銀行口座の詳細を収集できます。ただし、Financial Connections を使用してデビットカードの詳細は収集できません。

Custom アカウントと Express アカウントを含め、マイナス残高を返金できない可能性のある連結アカウントを担当している場合、外部口座設定で外部口座の収集フローをカスタマイズできます。独自のフォームからダイレクト API 呼び出しを使用している場合、これらの設定は適用されません。

外部口座設定では、次のことができます。

デビットカードの使用を許可しますか？ の下で選択して、デビットカードの収集を有効または無効にします。
デビットカードなどの他の種類の外部口座を追加する前に、連結アカウントで少なくとも 1 件の銀行口座を追加する必要があることを要求します。この設定には、**1 件以上の銀行口座が必要ですか？**でアクセスできます。これは、自動引き落としのサポートを確保するのに役立ちます。
連結アカウントが特定の通貨で複数の外部口座を追加するかどうかを制御します。通貨ごとに外部口座は 5 件までという制限があります。通通貨ごとに複数の外部口座を収集しますで、この設定にアクセスできます。

利用可能な国

アメリカ

アメリカの Stripe プラットフォームは、Stripe のホスティング登録内で以下の手順に従って Stripe Financial Connections を有効にできます。

外部口座設定に移動します。ここで、オプションの Connect アカウント登録機能を管理できます。
Custom アカウントを含め、要件が変更された場合にプラットフォームがアカウント情報を収集する連結アカウントは、Stripe のホスティング登録で外部口座詳細を収集できるようにする必要があります。Custom アカウントの Stripe ホスティング登録 で、トグルをオンにして Stripe が外部口座情報を収集できるようにします。
銀行口座情報をどのように収集しますか？ で、Financial Connections を選択します。
(任意) 残高、所有権の詳細、取引など、Financial Connections で即座に確認された口座に関する追加データにアクセスするための権限をリクエストします。この追加情報をリクエストすることを選択すると、Stripe Financial Connections に登録するように求められます。

外部の口座の詳細の収集が有効になると、連結アカウントのすべてに、アカウント登録フォームに埋め込まれ、Stripe がホストするモーダル UI を使用して、銀行口座の認証を行うことが求められます。

Stripe Financial Connections を使用して入金口座を収集する Connect アカウント登録フロー。

連結アカウントが Financial Connections を使用して銀行口座をすぐには確認できない場合、確認プロセスは自動的に手動入力に戻ります。

Stripe Financial Connections モーダルを使用して手動入力で入金口座を収集する Connect アカウント登録フロー。

アカウント登録後、指定した銀行口座が連結アカウントに自動的に関連付けられます。

Financial Connections アカウントに関するデータを取得するサーバー側

連結アカウントの ID を使用して、リンクされている Financial Connections アカウントを取得することで、ユーザーが Financial Connections アカウントを関連付けているかどうかを判断できます。Stripe-Account ヘッダーでアカウント ID を指定するようにしてください。

これにより、以下のような API レスポンスが返されます。

{
  "object": "list",
  "data": [
    {
      "id": "fca_zbyrdjTrwcYZJZc6WBs6GPid",
      "object": "financial_connections.account",
      "account_holder": {
        "account": "{{CONNECTED_ACCOUNT_ID}}"
,
        "type": "account"
      },
      ...
      "supported_payment_method_types": [
        "us_bank_account"
      ]
    }
    ...
  ]
}

Financial Connectionsアカウントが表示された場合は、アカウント登録プロセスで、連結アカウントがそれらのアカウントを関連付けたことを示します。 id 値を使用すると、外部口座設定で指定したデータへのアクセスや、データの更新を行うことができます。連結アカウントのデータのプライバシーを保護するため、アクセスできるのは指定したデータのみです。

口座データの取得を開始するには、残高、所有権、取引のガイドに従ってください。後続のすべての口座の取得リクエストと更新リクエストには、連結アカウントの ID を指定した Stripe-Account ヘッダーを必ず含めてください。

連結アカウントに外部アカウントの更新を許可する

連結アカウントが外部アカウント(銀行口座またはデビットカード)を更新しようとする場合、通常は既存の外部アカウントの詳細を提供するか、本人確認を行う必要があります。ただし、一部のアカウント、特に非営利団体や特定のコンプライアンスプランのアカウントでは、これらの対応(既存口座情報の提供や本人確認)を行えない場合があります。たとえば、既存の外部アカウントが以前のアカウント所有者のものであったり、Stripe がオンボーディング時に特定の本人確認情報(生年月日など)を収集していなかったりします。

プラットフォームがマイナス残高に対する責任を負う場合は、連結アカウントが本人確認を行わずに外部アカウントを更新できるようにする一意のコードを生成できます。この機能は本番環境でのみ使用できます。

外部アカウントの更新コードは、プラットフォームがマイナス残高に対する責任を負う場合にのみ生成できます。ただし、Stripe ダッシュボードの全機能にアクセスできるアカウントは対象外です。プラットフォームがマイナス残高に対する責任を負わない場合、外部アカウントの更新を希望する連結アカウントは、標準の本人確認を完了するか、Stripe サポートにお問い合わせください。

仕組み

通常、連結アカウントが Express ダッシュボードで外部アカウントを更新しようとすると、Stripe は既存の外部アカウント情報を入力するか、本人確認を行うように求めます。ただし、連結アカウントの外部アカウント更新コードを生成すると、Stripe は代わりにコードの入力を求めます。

コードの有効期間は 7 日間です。連結アカウントが外部アカウントを更新する前にコードの有効期限が切れた場合は、別のコードを生成できます。

外部アカウントの更新コードを生成

連結アカウントの更新コードを生成すると、誤った外部アカウントの変更に起因するいかなるエラーについても、プラットフォームが単独で法的および財務上の責任を全面的に負います。コードを生成する前に、変更をリクエストする人物の本人確認を行ってください。補足情報を含めて、変更リクエストを文書化してください。

コードを生成するには、次の手順に従います。

プラットフォームダッシュボードで、連結アカウントページに移動します。
外部アカウントを更新する必要がある連結アカウントを選択します。
アカウント所有者の情報が正しく、変更リクエストの情報と一致していることを確認します。
入金情報セクションで、外部アカウントの横にあるオーバーフローメニュー()を開き、更新コードを生成をクリックします。
アカウント所有者の情報を確認し、責任を受け入れます。
送信をクリックして、連結アカウントの所有者に更新コードをメールで送信します。