金融口座

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

The permission boundary for this component is at the connected account level, not at the individual financial account level. This UI should be shown to users that have access to all financial accounts, not to users that have restricted access to a single financial account.

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.

Create an Account Session

アカウントセッションを作成する際に、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);

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