アカウント管理

アカウント管理は、連結アカウント向けに UI コンポーネントを表示します。そこで、アカウントの詳細を表示したりプロアクティブに編集したりできます。連結アカウントは、個人情報やビジネス情報、公開情報、入金に使用する銀行口座といった、アカウント情報を表示および編集できます。

アカウント管理は、不足しているアカウント情報を収集するために最適化されておらず、リスク検証を処理しません。このようなユースケースでは、アカウント登録または通知バナーの使用を検討してください。

要件の収集オプション

連結アカウントに未対応の要件がある場合、オンラインのアカウント管理では連結アカウントに対して情報の更新を求めます。collectionOptions 属性を使用して、currently_due または eventually_due 要件の収集と、今後の要件の統合を制御できます。

details submitted 属性

アカウント管理コンポーネントは、details_submitted 属性が true のアカウントにのみ表示されます。アカウント登録が完了していない場合、アカウント管理コンポーネントの表示に失敗します。これらのシナリオでは、アカウント登録コンポーネントを使用することをお勧めします。

表示されるフィールド

アカウント管理コンポーネントで表示されるフィールドは、連結アカウントをどのように設定したか (特に連結アカウントの国、ビジネスのタイプ、ケイパビリティ、利用規約のタイプ) によって異なります。これは、アカウント登録コンポーネントが、連結アカウントをどのように設定するかに必要な情報のみを収集するのと似ています。

External account collection

Use the external_account_collection feature to control whether the component collects external account information. This parameter is enabled by default, and only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable it. When external_account_collection is enabled, user authentication is required. You can opt out of Stripe user authentication with the disable_stripe_user_authentication parameter.

Disable Stripe user authentication

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

We recommend implementing 2FA or equivalent security measures as a best practice. For account configurations that support this feature, such as Custom accounts, you assume liability for connected accounts if they can’t pay back negative balances.

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

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

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[account_management][enabled]"=true \
  -d "components[account_management][features][external_account_collection]"=true

アカウント管理コンポーネントを表示する

// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })