金融口座

金融口座は、連結アカウントの個別の金融口座の画面を表示します。

このコンポーネントに対するアクセス許可の境界は連結アカウントレベルであり、個々のfinancial accountレベルではありません。この UI は、単一のfinancial accountにアクセスが制限されているユーザーではなく、すべてのfinancial accountsにアクセスできるユーザーに表示する必要があります。

外部口座の収集

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 パラメーターで financial_account を指定して、金融口座コンポーネントを有効にします。金融口座コンポーネントの個々の機能は financial_account で features パラメーターを指定することで、有効または無効を設定できます。

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

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

// Include this element in your HTML
const financialAccount = stripeConnectInstance.create('financial-account');
financialAccount.setFinancialAccount('{{FINANCIAL_ACCOUNT_ID')
container.appendChild(financialAccount);

この埋め込みコンポーネントは、次のパラメーターに対応します。