Standard アカウントでの OAuth の使用

連携を開始するには、Connect OAuth アカウント登録オプションに移動し、以下を実行します。

• OAuth 設定で OAuth を使用したアカウント登録を有効にします。
• client_id(Stripe によって生成されるプラットフォームの一意の ID) をコピーします。
• ユーザがアカウントの連結後にリダイレクトされる URL である、redirect_uri を設定します。プラットフォームの設定にあるすべてのリダイレクト URL を指定する必要があります。リクエストに redirect_uri パラメータを含めなかった場合、プラットフォームの設定で最初に設定したアドレスがデフォルトとして使用されます。

また Stripe は、テストをサポートする client_id も提供しています。client_id は、本番 ID またはテスト ID のいずれかです。サンドボックス用の client_id を使用してサンドボックスアカウントに接続することもできます。

これらの情報を入手したら、OAuth リンクを作成できます。ユーザーを authorize_url エンドポイントに誘導する Stripe と連結するボタンを表示させることをお勧めします。

https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb&scope=read_write

Stripe エンドポイントは、少なくとも次の 3 つのパラメータを受け入れる必要があります。

1. code の値を含む response_type
2. client_id
3. read_write の値を含む scope

scope パラメータは、連結アカウントの代理としてプラットフォームが実行できることを指定します。デフォルトは read_only に設定されています。

CSRF 攻撃を防止するには、値として一意のトークンを渡して、state パラメーターを追加します。ユーザーをお客様のサイトにリダイレクトする際に指定した state を含めます。サイトでは、state パラメーターが変更されていないことを確認する必要があります。

Connect with Stripe (Stripe に連結) ボタンとともに、上記の URL をユーザに提示して連結を開始する方法です。

OAuth パラメーターを使用してアカウント登録をカスタマイズする

アカウント登録フローの動作を変更するには、追加の URL パラメーターを OAuth リンクに加えます。使用できるパラメーターの一覧については、OAuth リファレンスをご覧ください。

ユーザがお客様のサイトのリンクをクリックすると、Stripe の Web サイトに移動し、プラットフォームへの連結を許可または拒否するように求められます。

Stripe アカウントを作成するプロセスは、認証フローに組み込まれています。ユーザがすでにアカウントを持っているかどうかを心配する必要はありません。

ユーザはログインしており、プラットフォームに直接連結するためのアカウントを選択できます。

ユーザはアカウントを作成する必要があります。

ユーザーが既存または新規のアカウントをプラットフォームに連結すると、顧客は再度お客様のサイト (プラットフォームの redirect_uri に規定されている URL) にリダイレクトされます。

連結に成功すると、次の値が URL に渡されます。

• 付与された scope
• state 値 (指定されている場合)
• 認証コード。認証コードは一時的なコードであり、次のステップで説明する POST リクエスト内で 1 回のみ使用できます。

https://connect.stripe.com/connect/default/oauth/test?scope=read_write&code={AUTHORIZATION_CODE}

ユーザが認証を拒否した場合でも、お客様のサイトにリダイレクトされますが、URL には認証コードではなくエラーが含まれます。

https://connect.stripe.com/connect/default/oauth/test?error=access_denied&error_description=The%20user%20denied%20your%20request

提供された認証 code を Stripe のトークンエンドポイントへの POST リクエストに含めて、連結を完了しユーザのアカウント ID をフェッチします。

curl https://connect.stripe.com/oauth/token \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "code"="ac_123456789" \
  -d "grant_type"="authorization_code"

本番環境またはテスト環境のアクセストークンのどちらを取得するかに応じて、本番環境またはテスト環境の API シークレットキーでリクエストを作成します。

Stripe はユーザのアカウント ID (stripe_user_id) を含むレスポンスを返します。

{
  "token_type": "bearer",
  "scope": "read_write",
  "livemode": false,
  "stripe_user_id": 
"{{CONNECTED_ACCOUNT_ID}}",
}

問題が発生した場合は、代わりにエラーが返されます。

{
  "error": "invalid_grant",
  "error_description": "Authorization code does not exist: {AUTHORIZATION_CODE}"
}

完了です。これで、ユーザはプラットフォームに連結されました。stripe_user_id をデータベースに保存します。これは、新しいアカウントの Stripe アカウント ID です。この値を使用して、Stripe-Account ヘッダでリクエストに渡して、連結アカウントとして認証します。

アプリケーションでは、専用の OAuth クライアントライブラリを使用してこれらの手順の簡素化を検討することをお勧めします。ご使用の言語またはフレームワークの OAuth ライブラリを確認するには、OAuth Web サイトのクライアントライブラリのリストをご覧ください。

refresh_token は、本番環境での client_id のテスト用アクセストークンの生成や、アクセストークンのロールに使用できます。最初の POST リクエストの後でしか取得できないため、この値も保持する必要があります。