# アカウント登録 Account onboarding Connect 埋め込みコンポーネントを使用します。 アカウント登録コンポーネントでは Accounts API を使用して要件を読み取り、アカウント登録フォームを生成します。このフォームは、Stripe で対応しているに適した形になっており、データを検証しています。さらに、組み込み型のアカウント登録はすべての事業形態、会社代表の各種設定、書類のアップロード、本人確認、認証ステータスにも対応します。 詳細については、[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)をご覧ください。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. アカウント登録コンポーネントでは Accounts API を使用して要件を読み取り、アカウント登録フォームを生成します。このフォームは、Stripe で対応しているに適した形になっており、データを検証しています。さらに、組み込み型のアカウント登録はすべての事業形態、会社代表の各種設定、書類のアップロード、本人確認、認証ステータスにも対応します。 詳細については、[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)をご覧ください。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. アカウント登録コンポーネントでは Accounts API を使用して要件を読み取り、アカウント登録フォームを生成します。このフォームは、Stripe で対応しているに適した形になっており、データを検証しています。さらに、組み込み型のアカウント登録はすべての事業形態、会社代表の各種設定、書類のアップロード、本人確認、認証ステータスにも対応します。 詳細については、[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)をご覧ください。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. アカウント登録コンポーネントでは Accounts API を使用して要件を読み取り、アカウント登録フォームを生成します。このフォームは、Stripe で対応しているに適した形になっており、データを検証しています。さらに、組み込み型のアカウント登録はすべての事業形態、会社代表の各種設定、書類のアップロード、本人確認、認証ステータスにも対応します。 詳細については、[埋め込みアカウント登録](https://docs.stripe.com/connect/embedded-onboarding.md)をご覧ください。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. ## 要件の収集オプション ユーザー登録コンポーネントを使用して情報を収集する場合、常に `currently_due` 要件を徴収します。`collectionOptions` 属性を使用すると、次のいずれかをリクエストすることもできます。 - `eventually_due` 要件 - [今後の要件](https://docs.stripe.com/connect/handle-verification-updates.md) - 粒度の細かい [要件の制限](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#requirement-restrictions) 連結するアカウントの特定の要件については、[必要な検証情報](https://docs.stripe.com/connect/required-verification-information.md) を参照してください。 ### 要件制限 収集オプションを指定する場合、詳細な要件制限を `only` または `exclude` として設定できます。どちらのオプションも、v2 アカウントの `requirements.entries[].description` に表示される必須プロパティを表す文字列の配列と、v1 アカウントのさまざまな要件配列を受け入れます。連結アカウントに適用される要件の詳細については、[必要な確認情報](https://docs.stripe.com/connect/required-verification-information.md)をご覧ください。 `exclude` は一致する口座要件をフィルタリングし、`only` は口座要件と指定された値の交差として機能します。また、`*` やリレーション接頭辞を使ったワイルドカードマッチングにも対応しています。 例えば、複数の所有者がいる連結アカウントがある場合、`only: ["owners.address.*"]` を指定することで、すべての所有者の住所情報を徴収することができます。 人物には複数のリレーションシップを関連付けることができ、また、リレーションシップは複数の担当者に割り当てることができます。そのため、リレーションシップ接頭辞を活用すると、指定したリレーションシップを持つ口座のすべての人に適用されます。これは、特定の人物の ID はわからないが、その人物のリレーションシップはわかっている場合に特に便利です。 重要な考慮事項: - ケイパビリティを有効にするためには、口座はすべての KYC 要件を満たす必要があります。`exclude` オプションは要件を削除するのではなく、その時点で徴収しないようにするだけです。情報は引き続き徴収する必要があります。 - これらの制限は、埋め込みコンポーネント内でのみ適用されます。他のタイプのダッシュボードを使用している口座には影響しません。 - この機能はユーザー体験を向上させるためのものであり、口座からの情報へのアクセスを防ぐためのものではありません。 #### 限定要件制限 このオプションは、その口座で未解決の、指定された要件のセットに回収をスコープします。このオプションは、改善策を構築するために最もよく用いられ、何らかの形式の文書のアップロードや本人確認を必要とする要件に特に有用です。 このオプションは、ユーザー登録が標準の最終サマリーステップを表示しないようにします。指定されたすべての要件が提供された場合、ユーザー登録コンポーネントは直ちに終了します。 #### 除外要件制限 このオプションは指定されたフィールドを非表示にし、連結するアカウントがその情報を提供したり編集したりできないようにします。このオプションは、コンポーネントからフィールドを非表示にするだけで、必要な情報を削除するわけではありません。このオプションは、ユーザー登録時に連結アカウントにアクセスさせたくない情報をあらかじめ入力しておく場合に便利です。 Express アカウントの場合、`exclude` で `business_type` の要件 (アカウントによる事業形態の変更を防ぐなど) を除外する場合は、アカウントの国とケイパビリティを設定する必要があります。 ## 外部口座の収集 [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-external_account_collection) 機能を使用して、コンポーネントが外部アカウント情報を収集するかどうかを制御します。このパラメーターはデフォルトで有効になっています。`external_account_collection` を有効にすると、[ユーザー認証](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) が必要になります。[disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-disable_stripe_user_authentication) パラメーターを使用して、Stripe ユーザー認証をオプトアウトできます。 ## Stripe ユーザー認証を無効にする [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-disable_stripe_user_authentication) 機能を使用して、コンポーネントで Stripe ユーザー認証が必要かどうかを制御します。 - デフォルトでは、`disable_stripe_user_authentication` は [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_onboarding-features-external_account_collection) の値とは逆です。 - `external_account_collection` が設定されていない場合、デフォルトは true になるため、`disable_stripe_user_authentication` はデフォルトで false になります。 - `controller.requirement_collection` が `stripe` の場合、どちらの値もデフォルトで false になります。 この値は、`controller.requirement_collection` が `application` のアカウントにのみ当てはまります。 [ベストプラクティス](https://docs.stripe.com/connect/risk-management/best-practices.md#prevent-account-take-overs)として、2 段階認証または同等のセキュリティ対策を導入することをお勧めします。この機能をサポートするアカウント (Custom アカウントなど) の設定により、連結アカウントが[マイナス残高](https://docs.stripe.com/connect/risk-management/best-practices.md#decide-your-approach-to-negative-balance-liability)を返済できない場合は、お客様がそのアカウントに代わって責任を負います。 ## ユーザーに表示するポリシーをカスタマイズする Stripe の利用規約と[プライバシーポリシー](https://stripe.com/privacy)は、オンラインのアカウント登録で連結アカウントに提示されます。[Stripe の利用規約](https://docs.stripe.com/connect/service-agreement-types.md#accepting-the-correct-agreement)に同意していない連結アカウントは、アカウント登録の最後の画面で規約を受け入れるように求められます。また、オンラインのアカウント登録のフッターにも、Stripe の利用規約と[プライバシーポリシー](https://stripe.com/privacy)へのリンクが掲載されています。 プラットフォームが要件の収集を行う連結アカウントに対しては、アカウント登録フローをカスタマイズする追加オプションがあります。以下に概要を示します。 ### 自社で利用規約への同意を管理する プラットフォームとして、貴社が必要な情報を収集する責任を負う連結アカウントを登録している場合、Stripe のオンラインのアカウント登録コンポーネントではなく、自社のプロセスを使用して[利用規約への同意を収集](https://docs.stripe.com/connect/updating-service-agreements.md#tos-acceptance)できます。自社のプロセスを使用する場合、アカウント登録の最終画面では、連結アカウントには入力した情報の確認のみが求められます。Stripe の利用規約への同意は貴社で確実に取得する必要があります。 ただし、オンラインのアカウント登録には (フッターなどに) 利用規約へのリンクが表示されます。このリンクを、[自社の規約およびプライバシーポリシーへのリンク](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md#link-to-your-own-agreements-and-privacy-policy)で置き換えることを選択できます。 ### 利用規約とプライバシーポリシーへのリンク Stripe の利用規約と[プライバシーポリシー](https://stripe.com/privacy)はオンライン登録のいたるところで連結アカウントに提示されます。貴社が要件の収集に責任を負う連結アカウントの場合、これらのリンクを自社の規約とポリシーに置き換えることができます。以下の手順に従って [Stripe 利用規約を組み込み](https://docs.stripe.com/connect/updating-service-agreements.md#adding-stripes-service-agreement-to-your-terms-of-service)、[Stripe プライバシーポリシーにリンク](https://docs.stripe.com/connect/updating-service-agreements.md#disclosing-how-stripe-processes-user-data)します。 ## アカウント登録コンポーネントを実装する 連結アカウントの ID と、有効にするコンポーネントとして `account_onboarding` を指定し、[Account Session (アカウントセッション)](https://docs.stripe.com/api/account_sessions.md) を作成します。 ### アカウントセッションを作成する [アカウントセッションの作成](https://docs.stripe.com/api/account_sessions/create.md)時に、`components` パラメーターで `account_onboarding` を指定して、アカウント登録を有効にします。 ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" ``` ### アカウントのユーザ登録コンポーネントを表示する アカウントセッションを作成して [ConnectJS を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドにアカウント登録コンポーネントを表示できます。 #### JavaScript ```js // 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.setCollectionOptions({ // fields: 'eventually_due', // futureRequirements: 'include', // requirements: { // exclude: ['business_profile.product_description'] // } // }) // accountOnboarding.setOnStepChange((stepChange) => { // console.log(`User entered: ${stepChange.step}`); // }); ``` #### HTML + JS | メソッド | タイプ | 説明 | デフォルト | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- | | `setFullTermsOfServiceUrl` | `string` | [利用規約全文](https://docs.stripe.com/connect/service-agreement-types.md#full)への同意の絶対 URL。 | [Stripe の利用規約全文](https://stripe.com/connect-account/legal/full) | | `setRecipientTermsOfServiceUrl` | `string` | [Recipient (受取人) の利用規約](https://docs.stripe.com/connect/service-agreement-types.md#recipient)への同意の絶対 URL。 | [Stripe 受取人利用規約](https://stripe.com/connect-account/legal/recipient) | | `setPrivacyPolicyUrl` | `string` | プライバシーポリシーへの絶対 URL。 | [Stripe プライバシーポリシー](https://stripe.com/privacy) | | `setSkipTermsOfServiceCollection` | `string` | [非推奨] 代わりに要件制限 `exclude: ["tos_acceptance.*"]` を使用してください。true の場合、埋め込みオンボーディングは利用規約の収集をスキップし、利用規約の承諾を[自分で収集](https://docs.stripe.com/connect/updating-service-agreements.md#indicating-acceptance)する必要があります。 | false | | `setCollectionOptions` | `{fields: 'currently_due' | 'eventually_due', future_requirements: 'omit' | 'include', requirements: { exclude: string[] } | { only: string[] }}` | `currently_due` または `eventually_due` 要件の収集をカスタマイズし、[future requirements](https://docs.stripe.com/connect/handle-verification-updates.md) を含めるかどうかを制御し、要件の収集を制限します。`eventually_due` を指定すると、`eventually_due` と `currently_due` 双方の要件が収集されます。 | `{fields: 'currently_due', futureRequirements: 'omit'}` | | `setOnExit` | `() => void` | 連結アカウントがアカウント登録プロセスを終了しました。 | | | `setOnStepChange` | `({step}: StepChange) => void` | 連結アカウントがアカウント登録プロセス内のいずれかのステップから別のステップに移動しました。以下で説明するように、`StepChange` を使用して現在のステップを識別します。 | | このコンポーネントを使用して新しいアカウントを設定するには、以下を実行します。 1. [連結アカウント](https://docs.stripe.com/api/accounts/create.md) を作成します。この API コールで `Account` オブジェクトに関する情報を事前入力できます。 1. 連結アカウントの ID を使用して、[Connect の埋め込みコンポーネントを初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)します。 1. `account-onboarding` エレメントを含めて、連結アカウントにアカウント登録フローを表示します。 1. このコンポーネントから送信される `exit` イベントをリッスンします。Stripe は、連結アカウントがアカウント登録プロセスを終了したときにこのイベントを送信します。 1. `exit` がトリガーされたら、`Account` の詳細を取得して、以下のステータスを確認します。 - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - その他のリクエストされたケイパビリティ 必要なケイパビリティがすべて有効な場合、連結アカウントをフローの次のステップに進めることができます。 #### React | React プロパティ | タイプ | 説明 | デフォルト | 必須またはオプション | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------- | | `onExit` | `() => void` | 連結アカウントがアカウント登録プロセスを終了すると、コンポーネントはこのコールバック関数を実行します | | 必須 | | `fullTermsOfServiceUrl` | `string` | [利用規約](https://docs.stripe.com/connect/service-agreement-types.md#full)の全文へのリンク | [Stripe の利用規約全文](https://stripe.com/connect-account/legal/full) | オプション | | `recipientTermsOfServiceUrl` | `string` | [受取人利用規約](https://docs.stripe.com/connect/service-agreement-types.md#recipient)へのリンク | [Stripe 受取人利用規約](https://stripe.com/connect-account/legal/recipient) | オプション | | `privacyPolicyUrl` | `string` | プライバシーポリシーへのリンク | [Stripe プライバシーポリシー](https://stripe.com/privacy) | オプション | | `skipTermsOfServiceCollection` | `boolean` | [非推奨] 代わりに要件制限 `exclude: ["tos_acceptance.*"]` を使用してください。true の場合、埋め込みオンボーディングは利用規約の収集をスキップし、利用規約の承諾を[自分で収集](https://docs.stripe.com/connect/updating-service-agreements.md#indicating-acceptance)する必要があります。 | false | オプション | | `collectionOptions` | `{fields: 'currently_due' | 'eventually_due', futureRequirements?: 'omit' | 'include', requirements?: { exclude: string[] } | { only: string[] }}` | `currently_due` または `eventually_due` 要件の収集をカスタマイズし、[future requirements](https://docs.stripe.com/connect/handle-verification-updates.md) を含めるかどうかを制御し、要件の収集を制限します。`eventually_due` を指定すると、`eventually_due` と `currently_due` 双方の要件が収集されます。コンポーネントが最初にレンダリングされた後は、このパラメーターは更新できません。 | `{fields: 'currently_due', futureRequirements: 'omit'}` | オプション | | `onStepChange` | `({step}: StepChange) => void` | コンポーネントは、オンボーディングプロセス内で連結アカウントが 1 つのステップから別のステップに移動したときに、このコールバック関数を実行します。以下で説明するように、`StepChange` を使用して現在のステップを特定します。 | | オプション | 1. [連結アカウント](https://docs.stripe.com/api/accounts/create.md) を作成します。この API コールで `Account` オブジェクトに関する情報を事前入力できます。 1. 連結アカウントの ID を使用して、[Connect の埋め込みコンポーネントを初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)します。 1. `account-onboarding` エレメントを含めて、連結アカウントにアカウント登録フローを表示します。 1. 連結アカウントがアカウント登録プロセスを終了したときに実行するコールバック関数 `onExit` を渡します。 1. `onExit` がトリガーされたら、`Account` の詳細を取得して次のステータスを確認します。 - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - その他のリクエストされたケイパビリティ 必要なケイパビリティがすべて有効な場合、連結アカウントをフローの次のステップに進めることができます。 ### StepChange オブジェクト `StepChange` タイプは `connect.js` で定義されています。連結アカウントがアカウント登録プロセスでステップ間を移動するたびに、ステップ変更ハンドラーは、以下のプロパティが指定された `StepChange` オブジェクトを受け取ります。 | 名前 | タイプ | サンプル値 | | ------ | ---------------------------- | --------------- | | `step` | `string` (有効なステップ名を指定してください) | `business_type` | アカウント登録ステップへの一意の参照。 | ##### 手順の制限 - `StepChange` オブジェクトは分析専用です。 - ステップは任意の順序で表示でき、繰り返す場合があります。 - 有効な `step` 名のリストは、予告なしにいつでも変更される可能性があります。 #### ステップ名 アカウント登録フローの各ページには、以下のステップ名のいずれかが設定されています。 | ステップ名 | 説明 | | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `stripe_user_authentication` | [ユーザー認証](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components)には、Stripe が管理するウィンドウへのポップアップが含まれます。ワークフローを続行する前に、連結アカウントは認証を終える必要があります。 | | `risk_intervention` | リスクに関する要件を解決するための指示を連結アカウントに提示します。 | | `legal_entity_sharing` | 連結アカウントは任意で、同じ所有者の既存のアカウントに記載されている[事業情報を再利用](https://docs.stripe.com/connect/networked-onboarding.md)できます。 | | `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` | 会社の[代表者](https://support.stripe.com/questions/beneficial-owner-and-director-definitions)に関する情報を収集します。 | | `directors` | 会社の[取締役](https://support.stripe.com/questions/beneficial-owner-and-director-definitions)に関する情報を収集します。 | | `executives` | 会社の[幹部](https://support.stripe.com/questions/beneficial-owner-and-director-definitions)に関する情報を収集します。 | | `proof_of_ownership_document` | [会社代表者](https://support.stripe.com/questions/beneficial-owner-and-director-definitions)を確認するための文書を収集します。 | | `proof_of_authorization` | 社内で[担当者が十分な権限のある地位に就いている](https://support.stripe.com/questions/representative-authority-verification)ことを確認するための文書を収集します。 | | `confirm_owners` | Stripe に提供した会社代表者情報が最新かつ正確であることを、連結アカウントが証明できるようにします。 | | `risa_compliance_survey` | (日本国内のビジネスにのみ適用されます。)[改正割賦販売法](https://stripe.com/guides/installment-sales-act)に関連する質問に回答します。 | | `treasury_and_card_issuing_terms_of_service` | 該当する機能をリクエストする際に、[プラットフォーム向け Treasury と Card Issuing](https://docs.stripe.com/treasury/connect.md) の利用規約への同意を取得します。 | | `external_account` | 連結アカウントの [external account](https://docs.stripe.com/api/accounts/object.md#account_object-external_accounts) を収集します。 | | `support_details` | 顧客が連結アカウントのビジネスを識別するのに役立つ情報を収集します。このサポート情報は、支払い明細書、請求書、領収書に表示できます。 | | `climate` | 連結アカウントが [Stripe Climate](https://docs.stripe.com/climate.md) にオプトインできるようにします。 | | `tax` | 連結アカウントが [Stripe Tax](https://docs.stripe.com/tax.md) にオプトインできるようにします。 | | `summary` | アカウント登録の最終審査のステップ。連結アカウントは、入力した情報をこのステップで更新できます。利用規約とプライバシーの URL がこの画面に表示されます。 | | `summary_risk` | 連結アカウントは、リスク要件に関する情報をサマリーステップで更新できます。 | | `summary_business_type` | 連結アカウントは、サマリーステップから、ビジネスタイプに関連する情報を更新できます。 | | `summary_business` | 連結アカウントは、ビジネスに関する情報をサマリーステップで更新できます。 | | `summary_support` | 連結アカウントは、サマリーステップから、ビジネスに関連する公開情報を更新できます。 | | `summary_persons` | 連結アカウントは、アカウントに保存されている個人に関する情報をサマリーステップで更新できます。 | | `summary_external_account` | 連結アカウントは、サマリーの段階から [external account](https://docs.stripe.com/api/accounts/object.md#account_object-external_accounts) に関する情報を更新できます。 | | `summary_tax` | 連結アカウントは、[Stripe Tax](https://docs.stripe.com/tax.md) システムに関する情報をサマリーステップで更新できます。 | | `summary_tax_identification_form` | 連結アカウントは、W8 / W9 フォームの資格情報をサマリーステップで更新できます。これは、Stripe が W8 / W9 フォームの情報を収集する必要がある場合に表示されます。 | | `summary_climate` | 連結アカウントは、[Stripe Climate](https://docs.stripe.com/climate.md) システムに関する情報をサマリーステップで更新できます。 | | `terms_of_service` | `only` ToS 受諾を徴収するために要件制限を活用する場合、`only` 要件制限を活用する場合はサマリーステップがレンダリングされないため、特別なステップをレンダリングします。 | ### アカウントセッションを作成する [アカウントセッションの作成](https://docs.stripe.com/api/account_sessions/create.md)時に、`components` パラメーターで `account_onboarding` を指定してアカウント登録を有効にします。 ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### アカウントのユーザ登録コンポーネントを表示する アカウントセッションを作成して [Stripe Connect を設定](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)したら、アカウント登録コンポーネントをアプリにレンダリングできます。 #### Swift ```swift class MyViewController: UIViewController, AccountOnboardingControllerDelegate { func accountOnboardingButtonTapped() { // Optional. If you use CollectionOptions, make sure to follow our policy instructions. // let collectionOptions = AccountCollectionOptions() // collectionOptions.fields = .eventuallyDue // collectionOptions.futureRequirements = .include let accountOnboardingController = embeddedComponentManager.createAccountOnboardingController( // fullTermsOfServiceUrl: URL(string: "{{URL}}")!, // recipientTermsOfServiceUrl: URL(string: "{{URL}}")!, // privacyPolicyUrl: URL(string: "{{URL}}")!, // collectionOptions: collectionOptions ) accountOnboardingController.delegate = self accountOnboardingController.title = "Onboard with Stripe" // Display the component in your app accountOnboardingController.present(from: self) } // MARK: - AccountOnboardingControllerDelegate func accountOnboardingDidExit(_ accountOnboarding: AccountOnboardingController) { print("User exited the onboarding flow") } } ``` `accountOnboardingDidExit` がトリガーされたら、`Account` の詳細を取得して次のステータスを確認します。 - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - リクエストされたその他のケイパビリティ 必要なケイパビリティがすべて有効な場合、連結アカウントをアプリケーションの次のステップに進めることができます。 [リファレンスドキュメント :external: を参照してください](https://stripe.dev/stripe-ios/stripeconnect/documentation/stripeconnect/accountonboardingcontroller)。 ### アカウントセッションを作成する [アカウントセッションの作成](https://docs.stripe.com/api/account_sessions/create.md)時に、`components` パラメーターで `account_onboarding` を指定してアカウント登録を有効にします。 ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### アカウントのユーザ登録コンポーネントを表示する アカウントセッションを作成して [Stripe Connect を設定](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)したら、アカウント登録コンポーネントをアプリにレンダリングできます。 #### Kotlin ```kotlin class MyActivity : FragmentActivity() { private lateinit var accountOnboardingController: AccountOnboardingController override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) EmbeddedComponentManager.onActivityCreate(this) // Optional. If you use CollectionOptions, make sure to follow our policy instructions. // val collectionOptions = CollectionOptions( // fields = FieldOption.EVENTUALLY_DUE, // futureRequirements = FutureRequirementOption.INCLUDE, // ) accountOnboardingController = embeddedComponentManager.createAccountOnboardingController( activity = this, title = getString(R.string.account_onboarding), props = AccountOnboardingProps( // fullTermsOfServiceUrl = "{{URL}}", // recipientTermsOfServiceUrl = "{{URL}}", // privacyPolicyUrl = "{{URL}}", // collectionOptions = collectionOptions ) ).apply { onDismissListener = OnDismissListener { println("User exited the onboarding flow") } } } private fun showAccountOnboarding() { accountOnboardingController.show() } } ``` 却下リスナーがトリガーされたら、`Account` の詳細を取得して次のステータスを確認します。 - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - リクエストされたその他のケイパビリティ 必要なケイパビリティがすべて有効な場合、連結アカウントをアプリケーションの次のステップに進めることができます。 [リファレンスドキュメント :external: を参照してください](https://stripe.dev/stripe-android/connect/com.stripe.android.connect/-account-onboarding-controller/index.html)。 ### アカウントセッションを作成する [アカウントセッションの作成](https://docs.stripe.com/api/account_sessions/create.md)時に、`components` パラメーターで `account_onboarding` を指定してアカウント登録を有効にします。 ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[account_onboarding][enabled]=true" \ -d "components[account_onboarding][features][disable_stripe_user_authentication]=true" ``` ### アカウントのユーザ登録コンポーネントを表示する アカウントセッションを作成し、[StripeConnect を設定](https://docs.stripe.com/connect/get-started-connect-embedded-components.md?platform=react-native#account-sessions)したら、アプリでアカウント登録コンポーネントを表示できます。 #### TypeScript ```javascript import { ConnectAccountOnboarding } from '@stripe/stripe-react-native'; export default function AccountOnboardingScreen() { return ( { console.log('User exited onboarding'); }} /> ); } ``` `onExit` がトリガーされたら、`Account` の詳細を取得して次のステータスを確認します。 - [details_submitted](https://docs.stripe.com/api/accounts/object.md#account_object-details_submitted) - [charges_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-charges_enabled) - [payouts_enabled](https://docs.stripe.com/api/accounts/object.md#account_object-payouts_enabled) - リクエストされたその他のケイパビリティ 必要なケイパビリティがすべて有効な場合、連結アカウントをアプリケーションの次のステップに進めることができます。 [リファレンスドキュメント :external: を参照してください](https://stripe.dev/stripe-react-native/api-reference/functions/ConnectAccountOnboarding.html)。 ## アクセスをリクエストする (プライベートベータ版) サインインして、プライベートプレビューで React Native 用 Connect の埋め込みコンポーネントへのアクセスをリクエストしてください。Stripe アカウントをお持ちでない場合は、[今すぐ登録](https://dashboard.stripe.com/register) できます。