コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
Connect の使用を開始
導入の基本
導入の例
アカウント管理
アカウント登録
アカウントのダッシュボードを設定する
連結アカウントのタイプの操作
    連結アカウントのタイプ
      標準
      Express
      Custom
    動的な決済手段
決済処理
決済を受け付ける
アカウントへの送金
プラットフォーム管理
Connect プラットフォームを管理
Connect プラットフォームの納税申告書
ホームプラットフォームおよびマーケットプレイスWork with connected account typesConnected account types

注

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

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

Express 連結アカウントを使用すると、プラットフォームでの入金スケジュールの管理、売上フローのカスタマイズ、ブランディングの管理が可能になります。Stripe は、プラットフォームのアカウント登録、アカウント管理、本人確認を行います。

Express のデモ

Express アカウント登録の完全なフローの様子を確認するには、ご自身で構築する前に サンプルエンドツーエンド Express 組み込み をお試しください。このデモには、オンデマンドのマーケットプレイスである Rocket Rides の連結アカウント登録機能およびアカウント管理のサンプルが含まれています。

デモの完全なソースコードは GitHub にあります。

Rocket Rides (Express 連結アカウントを使用した Stripe Connect のデモ)

はじめに

Express 連結アカウントを作成するには、次のすべての要件を満たす必要があります。

  • 最低 API バージョン: Express 連結アカウントには API バージョン 2017-05-25 以降が必要です。ケイパビリティ は API バージョン 2019-02-19 以降が必要です。
  • サポートされる国のプラットフォーム: オーストラリア、オーストリア、ベルギー、ブラジル、ブルガリア、カナダ、クロアチア、キプロス、チェコ共和国、デンマーク、エストニア、フィンランド、フランス、ドイツ、ギリシャ、香港、ハンガリー、アイルランド、イタリア、日本、ラトビア、リトアニア、ルクセンブルグ、マルタ、メキシコ、オランダ、ニュージーランド、ノルウェー、ポーランド、ポルトガル、シンガポール、スロバキア、スロベニア、スペイン、スウェーデン、スイス、イギリス、アメリカのプラットフォームは、Stripe がサポートする ほぼすべての国の Express アカウントを作成できます。国別の制限の詳細について、またはお客様の国で Express アカウントの利用が可能になり次第通知をご希望の場合には、お問い合わせください。
  • セルフサービスがサポートされていない国: アラブ首長国連邦 および タイ では Connect を使用する際に適用される制限により、これらの国のプラットフォームユーザーは自身で Connect の Express 連結アカウントを登録することができません。これらの国で Connect の Express 連結アカウントの登録を開始する際は、お問い合わせください。
  • UAE のプラットフォーム: UAE のプラットフォームは、UAE に所在し、支払いタイプが destination_charges および 支払いと送金別方式 の Express 連結アカウントのみを使用できます。UAE のプラットフォームでは、まだ on_behalf_of 属性を使用したデスティネーション支払いに対応していません。
  • 不正利用の審査: Express 連結アカウントによって発生した損失の責任はプラットフォームが負うため、自社のプラットフォームを通じて登録したすべてのアカウントを調べ、不正利用の見込みがないことを確認する必要があります。詳細については、Stripe の リスク管理のベストプラクティスガイド をご覧ください。
  • プラットフォームプロフィール: プラットフォームのプロフィールを完了する必要があります。

プラットフォームの国以外で Express 連結アカウントを登録する

ダッシュボードの Connect の設定セクションで、国ごとにアカウント登録を有効にできます。

Express アカウント登録フローは現在、英語、フランス語、スペイン語、ブルガリア語、簡体字中国語、繁体字中国語、チェコ語、デンマーク語、オランダ語、エストニア語、フィンランド語、ドイツ語、ギリシャ語、ハンガリー語、インドネシア語、イタリア語、日本語、ラトビア語、リトアニア語、ノルウェー語、ポーランド語、ポルトガル語、ルーマニア語、スロバキア語、スロベニア語、スウェーデン語、タイ語に対応しています。

グローバルにアカウントを登録する場合は、次の点に注意してください。

  • 国際ビジネス: プラットフォームは、税務報告や財務報告など、ビジネスを国際的に行ううえでの影響を理解する必要があります。
  • 支払いフロー: 事業を行う国に基づいて支払いを作成するためのオプションを必ず確認してください。
  • 利用規約タイプ: プラットフォームで、受取人の利用規約に従って連結アカウントを作成し、海外送金を有効にできます。このようなアカウントは、ケイパビリティへのアクセスが制限されます。

アカウント登録体験を設定する

最初のアカウント登録を行う前に、Connect の設定ページに移動して、自社のブランド名、カラー、アイコンを使用してフォームのデザインをカスタマイズします。Connect アカウント登録では、この情報は必須です。

Express 連結アカウントを作成し、情報を事前入力する

Create Account API を使用し、type を express に設定して連結アカウントを作成します。任意の情報を事前入力できますが、少なくとも type を指定する必要があります。アカウントの国は、デフォルトでプラットフォームと同じ国に設定されており、アカウントはアカウント登録中に選択を確定します。

注

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d type=express

連結アカウントの国とケイパビリティが分かっている場合は、アカウントを作成する際にその情報を入力できます。これにより、Connect アカウント登録で、そのケイパビリティの要件が収集されます。アカウント登録の負荷を軽減するには、必要なケイパビリティのみをリクエストします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d country=US \ -d type=express \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true \ -d business_type=individual \ --data-urlencode "business_profile[url]"="https://example.com"

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

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

自社のウェブサイトを持たないアカウントのアカウント登録を行っていて、プラットフォームで個人の URL を提供している場合は、そのアカウントの business_profile.url を事前入力してください。アカウントに URL がない場合には、代わりに business_profile.product_description を事前入力できます。

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

capabilities を省略すると、Connect アカウント登録は Stripe ダッシュボードの構成設定セクションの設定を使用して、アカウントの国に基づいてケイパビリティを自動的にリクエストします。

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

以下のパラメーターを使用して、Account Link (アカウントリンク) を作成します。

  • account: 前のステップで API から返されたアカウント ID を使用します
  • refresh_url
  • return_url
  • type = account_onboarding
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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 Link には、url が含まれています。アカウントをこのリンクにリダイレクトして、アカウントをアカウント登録フローに送ります。各 Account Link の URL は、アカウント保有者の個人情報へのアクセスを許可するため、1 度しか使用できません。この URL にリダイレクトする前に、アプリケーションでアカウントを認証してください。

Express 連結アカウントの最初のアカウントリンクを作成する前に、顧客確認 (KYC) 情報を事前入力します。Express 連結アカウントのアカウントリンクを作成した後は、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 パラメーターの状態を確認してください。

  • Connect Webhook で account.updated をリッスンします。
  • API でアカウントを取得します。

refresh_url

以下の場合、連結アカウントは refresh_url にリダイレクトされます。

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

refresh_url を設定してサーバーでメソッドをトリガーし、同じパラメーターを使用して アカウントリンク を再度呼び出し、シームレスな操作性を実現するために連結アカウントを Connect アカウント登録フローにリダイレクトする必要があります。

アカウント登録を完了していない連結アカウントを処理する

お客様の return_url にリダイレクトされた連結アカウントは、アカウント登録プロセスを完了していない可能性があります。連結アカウントを 取得 して、charges_enabled を確認します。アカウント登録が完了していない場合は、UI プロンプトを表示し、連結アカウントが後でアカウント登録を続行できるようにします。連結アカウントは、(組み込みによって生成された) 新しいアカウントリンクから本番環境利用の申請を完了できます。連結アカウントの details_submitted パラメーターの状態を確認すると、アカウント登録プロセスを完了したかどうかを確認できます。

参照情報

  • Express ダッシュボード
  • Express ダッシュボードを導入する
  • Express ダッシュボードをカスタマイズする
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc