Standard 連結アカウントで Connect を利用

Create Account API を使用し、type を standard に設定して連結アカウントを作成します。任意の情報を事前入力できますが、少なくとも type を指定する必要があります。アカウントの国は、デフォルトでプラットフォームと同じ国が設定され、アカウントはアカウント登録中に選択を確定します。アカウントに必要なケイパビリティを把握している場合は、アカウントの作成時にそれをリクエストできます。

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=standard

事前入力情報 オプション

連結アカウントの情報をすでに収集している場合は、Account オブジェクトにその情報を事前入力できます。個人情報や事業情報、外部のアカウント情報など、あらゆるアカウント情報を事前に入力できます。

アカウントを作成したら、relationship.representative を true に設定した Person を作成して、口座開設の責任者と、事前に入力したい口座情報 (姓名など) を表します。

curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true

Connect アカウント登録で、事前入力された情報が要求されることはありません。ただし、アカウント所有者は Connect 利用規約に同意する前に、事前入力された情報を確認するよう求められます。

実装内容をテストする場合、テストデータを使用してアカウント情報を事前入力します。

以下のパラメーターを使用して Account Links API を呼び出すことで、アカウントリンクを作成できます。

• account: 前のステップで API から返されたアカウント ID を使用します
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Account Links リクエストへのレスポンスには、キー url の値が含まれます。ユーザーをこのリンクにリダイレクトして、フローに送ります。Account Links からの URL は、アカウント保有者の個人情報へのアクセスを許可するため、1 度しか使用できません。この URL にリダイレクトする前に、アプリケーションでユーザーを認証してください。Standard アカウントでアカウントリンクを作成した後は、顧客確認 (KYC) 情報の読み取りや書き込みはできなくなります。最初のアカウントリンクを作成する前に、KYC 情報を事前入力してください。

Connect アカウント登録では、ユーザーをプラットフォームにリダイレクトするすべてのケースを処理するために、return_url と refresh_url の両方を渡す必要があります。ユーザーに最高の体験を提供するためには、これらを正しく実装することが重要です。

return_url

ユーザーが Connect アカウント登録フローを完了すると、Stripe はこの URL へのリダイレクトを行います。ただしこれは、すべての情報が収集されたことを意味するものでも、アカウントの要件がすべて満たされたことを意味するものでもありません。ユーザーがフローに正常に入り、そこから正常に出たことのみを意味します。

この URL を通じて状態が渡されることはありません。ユーザーを return_url にリダイレクトしたら、以下のいずれかを行ってユーザーのアカウントの details_submitted パラメーターの状態を確認します。

• account.updated Webhook をリッスンする
• Accounts API を呼び出して、返されたオブジェクトを調べる

refresh_url

以下のケースでは、ユーザーは refresh_url にリダイレクトされます。

• リンクの期限が切れている (リンク作成後、数分が経過した)
• ユーザーがすでにリンクを使用した (ユーザーがページを更新したか、ブラウザーで戻るボタンまたは進むボタンをクリックした)
• お客様のプラットフォームがアカウントにアクセスできなくなった
• このアカウントが拒否されている

refresh_url はサーバでメソッドをトリガーし、同じパラメータを使用して Account Link (アカウントリンク) を再度呼び出し、シームレスな体験を作成するためにユーザを Connect アカウント登録フローにリダイレクトします。

return_url にリダイレクトされたユーザーは、アカウント登録プロセスを完了していないことがあります。/v1/accounts エンドポイントを使用してユーザーのアカウントを取得し、charges_enabled を確認します。アカウント登録が完全でない場合は、UI プロンプトを表示し、ユーザーが後でアカウント登録を続行できるようにします。ユーザーは、新しいアカウントリンク (システムで生成された) で本番環境利用の申請を完了できます。アカウントの details_submitted パラメーターの状態を確認すると、ユーザーがアカウント登録プロセスを完了したかどうかを調べることができます。