コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

Standard 連結アカウントで Connect を利用

Standard 連結アカウントを使用して、Connect をすぐに開始できます。連結アカウントの操作の大半は Stripe が処理します。

ページをコピー

「Standard」連結アカウントは、通常の Stripe アカウントです。連結アカウントが Stripe に接続されている場合、ダッシュボード へのログインや自身で請求の処理を行うことができます。

Stripe のサンプルシステムである Kavholm は、Connect アカウント登録を使用して、ユーザーにシームレスなアカウント登録体験を提供する方法を紹介しています。

Connect アカウント登録フォームのスクリーンショット

始める

Connect を初めて使用する場合は、Standard アカウントを使用して連結アカウントによる支払いの受け付けを有効化するをご覧ください。

Standard アカウントで、Connect アカウント登録フローを使用する

  1. Connect の設定ページに移動し、お客様のブランド の、名称、カラー、アイコンを使用してフォームの外観をカスタマイズします。Connect アカウント登録では、この情報は必須です。

  2. /v1/accounts API を使用して新しいアカウントを作成し、アカウント ID を取得します。アカウントリンクを生成する前に、ユーザのアカウントオブジェクトに情報を事前入力できます。以下のパラメータを渡す必要があります。

    • type = standard

    注

    新規アカウントを作成後、アカウントがダッシュボードに表示されることを確認します。

  3. Account Links API を呼び出して、アカウントを登録するリンクを作成します。

  4. お客様のプラットフォームのアカウント登録フローで、Account Link (アカウントリンク) によって返された url にユーザをリダイレクトします。

  5. アカウントのその他の状態を処理し、必要に応じてアカウントを Connect アカウント登録フローにリダイレクトします。

  6. 「オプション」: ダッシュボードで Connect アカウント登録のオプションを使用して、Connect アカウント登録フローに Tax や Climate などの追加の手順を追加することができます。

Standard アカウントの作成と情報の事前入力

Use the Create Account API to create a connected account with type set to standard. You can prefill any information, but at a minimum, you must specify the type. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding. If you know what capabilities the account needs, you can request them when you create it.

注

この例には、アカウント作成時に設定できるフィールドの一部のみが含まれています。 address や website_url など、設定可能なフィールドの一覧については、Create Account API リファレンス をご覧ください。

Command Line
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=standard

連結アカウントの情報をすでに収集している場合は、Account オブジェクトにその情報を事前入力できます。個人情報や事業情報、外部のアカウント情報など、あらゆるアカウント情報を事前に入力できます。

Connect アカウント登録で、事前入力された情報が要求されることはありません。ただし、アカウント所有者は Connect 利用規約に同意する前に、事前入力された情報を確認するよう求められます。

実装内容をテストする場合、テストデータを使用してアカウント情報を事前入力します。

アカウントリンクを作成する

以下のパラメーターを使用して Account Links API を呼び出すことで、アカウントリンクを作成できます。

  • account: 前のステップで API から返されたアカウント ID を使用します
  • refresh_url
  • return_url
  • type = account_onboarding
Command Line
curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

ユーザをアカウントリンク URL にリダイレクトする

Account Links リクエストへのレスポンスには、キー url の値が含まれます。ユーザーをこのリンクにリダイレクトして、フローに送ります。Account Links からの URL は、アカウント保有者の個人情報へのアクセスを許可するため、1 度しか使用できません。この URL にリダイレクトする前に、アプリケーションでユーザーを認証してください。Standard アカウントでアカウントリンクを作成した後は、顧客確認 (KYC) 情報の読み取りや書き込みはできなくなります。最初のアカウントリンクを作成する前に、KYC 情報を事前入力してください。

セキュリティのヒント

アカウントリンクの URL をメールやショートメッセージ、またはその他の方法で、プラットフォームのアプリケーション外に送信しないでください。URL は、アプリケーション内で認証済みのアカウント所有者に提供してください。

プラットフォームに戻るユーザを処理する

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

注

テスト環境 (localhost でテストする場合など) では、return_url と refresh_url に HTTP を使用できますが、本番環境で使用できるのは HTTPS のみです。本番環境に移行する前に、必ずテスト用の URL を HTTPS URL に入れ替えてください。

return_url

ユーザーが Connect アカウント登録フローを完了すると、Stripe はこの URL へのリダイレクトを行います。ただしこれは、すべての情報が収集されたことを意味するものでも、アカウントの要件がすべて満たされたことを意味するものでもありません。ユーザーがフローに正常に入り、そこから正常に出たことのみを意味します。

この URL を通じて状態が渡されることはありません。ユーザーを return_url にリダイレクトしたら、以下のいずれかを行ってユーザーのアカウントの details_submitted パラメーターの状態を確認します。

  • account.updated Webhook をリッスンする
  • Accounts API を呼び出して、返されたオブジェクトを調べる

refresh_url

以下のケースでは、ユーザーは refresh_url にリダイレクトされます。

  • リンクの期限が切れている (リンク作成後、数分が経過した)
  • ユーザーがすでにリンクを使用した (ユーザーがページを更新したか、ブラウザーで戻るボタンまたは進むボタンをクリックした)
  • お客様のプラットフォームがアカウントにアクセスできなくなった
  • このアカウントが拒否されている

refresh_url はサーバでメソッドをトリガーし、同じパラメータを使用して Account Link (アカウントリンク) を再度呼び出し、シームレスな体験を作成するためにユーザを Connect アカウント登録フローにリダイレクトします。

アカウント登録を完了していないユーザを処理する

return_url にリダイレクトされたユーザーは、アカウント登録プロセスを完了していないことがあります。/v1/accounts エンドポイントを使用してユーザーのアカウントを取得し、charges_enabled を確認します。アカウント登録が完全でない場合は、UI プロンプトを表示し、ユーザーが後でアカウント登録を続行できるようにします。ユーザーは、新しいアカウントリンク (システムで生成された) で本番環境利用の申請を完了できます。アカウントの details_submitted パラメーターの状態を確認すると、ユーザーがアカウント登録プロセスを完了したかどうかを調べることができます。

参照情報

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc