連結アカウントの入金口座を管理する 連結アカウントの外部銀行口座とデビットカードを管理する方法をご紹介します アカウントのプロパティ 連結アカウントは、アカウントの動作を決定する
プロパティを使用して設定 できます。アカウントタイプを、対応するプロパティにマッピングできます。
このコンテンツは、連結アカウントがマイナス残高を返済できない場合にお客様が責任を負う連結アカウントに適用されます。これには Custom アカウントと Express アカウントが含まれます。
入金 口座には、銀行口座かデビットカードのいずれかを使用できます。Stripe では、Connect アカウント登録のウェブフォームで外部口座の詳細を収集することをお勧めしています。こうすることで、以下のように利用することができます。
設計と開発の時間を節約する。 口座番号や金融番号などの機密データをサーバーに保存する必要がなくなる。 ユーザーがアカウントの詳細を入力する際のフォーム検証を構築する必要がなくなる。 アメリカでは、ユーザーが金融口座をお客様のビジネスに安全に関連付けることができるため、Stripe Financial Connections の使用もお勧めしています。これには以下のようなメリットがあります。
アカウントが口座番号と金融番号を見つけるためにプロセスを中断する必要がないようにすることで、アカウント登録の完了率を高めます。 口座番号と金融番号の手動入力に起因するエラーを排除することで、初回入金の失敗率を低減します。 口座番号や金融番号などの機密データをサーバーに保存する必要がなくなる。 アカウントがカスタムのアカウント登録フォームにアカウントの詳細を入力する際に、フォーム検証を構築する必要がなくなります。 アカウントが Link に保存した銀行口座情報を再使用できるため、認証に必要な手順を少なくすることができます。Link を使用していずれかの Stripe ビジネスに口座情報を保存しているアカウントは、Financial Connections の次回使用時に口座情報を共有できます。 balances 、所有権データ 、取引 などのアカウントの外部銀行口座に関する追加情報にアクセスします。外部の銀行口座保有者の名前や住所などの情報を確認することで、アカウント登録時の不正を減らすことができます。Link を含めた場合は Financial Connections が無料になります。それ以外の場合は、使用時に手数料が発生します 。
また、連結アカウントに API によるアカウント登録を使用している場合は、アカウント登録フローのカスタムフォームを使用して入金口座の詳細を収集できます。
カスタムフォームからの Direct API コール
連結アカウントに対する Stripe のホスティング登録 では、Stripe がホストするウェブフォームを使用して、連結アカウントの登録に必要な情報を収集します。Stripe のホスティング登録では、銀行口座とデビットカードの両方を収集できます。Stripe のホスティング登録で Financial Connections を使用して、銀行口座の詳細を収集できます。ただし、Financial Connections を使用してデビットカードの詳細は収集できません。
Custom アカウントと Express アカウントを含め、マイナス残高を返金できない可能性のある連結アカウントを担当している場合、外部口座 設定で外部口座の収集フローをカスタマイズできます。独自のフォームから直接 API 呼び出しを使用している場合、これらの設定は適用されません。
外部口座 設定では、次のことができます。
デビットカードの使用を許可しますか? の下で選択して、デビットカードの収集を有効または無効にします。デビットカードなどの他の種類の外部口座を追加する前に、連結アカウントで少なくとも 1 件の銀行口座を追加する必要があることを要求します。この設定には、**1 件以上の銀行口座が必要ですか?**でアクセスできます。これは、自動引き落とし のサポートを確保するのに役立ちます。 連結アカウントが特定の通貨で複数の外部口座を追加するかどうかを制御します。通貨ごとに外部口座は 5 件までという制限があります。通通貨ごとに複数の外部口座を収集します で、この設定にアクセスできます。 Stripe Financial Connections を使用する
利用可能な国 アメリカの 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 を指定するようにしてください。
curl -G https://api.stripe.com/v1/financial_connections/accounts \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-H "Stripe-Account: " \
-d "account_holder[account]" =
これにより、以下のような 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
ヘッダーを必ず含めてください。
curl https://api.stripe.com/v1/financial_connections/accounts/fca_zbyrdjTrwcYZJZc6WBs6GPid/refresh \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-H "Stripe-Account: " \
-d "features[]" = balance