ユーザー登録と要件の更新フローを Stripe のホスティング登録または埋め込みユーザー登録に移行する
連結アカウントのユーザー登録と更新された要件の収集のための API ベースのフローのすべてまたは一部を置き換えることで、メンテナンス作業を削減します。
連結アカウントの API ベースのユーザー登録フローを維持するには、要件が変更されるたびに、または新しい国でアカウント登録を行うときに、導入を更新する必要があります。Stripe では、フローを移行して、Stripe ホスティング登録または埋め込みユーザー登録を使用するようにすることで、このような作業を回避することをお勧めします。どちらのタイプも、収集する要件を自動的に決定でき、どちらも Stripe がサポートするすべての国に合わせてローカライズされています。
- Stripe のホスティングユーザー登録: この方法は、エンジニアリングの労力が最小限で済みます。ただし、カスタマイズはほとんどできず、アカウントユーザーが事前に入力した情報を変更することを防ぐことはできません。
- 埋め込みユーザー登録: この方法では、エンジニアリング作業が増えますが、よりカスタマイズされたユーザー登録インターフェイスを構築できます。アカウントユーザーが事前入力する情報を変更することを防止できます。
- ユーザー登録タイプの組み合わせ: この方法では、導入に応じてさまざまなレベルのエンジニアリング作業が必要になります。たとえば、API ベースのフローが特定の要件を収集し、埋め込みコンポーネントがその他のすべての要件を処理し、アカウントユーザーが自発的にアカウント情報を更新できるように Stripe がオンラインで提供するフォームを提供します。
ユーザー登録タイプの違いの詳細については、「ユーザー登録設定の選択」を参照してください。
Stripe ホスティング登録
Stripe ホスティングユーザー登録を使用するには、各連結アカウントに、情報入力用フォームを開く一度きり有効の専用 Account Link を渡します。Account Link を生成して、未対応の要件のみを収集するか、アカウントユーザーがアクセス可能なアカウント情報を更新できるようにすることができます。
連結アカウントのユーザー登録フローを Stripe のホスティングユーザー登録を使用するように移行するには、以下のステップが必要です。
- プラットフォームのダッシュボードで、Connect アカウント登録インターフェイス設定を開き、カスタマイズ をクリックして、ユーザー登録フォームのブランディングを定義します。
- ユーザー登録機能タブを選択し、ビジネス名を入力してアイコン、ロゴ、色を選択します。または、プラットフォームブランディングをコピーを選択して、プラットフォームブランド設定をフォームに適用することもできます。
- アプリケーションが連結アカウントユーザーをカスタムユーザー登録フローに送信する場合は、代わりに Account Link を生成してリンク先に送信するように更新します。Account Link を生成する際には、次のようなオプションを設定できます。
- アカウントユーザーがユーザー登録フローを完了したときに誘導される URL
- Account Link が切れている場合や無効な場合にアカウントユーザーを誘導する URL
- 最終的な請求額要件を収集するかどうか
- 将来の要件を収集するかどうか
- 最初のユーザー登録フローと、更新された要件を収集するフローの両方を置き換えます。
- 不要になった API ベースのフローは非推奨にします。
アカウントユーザーが Stripe のホスティングユーザー登録にアクセスするたびに、最新の要件が反映されます。要件が変更されたときにアカウントリンクを更新する必要はありません。
Account Link の設定方法など、詳細な手順については、Stripe がオンラインで提供するユーザー登録ドキュメントを参照してください。
オンラインのアカウント登録
埋め込みユーザー登録では、Stripe のホスティングユーザー登録よりも多くのエンジニアリング作業が必要になりますが、次のようなカスタマイズを大幅に増やすことができます。
- コンポーネントを埋め込むページのデザインを完全に制御する
- 指定された要件のリストのみを収集する
- 指定された要件のリストを収集から除外する
- 未対応の要件を連結アカウントに自動的に通知
Connect 埋め込みコンポーネントの新規ユーザー
既存のアプリケーションで Connect 埋め込みコンポーネントを使用していない場合は、その仕組みから始めます。
連結したアカウントのユーザー登録と要件の収集には、次の埋め込みコンポーネントを使用できます。
- アカウントユーザー登録: アカウントユーザーが未対応の要件のみを提供できるようにします。これには常に現在期日が到来している要件が含まれます。また、最終的に期日が到来する要件や将来の要件を含めるように設定することもできます。
- アカウント管理: アカウントユーザーは、未対応の要件など、さまざまなタイプのアカウント情報を更新できます。ただし、連結アカウントはこのコンポーネントを使用してリスク検証に対応できません。
- 通知バナー: アカウントユーザーが未対応の要件のみを提供できるようにします。連結アカウントは初期ユーザー登録をすでに完了している必要があるため、このコンポーネントは更新された要件またはリスクの確認にのみ使用できます。連結アカウントに未対応の要件がある場合にのみ表示され、特定の要件を含めるように設定したり除外したりすることはできません。
連結アカウントの初期ユーザー登録には、アカウントユーザー登録コンポーネントを使用します。
シンプルな収集による完全な移行
アカウントユーザーが事前入力された情報を変更する機能を制限することなく、埋め込みユーザー登録を使用するようにユーザー登録フロー全体を移行するには、以下のステップが必要です。
- 埋め込みコンポーネントを含むページをデザインします。既存のユーザー登録フローのページを出発点として使用できます。
- 埋め込みコンポーネントの外観をカスタマイズします。
- アプリケーションで連結アカウントユーザーを最初のユーザー登録のためにカスタムフローに送信する場合は、代わりにアカウントセッションを作成し、アカウントユーザー登録コンポーネントをマウントするように更新します。アカウントセッションを作成するときは、次のようなオプションを設定できます。
- 最終的な請求額要件を収集するかどうか
- 将来の要件を収集するかどうか
- カスタム利用規約とカスタムプライバシーポリシーのどちらにリンクするか。
- 外部アカウント情報を収集するかどうか。
- アプリケーションの各フローのうち、更新された要件を収集するものを、関連する埋め込みコンポーネントのいずれかに置き換えます。アカウント管理または通知バナーコンポーネントの使用は、アカウントユーザー登録コンポーネントの使用に似ています。
- 不要になった API ベースのフローは非推奨にします。
コンポーネントがレンダリングされるたびに、最新の要件が反映されます。要件が変更されたときにコンポーネントを更新する必要はありません。
アカウントセッションの設定方法など、詳細な手順については、組み込みのユーザー登録ドキュメントを参照してください。
一部移行または収集のカスタマイズによる移行
ユーザー登録と改善策フローを部分的に移行することも、特定の情報のみを収集するようにアカウントユーザー登録とアカウント管理コンポーネントを設定することで、カスタマイズされた要件収集を実装することもできます。以下に例を示します。
- 指定された要件のリストのみを収集する: 収集オプション
onlyの埋め込みコンポーネントを使用して、特定の複雑な要件または詳細な要件のみを収集し、既存の API ユーザー登録フローを使用して、その他すべての要件を収集します。たとえば、固有の Proof of Liveness (本人実在証明) ドキュメント要件がある地域でユーザー登録を開始する場合は、埋め込みコンポーネントを追加して、これらの要件のみを収集することができます。 - 指定されたリストを除くすべての要件を収集する: アカウントの作成時に特定の情報を事前入力し、収集の
excludeオプションが設定された埋め込みコンポーネントを使用して、アカウントユーザーがその情報を変更できないようにします。 - 外部アカウント収集の延期: 初期ユーザー登録時に外部アカウント収集を無効にして、連結アカウントの最初の取引後まで外部アカウントの収集を延期します。アカウントの最初の取引後に、外部アカウント収集を有効にしてアカウント登録コンポーネントを表示し、
onlyの収集オプションを使用して外部アカウントのみを収集します。
要件の更新
Custom API フローを引き続き使用して要件を収集する場合でも、要件が変更されたときに導入を更新する必要があります。埋め込みコンポーネントによって処理される要件のみが自動更新されます。
ユーザー登録フローを移行して、カスタマイズされた要件収集で埋め込みユーザー登録を使用するには、以下のステップを実行します。
- 埋め込みコンポーネントを含むページを設計します。既存のユーザー登録ページを出発点として使用できます。
- 埋め込みコンポーネントの外観をカスタマイズします。
- アプリケーションで連結アカウントユーザーを最初のユーザー登録のためにカスタムフローに送信する場合は、代わりにアカウントセッションを作成し、アカウントユーザー登録コンポーネントをマウントするように更新します。アカウントセッションを作成するときは、次のようなオプションを設定できます。
- 指定された要件のリストのみを収集するかどうか
- ステータスに関係なく、指定されたコンポーネントのリストを収集から除外するかどうか
- 最終的な請求額要件を収集するかどうか
- 将来の要件を収集するかどうか
- カスタム利用規約とカスタムプライバシーポリシーのどちらにリンクするか
- 外部アカウント情報を収集するかどうか
- アプリケーションで更新された要件を収集する各フローを、関連する埋め込みコンポーネントの 1 つに置き換えます。アカウント管理または通知バナーコンポーネントの使用は、アカウントユーザー登録コンポーネントの使用に似ていますが、通知バナーが収集する要件は制御できません。要件が変更されたときに、収集する更新情報を指定する必要はありません。コンポーネントの 1 つを連結アカウントに提示するだけで済みます。
- 不要になった API ベースのフローは非推奨にします。
コンポーネントがレンダリングされるたびに、最新の要件が反映されます。要件が変更されたときにコンポーネントを更新する必要はありません。
Account Sessions の設定や要件収集の制限方法など、詳細な手順については、組み込みのユーザー登録ドキュメントを参照してください。
ユーザー登録タイプの組み合わせ
ユーザー登録タイプを組み合わせて実装するには、Stripe ホスティングユーザー登録と部分埋め込みユーザー登録の手順に従い、各ユーザー登録タイプで処理する要件を確認します。次に、API ベースのフローを更新して、移行しない要件のみを処理するようにします。Stripe ホスティングユーザー登録では、すべての要件または未対応の要件の編集のみを許可するように設定できます。その他の設定では、埋め込みユーザー登録または API ベースのユーザー登録を使用する必要があります。