アカウント管理

アカウント管理は連結アカウントの 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 enabled, this option requires user authentication. You can opt out of Stripe user authentication with the disable_stripe_user_authentication parameter.

Disable Stripe user authentication

Use the disable_stripe_user_authentication feature to control whether the component requires Stripe user authentication. By default, this parameter is false when external_account_collection is true and true otherwise. Only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable Stripe authentication.

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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',
// })