連結アカウントをユーザー登録する

アカウントリンク リクエストへのレスポンスには、キーの url の値が含まれます。このリンクにリダイレクトして、連結アカウントをユーザー登録フローに送ります。

アカウントリンク API の URL は一時的なもので、連結アカウントユーザーの個人情報へのアクセスを許可するため、1 回限り使用できます。アプリケーションでユーザーを認証してから、この URL にリダイレクトします。情報を事前入力 する場合は、アカウントリンクを生成する前に入力する必要があります。アカウントリンクの作成後は、連結アカウントの情報の読み取りまたは書き込みができなくなります。

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

リターン URL を設定する

ユーザーがユーザー登録フローを完了するか、フローの任意の時点で 保存して後で処理 をクリックすると、Stripe は連結アカウントを return_url にリダイレクトします。これは、すべての情報が収集されたことを意味するものでも、アカウントの要件がすべて満たされたことを意味するものでもありません。ユーザーがフローに正常に入り、そこから正常に出たことのみを意味します。

この URL では状態が渡されません。連結アカウントが return_url にリダイレクトされたら、以下のいずれかによってアカウント登録が完了したかどうかを確認します。

• アカウントを取得し、requirements ハッシュで未対応の要件を確認します。
• Webhook エンドポイントに送信された account.updated イベントをリッスンし、アプリケーションでアカウントの状態をキャッシュします。アカウントがユーザー登録を完了していない場合は、後でユーザー登録を続行できるように、アプリケーションでプロンプトを表示します。

リフレッシュ URL を設定する

Stripe は以下のケースでユーザーを refresh_url にリダイレクトします。

• リンクの有効期限切れ (リンク作成後、数分が経過)。
• ユーザーがすでに URL にアクセスしている (ユーザーがページを更新したか、ブラウザーで戻るボタンまたは進むボタンをクリックした)。
• プラットフォームがアカウントにアクセスできなくなった。
• リンクが、URL にアクセスしてプレビューを試みる、メッセージングクライアントなどのサードパーティー申し込みに共有されました。多くのクライアントが自動的にリンクにアクセスすることにより、アカウントリンクが期限切れになります。
• アカウントが拒否された。

サーバーでメソッドを呼び出して アカウントリンク を再度作成し (同じパラメーターを使用)、連結アカウントを新しいアカウントリンクの URL にリダイレクトするように refresh_url を設定します。

return_url にリダイレクトされたユーザーは、ユーザー登録プロセスを完了していないことがあります。ユーザーがユーザー登録プロセスを完了したかどうかを確認するには、ユーザーのアカウント を取得し、details_submitted が true に設定されていることを確認します。details_submitted が false の場合、アカウントは完全には登録されていません。ユーザーが後でユーザー登録を続行できるように、UI プロンプトをアプリケーションに表示します。ユーザーは、導入によって生成された新しいアカウントリンクからアカウントの有効化を完了できます。