コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
Connect の使用を開始
導入の基本
導入の例
アカウント管理
アカウント登録
アカウントのダッシュボードを設定する
    Connect の埋め込みコンポーネントの使用を開始
    Connect の埋め込みコンポーネントをカスタマイズ
    対応可能な Connect の埋め込みコンポーネント
      アカウント登録と法令遵守
      アカウント管理
      アカウント登録
      通知バナー
      支払い管理
      支払い
      支払いの詳細
      1 件の支払いに対する不審請求の申し立て
      不審請求の申し立てリスト
      支払い方法の設定
      入金管理
      入金
      入金リスト
      残高
      Capital
      Capital 関連の構成要素
      税金
      税金登録
      Tax の設定
      税取引をエクスポートする
      Treasury と Issuing
      金融口座
      金融口座の取引
      Issuing カード
      Issuing カードリスト
      レポート機能
      ドキュメント
      レポートのチャート
      アプリ
      アプリのインストール
      アプリのビューポート
    Stripe ダッシュボードのカスタマイズ
    Stripe ダッシュボードアカウントのプラットフォーム制御
    Express ダッシュボード
連結アカウントのタイプの操作
決済処理
決済を受け付ける
アカウントへの送金
プラットフォーム管理
Connect プラットフォームを管理
Connect プラットフォームの納税申告書
ホームプラットフォームおよびマーケットプレイスConfigure account DashboardsSupported Connect embedded components

注

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

アカウント登録

Account onboarding Connect 埋め込みコンポーネントを使用します。

アカウント登録コンポーネントは Accounts API を使用して要件を読み取り、アカウント登録フォームを生成します。このフォームは、Stripe がサポートしているすべての国に合わせて調整されており、データ検証機能が付属しています。加えて、あらゆるビジネスタイプ、会社代表者の詳細設定、ドキュメントのアップロード、本人確認、検証ステータスをサポートしています。

詳細については、埋め込みアカウント登録をご覧ください。

要件の収集オプション

埋め込み型のアカウント登録では、currently_due または eventually_due 要件の収集と、今後の要件の収集のみを制御できます。この動作をカスタマイズするには、アカウント登録コンポーネントを導入する際に collectionOptions 属性を使用します。アカウントタイプの要件の詳細については、必要な確認情報をご覧ください。

外部口座の収集

external_account_collection 機能を使用して、コンポーネントで外部口座情報を収集するかどうかを制御します。このパラメーターはデフォルトで有効になっており、要件が期限切れになったときや変更されたときに最新情報を収集する責任を負うプラットフォーム (Custom アカウントを含む) のみが無効にできます。external_account_collection が有効になっている場合は、ユーザー認証が必要です。disable_stripe_user_authentication パラメーターを使用して Stripe ユーザー認証からオプトアウトできます。

Stripe ユーザー認証を無効にする

disable_stripe_user_authentication 機能を使用して、コンポーネントで Stripe ユーザー認証が必要かどうかを制御します。デフォルト値は、external_account_collection 値の反対です。たとえば、external_account_collection を設定していない場合、disable_stripe_user_authentication はデフォルトで false になります。この値は、controller.requirement_collection が application であるアカウントに対してのみ true になります。

ベストプラクティスとして、2 段階認証または同等のセキュリティ対策を導入することをお勧めします。この機能をサポートするアカウント (Custom アカウントなど) の設定により、連結アカウントがマイナス残高を返済できない場合は、お客様がそのアカウントに代わって責任を負います。

ユーザーに表示するポリシーをカスタマイズする

Stripe の利用規約とプライバシーポリシーは、オンラインのアカウント登録で連結アカウントに提示されます。Stripe の利用規約に同意していない連結アカウントは、アカウント登録の最後の画面で規約を受け入れるように求められます。また、オンラインのアカウント登録のフッターにも、Stripe の利用規約とプライバシーポリシーへのリンクが掲載されています。

プラットフォームが要件の収集を行う連結アカウントに対しては、アカウント登録フローをカスタマイズする追加オプションがあります。以下に概要を示します。

自社で利用規約への同意を管理する

プラットフォームとして、貴社が必要な情報を収集する責任を負う連結アカウントを登録している場合、Stripe のオンラインのアカウント登録コンポーネントではなく、自社のプロセスを使用して利用規約への同意を収集できます。自社のプロセスを使用する場合、アカウント登録の最終画面では、連結アカウントには入力した情報の確認のみが求められます。Stripe の利用規約への同意は貴社で確実に取得する必要があります。

ただし、オンラインのアカウント登録には (フッターなどに) 利用規約へのリンクが表示されます。このリンクを、自社の規約およびプライバシーポリシーへのリンクで置き換えることを選択できます。

利用規約およびプライバシーポリシーへのリンク

Stripe の利用規約とプライバシーポリシーはオンライン登録のいたるところで連結アカウントに提示されます。貴社が要件の収集に責任を負う連結アカウントの場合、これらのリンクを自社の規約とポリシーに置き換えることができます。以下の手順に従って Stripe 利用規約を組み込み、Stripe プライバシーポリシーにリンクします。

アカウントセッションを作成する

アカウントセッションの作成時に、components パラメーターで account_onboarding を指定して、アカウント登録を有効にします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d account=
{{CONNECTED_ACCOUNT_ID}}
\ -d "components[account_onboarding][enabled]"=true

アカウントセッションを作成して ConnectJS を初期化すると、フロントエンドにアカウント登録コンポーネントを表示できます。

account-onboarding.js
JavaScript
React
No results
// Include this element in your HTML const accountOnboarding = stripeConnectInstance.create('account-onboarding'); accountOnboarding.setOnExit(() => { console.log('User exited the onboarding flow'); }); container.appendChild(accountOnboarding); // Optional: make sure to follow our policy instructions above // accountOnboarding.setFullTermsOfServiceUrl('{{URL}}') // accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}') // accountOnboarding.setPrivacyPolicyUrl('{{URL}}') // accountOnboarding.setSkipTermsOfServiceCollection(false) // accountOnboarding.setCollectionOptions({ // fields: 'eventually_due', // futureRequirements: 'include', // }) // accountOnboarding.setOnStepChange((stepChange) => { // console.log(`User entered: ${stepChange.step}`); // });
メソッドタイプ説明デフォルト
setFullTermsOfServiceUrlstring利用規約全文への同意の絶対 URL。Stripe の利用規約全文
setRecipientTermsOfServiceUrlstringRecipient (受取人) の利用規約への同意の絶対 URL。Stripe 受取人利用規約
setPrivacyPolicyUrlstringプライバシーポリシーへの絶対 URL。Stripe プライバシーポリシー
setSkipTermsOfServiceCollectionstringtrue の場合、オンラインのアカウント登録では利用規約への同意の収集がスキップされ、規約への同意を自社で収集する必要があります。false
setCollectionOptions{ fields: 'currently_due' | 'eventually_due', future_requirements: 'omit' | 'include' }currently_due または eventually_due の要件の収集をカスタマイズし、future requirements (今後の要件) を含めるかどうかを制御します。eventually_due を指定すると、eventually_due と currently_due の両方の要件が収集されます。{fields: 'currently_due', futureRequirements: 'omit'}
setOnExit() => void連結アカウントがアカウント登録プロセスを終了しました。
setOnStepChange({step}: StepChange) => void連結アカウントがアカウント登録プロセス内のいずれかのステップから別のステップに移動しました。以下で説明するように、StepChange を使用して現在のステップを識別します。

このコンポーネントを使用して新しいアカウントを設定するには、以下を実行します。

  1. 連結アカウントを作成します。この API コールの Account オブジェクトに情報を事前入力できます。
  2. 連結アカウントの ID を使用して、Connect の埋め込みコンポーネントを初期化します。
  3. account-onboarding エレメントを含めて、連結アカウントにアカウント登録フローを表示します。
  4. このコンポーネントから送信される exit イベントをリッスンします。Stripe は、連結アカウントがアカウント登録プロセスを終了したときにこのイベントを送信します。
  5. exit がトリガーされたら、Account の詳細を取得して、以下のステータスを確認します。
    • details_submitted
    • charges_enabled
    • payouts_enabled
    • その他のリクエストされたケイパビリティ
    必要なケイパビリティがすべて有効な場合、連結アカウントをフローの次のステップに進めることができます。

StepChange オブジェクト

StepChange タイプは connect.js で定義されています。連結アカウントがアカウント登録プロセスでステップ間を移動するたびに、ステップ変更ハンドラーは、以下のプロパティが指定された StepChange オブジェクトを受け取ります。

名前
タイプ
サンプル値
step
string (有効なステップ名を指定してください)
business_type
アカウント登録ステップへの一意の参照。
ステップの制限
  • StepChange オブジェクトは分析専用です。
  • ステップは任意の順序で表示でき、繰り返す場合があります。
  • 有効な step 名のリストは、予告なしにいつでも変更される可能性があります。

ステップ名

アカウント登録フローの各ページには、以下のステップ名のいずれかが設定されています。

ステップ名説明
stripe_user_authenticationユーザー認証には、Stripe が管理するウィンドウへのポップアップが含まれます。ワークフローを続行する前に、連結アカウントは認証を終える必要があります。
risk_interventionリスクに関する要件を解決するための指示を連結アカウントに提示します。
legal_entity_sharing連結アカウントは、必要に応じて、同じ所有者の既存のアカウントの事業情報を再利用できます。
business_type連結アカウントの会社形態を設定します。場合により、連結アカウントに国を設定することもできます。
business_details連結アカウントのビジネスに関する情報を収集します。
business_verification会社の定款など、会社の企業識別番号を確認できる証明書類を収集します。または、誤って入力された会社情報をユーザーが修正できるようにします。
business_bank_account_ownership_verification銀行口座情報 (法的所有者の名前、口座番号など) が、そのユーザーの Stripe アカウントの情報と一致していることを裏付けるのに必要な書類を収集します。
business_documentsビジネスに関する追加書類および確認要件を収集します。
representative_detailsアカウント代表者に関する情報を収集します。
representative_documentアカウント代表者の存在を証明する政府発行の本人確認書類を収集します。
representative_additional_documentアカウント代表者の情報を裏付ける追加書類を収集します。
legal_guardian_details未成年者が開設したアカウントに対する法定後見人の同意を収集します。
owners会社の代表者に関する情報を収集します。
directors会社の取締役に関する情報を収集します。
executives会社の幹部に関する情報を収集します。
proof_of_ownership_document会社代表者を確認するための文書を収集します。
proof_of_authorization社内でアカウント代表者が十分な権限のある地位に就いていることを確認するための文書を収集します。
confirm_ownersStripe に提供した会社代表者情報が最新かつ正確であることを、連結アカウントが証明できるようにします。
risa_compliance_survey(日本国内のビジネスにのみ適用されます。)改正割賦販売法に関連する質問に回答します。
treasury_and_card_issuing_terms_of_serviceこれらのケイパビリティをリクエストすると、Treasury と Card Issuing の利用規約が収集されます。
external_account連結アカウントの外部口座を収集します。
support_details顧客が連結アカウントのビジネスを識別するのに役立つ情報を収集します。このサポート情報は、支払い明細書、請求書、領収書に表示できます。
climate連結アカウントが Stripe Climate にオプトインできるようにします。
tax連結アカウントが Stripe Tax にオプトインできるようにします。
summaryアカウント登録の最終審査のステップ。連結アカウントは、入力した情報をこのステップで更新できます。利用規約とプライバシーの URL がこの画面に表示されます。
summary_risk連結アカウントは、リスク要件に関する情報をサマリーステップで更新できます。
summary_business_type連結アカウントは、サマリーステップから、ビジネスタイプに関連する情報を更新できます。
summary_business連結アカウントは、ビジネスに関する情報をサマリーステップで更新できます。
summary_support連結アカウントは、サマリーステップから、ビジネスに関連する公開情報を更新できます。
summary_persons連結アカウントは、アカウントに保存されている個人に関する情報をサマリーステップで更新できます。
summary_external_account連結アカウントは、サマリーステップから外部口座に関連する情報を更新できます。
summary_tax連結アカウントは、Stripe Tax システムに関する情報をサマリーステップで更新できます。
summary_tax_identification_form連結アカウントは、W8 / W9 フォームの資格情報をサマリーステップで更新できます。これは、Stripe が W8 / W9 フォームの情報を収集する必要がある場合に表示されます。
summary_climate連結アカウントは、Stripe Climate システムに関する情報をサマリーステップで更新できます。
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc