埋め込みアカウント登録
オンラインのアカウント登録は、Stripe のブランディングが一部に限定された、カスタマイズの自由度が高いアカウント登録 UI です。プラットフォームは、アプリケーションにアカウント登録コンポーネントを埋め込み、連結アカウントはアプリケーションを離れることなく埋め込みコンポーネントを操作します。オンラインのアカウント登録は Accounts API を使用して要件を読み取り、Stripe で対応しているすべての国に合わせて現地化され、堅牢なデータ検証を備えたアカウント登録フォームを生成します。さらに、オンラインのアカウント登録は以下のすべてに対応します。
- ビジネスのタイプ
- 会社代表者の設定
- 確認書類のアップロード
- 本人確認とステータス
- 海外の銀行口座
- エラーの状態
アカウントを作成し、情報を事前入力するサーバー側
アカウントの type (タイプ) を指定して、連結アカウントを作成します。
連結アカウントの国が分かっている場合は、アカウントを作成する際にその情報を入力できます。入力しない場合、デフォルトでプラットフォームと同じ国に設定されます。
連結アカウントのケイパビリティをリクエストする必要がある場合は、アカウントの作成時にその情報を提供し、Stripe のアカウント登録 UI でそれらのケイパビリティの要件を収集できます。アカウント登録の負荷を軽減するため、必要なケイパビリティのみをリクエストしてください。ケイパビリティを省略して、連結アカウントが Express ダッシュボードにアクセスできる場合、Stripe のホスティング登録は設定を使用して、アカウントの国に応じてケイパビリティを自動的にリクエストします。
アカウント所有者に関する情報 (氏名、住所、その他の詳細など) を入手している場合、アカウントの create (作成) または update (更新) 時に、事前に情報を提供することができます。Stripe のホスティング登録では、Connect 利用規約に同意する前に、事前入力された情報を確認するようアカウント所有者に求めます。API を使用して追加情報を提供することにより、メッセージの数が減り、連結アカウントの登録フローが強化されます。
また、ウェブサイトを持たないアカウントを登録する際に、プラットフォームがアカウントに URL を提供している場合は、そのアカウントの business_profile.url を事前入力します。アカウントに URL がない場合は、代わりに business_profile.product_description を事前入力できます。
実装内容をテストする際は、テストデータを使用して、本人確認、事業情報の確認、入金の失敗などのさまざまな結果をシミュレーションできます。
収集する情報を決定する
プラットフォームは、連結アカウントから必要な情報を事前に収集するか (アップフロント)、段階的に収集するか (インクリメンタル) を決定する必要があります。アップフロントアカウント登録では、アカウントの eventually_due
要件を収集するのに対して、インクリメンタルアカウント登録では currently_due
要件のみを収集します。
アップフロントアカウント登録 | インクリメンタルアカウント登録 | |
---|---|---|
長所 |
|
|
短所 |
|
|
アップフロントまたはインクリメンタルのどちらのアカウント登録を使用するかを決定するには、連結アカウントが所在する国で必要な情報を確認して、今後期日を迎える要件を把握してください。Stripe は連結アカウントへの影響を最小限に抑えるように努めていますが、時間の経過につれて要件が変化する可能性があることに留意してください。
貴社が必要な情報を収集する責任を負う連結アカウントの場合、アカウント登録コンポーネントを導入する際に collectionOptions
属性を使用して、今後の要件の動作をカスタマイズできます。
ユーザーに表示するポリシーをカスタマイズする
Stripe の利用規約とプライバシーポリシーは、オンラインのアカウント登録で連結アカウントに提示されます。Stripe の利用規約に同意していない連結アカウントは、アカウント登録の最後の画面で規約を受け入れるように求められます。また、オンラインのアカウント登録のフッターにも、Stripe の利用規約とプライバシーポリシーへのリンクが掲載されています。
プラットフォームが要件の収集を行う連結アカウントに対しては、アカウント登録フローをカスタマイズする追加オプションがあります。以下に概要を示します。
自社で利用規約への同意を管理する
プラットフォームとして、貴社が必要な情報を収集する責任を負う連結アカウントを登録している場合、Stripe のオンラインのアカウント登録コンポーネントではなく、自社のプロセスを使用して利用規約への同意を収集できます。自社のプロセスを使用する場合、アカウント登録の最終画面では、連結アカウントには入力した情報の確認のみが求められます。Stripe の利用規約への同意は貴社で確実に取得する必要があります。
ただし、オンラインのアカウント登録には (フッターなどに) 利用規約へのリンクが表示されます。このリンクを、自社の規約およびプライバシーポリシーへのリンクで置き換えることを選択できます。
利用規約およびプライバシーポリシーへのリンク
Stripe の利用規約とプライバシーポリシーはオンライン登録のいたるところで連結アカウントに提示されます。貴社が要件の収集に責任を負う連結アカウントの場合、これらのリンクを自社の規約とポリシーに置き換えることができます。以下の手順に従って Stripe 利用規約を組み込み、Stripe プライバシーポリシーにリンクします。
アカウント登録コンポーネントを導入するサーバー側クライアント側
連結アカウントの ID と、有効にするコンポーネントとして account_onboarding
を指定し、Account Session (アカウントセッション) を作成します。
アカウントセッションを作成する
アカウントセッションの作成時に、components
パラメーターで account_onboarding
を指定して、アカウント登録を有効にします。
アカウントセッションを作成して ConnectJS を初期化すると、フロントエンドにアカウント登録コンポーネントを表示できます。
期日が来た新しい要件に対応するサーバー側
アカウント要件の変更をリッスンするように実装内容を設定します。テスト環境トリガーカードを使用して、新しい要件 (およびそれらの要件によって支払いや入金がどのように無効になるか) の処理をテストできます。今後予定されている要件の更新が連結アカウントに影響する場合には、Stripe からご連絡いたします。
future requirements (今後の要件) を満たすための情報を前もって収集できます。申請の確認ニーズに基づき、必要に応じて連結アカウントをアカウント登録に送り返して currently_due
または eventually_due
の要件を満たします。これを、フローに連結アカウントを送り返すタイミングを示す合図として使用できます。
要件が何かを心配する必要はありません。連結アカウントをアカウント登録に送り返すと、適切な情報が収集されます。たとえば、ユーザーが情報を誤って入力して本人確認できない場合、本人確認書類 (アメリカの運転免許証など) の提出を求められる場合があります。このユーザーを Connect アカウント登録に送信すると、本人であることを確認できる書類のアップロードを求めるメッセージがユーザーに表示されます。
確認エラーを処理する
account.updated イベントをリッスンします。current_deadline
が着信したときにアカウントに currently_due
フィールドが含まれている場合は、対応する機能が無効になり、そのフィールドが past_due
に追加されます。
アカウント登録コンポーネントにアカウントを誘導して、確認要件を修正できるようにします。