Stripe のホスティング登録

ダッシュボードの Connect の設定ページに移動して、ブランド名、色、アイコンでフォームの視覚的なデザインをカスタマイズします。Stripe のホスティング登録にはこの情報が必要です。Stripe では、連結アカウントのアカウント登録を行う際に、その銀行口座情報を収集することもお勧めしています。

デフォルトの controller (コントローラー) プロパティを使用して連結アカウントを作成します。コントローラープロパティについて、詳細はシステムの設計をご覧ください。または、アカウントの type (タイプ) を指定して、連結アカウントを作成することもできます。

curl -X POST https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

連結アカウントの国が分かっている場合は、アカウントを作成する際にその情報を入力できます。入力しない場合、デフォルトでプラットフォームと同じ国に設定されます。

To request capabilities for your connected account, you can provide that information when you create the account. Stripe’s onboarding UIs automatically collect the requirements for those capabilities. To reduce onboarding effort, request only the capabilities you need. If you omit capabilities, and your connected account has access to the full Stripe Dashboard or the Express Dashboard, capabilities are automatically requested. For accounts with access to the Express dashboard, Stripe-hosted onboarding uses the Configuration settings to request capabilities based on the account’s country.

アカウント所有者に関する情報 (氏名、住所、その他の詳細など) を入手している場合、アカウントの create (作成) または update (更新) 時に、事前に情報を提供することができます。Stripe のホスティング登録では、Connect 利用規約に同意する前に、事前入力された情報を確認するようアカウント所有者に求めます。API を使用して追加情報を提供することにより、メッセージの数が減り、連結アカウントの登録フローが強化されます。

また、ウェブサイトを持たないアカウントを登録する際に、プラットフォームがアカウントに URL を提供している場合は、そのアカウントの business_profile.url を事前入力します。アカウントに URL がない場合は、代わりに business_profile.product_description を事前入力できます。

実装内容をテストする際は、テストデータを使用して、本人確認、事業情報の確認、入金の失敗などのさまざまな結果をシミュレーションできます。

プラットフォームは、連結アカウントから必要な情報を事前に収集するか (アップフロント)、段階的に収集するか (インクリメンタル) を決定する必要があります。アップフロントアカウント登録では、アカウントの eventually_due 要件を収集するのに対して、インクリメンタルアカウント登録では currently_due 要件のみを収集します。

アップフロントまたはインクリメンタルのどちらのアカウント登録を使用するかを決定するには、連結アカウントが所在する国で必要な情報を確認して、今後期日を迎える要件を把握してください。Stripe は連結アカウントへの影響を最小限に抑えるように努めていますが、時間の経過につれて要件が変化する可能性があることに留意してください。

連結アカウントの ID を使用して Account Link (アカウントリンク) を作成し、再読み込み URL と戻り先 URL を含めます。アカウントリンクの URL がすでに使用されているか、期限切れであるか、または無効である場合、Stripe は連結アカウントを再読み込み URL にリダイレクトします。Stripe は、連結アカウントがアカウント登録フローを完了または中断すると、戻り先 URL にリダイレクトします。さらに、収集する必要のある情報に基づいて、collection_options.fields に currently_due または eventually_due のいずれかを渡します。この例では、アップフロントアカウント登録を使用するために eventually_due を渡します。インクリメンタルアカウント登録を使用するには、currently_due を設定します。

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/refresh" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding \
  -d "collection_options[fields]"=eventually_due

連結アカウントをアカウントリンク URL にリダイレクトする

連結アカウントをアカウントリンク URL にリダイレクトして、アカウント登録フローに送ります。各アカウントリンク URL は、アカウント所有者の個人情報へのアクセスを許可するため、1 度しか使用できません。この URL にリダイレクトする前に、アプリケーションでアカウントを認証してください。

Set up your integration to listen for changes to account requirements. You can test handling new requirements (and how they might disable charges and payouts) with the test mode trigger cards.

Based on your application’s verification requirements, send the connected account back through onboarding when it has currently_due or eventually_due requirements. Use these signals to determine when it’s necessary to re-initiate onboarding for a connected account.

You don’t need to worry about determining which requirements are missing. Onboarding collects the necessary information. For example, if there’s a typo preventing verification, onboarding prompts the connected account to upload an identity document (such as a Driver’s License in the United States). If any information is missing, onboarding requests it.

Stripe notifies you about any upcoming requirements updates that affect your connected accounts. You can proactively collect this information by reviewing the future requirements for your accounts.

確認エラーを処理する

account.updated イベントをリッスンします。current_deadline が着信したときにアカウントに currently_due フィールドが含まれている場合は、対応する機能が無効になり、そのフィールドが past_due に追加されます。

Stripe ホスティング登録フォームにアカウントを誘導して、確認要件を修正できるようにします。