# 金融口座

金融口座の詳細を表示します。

金融口座は、連結アカウントの個別の[金融口座](https://docs.stripe.com/api/treasury/financial_accounts.md)の画面を表示します。

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

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

## 外部口座の収集

[external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-external_account_collection) 機能を使用して、コンポーネントが外部アカウント情報を収集するかどうかを制御します。このパラメーターはデフォルトで有効になっています。`external_account_collection` を有効にすると、[ユーザー認証](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) が必要になります。[disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-disable_stripe_user_authentication) パラメーターを使用して、Stripe ユーザー認証をオプトアウトできます。

## Stripe ユーザー認証を無効にする

[disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-disable_stripe_user_authentication) 機能を使用して、コンポーネントで Stripe ユーザー認証が必要かどうかを制御します。

- デフォルトでは、`disable_stripe_user_authentication` は [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-external_account_collection) の値とは逆です。
- `external_account_collection` が設定されていない場合、デフォルトは true になるため、`disable_stripe_user_authentication` はデフォルトで false になります。

- `controller.requirement_collection` が `stripe` の場合、どちらの値もデフォルトで false になります。

この値は、`controller.requirement_collection` が `application` のアカウントにのみ当てはまります。

[ベストプラクティス](https://docs.stripe.com/connect/risk-management/best-practices.md#prevent-account-take-overs)として、2 段階認証または同等のセキュリティ対策を導入することをお勧めします。この機能をサポートするアカウント (Custom アカウントなど) の設定により、連結アカウントが[マイナス残高](https://docs.stripe.com/connect/risk-management/best-practices.md#decide-your-approach-to-negative-balance-liability)を返済できない場合は、お客様がそのアカウントに代わって責任を負います。

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

[アカウントセッションを作成する](https://docs.stripe.com/api/account_sessions/create.md)際に、`components` パラメーターで `financial_account` を指定して、金融口座コンポーネントを有効にします。金融口座コンポーネントの個々の機能は `financial_account` で `features` パラメーターを指定することで、有効または無効を設定できます。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_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 を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドに金融口座コンポーネントを表示できます。

#### JavaScript

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

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

#### HTML + JS

| メソッド                  | タイプ      | 説明            | デフォルト |
| --------------------- | -------- | ------------- | ----- |
| `setFinancialAccount` | `string` | 表示する金融口座の ID。 | 必須    |

#### React

| React プロパティ        | タイプ      | 説明            |    |
| ------------------ | -------- | ------------- | -- |
| `financialAccount` | `string` | 表示する金融口座の ID。 | 必須 |