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

Use the Create Account API to create a connected account with type set to standard. You can prefill any information, but at a minimum, you must specify the type. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding. If you know what capabilities the account needs, you can request them when you create it.

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

連結アカウントの情報をすでに収集している場合、Account オブジェクトに情報を事前入力できます。個人情報、ビジネス情報、外部口座情報など、アカウントに関するどのような情報でも事前入力できます。

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 パラメーターの状態を確認すると、ユーザーがアカウント登録プロセスを完了したかどうかを調べることができます。