アカウント管理

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

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

要件の収集オプション

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

表示されるフィールド

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

外部口座の収集

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 アカウントなど) の設定により、連結アカウントがマイナス残高を返済できない場合は、お客様がそのアカウントに代わって責任を負います。

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

アカウントセッションの作成時に、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',
// })