# Finanzkonto

Details zum Finanzkonto anzeigen.

„Finanzkonto“ stellt die Ansicht eines einzelnen [Finanzkontos](https://docs.stripe.com/api/treasury/financial_accounts.md) für Ihre verbundenen Konten dar.

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.

Die Berechtigungsgrenze für diese Komponente liegt auf der Ebene des verbundenen Kontos, nicht auf der individuellen financial account Ebene. Diese Nutzeroberfläche sollte Nutzern/Nutzerinnen angezeigt werden, die Zugriff auf alle financial accounts haben, nicht Nutzern/Nutzerinnen, die eigenschränkten Zugriff auf ein einzelnes financial account haben.

## Erfassung externer Konten

Verwenden Sie die Funktion [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-external_account_collection), um zu steuern, ob die Komponente externe Kontoinformationen erfasst. Dieser Parameter ist standardmäßig aktiviert. Wenn `external_account_collection` aktiviert ist, ist eine [Nutzerauthentifizierung](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) erforderlich. Sie können die Stripe-Nutzerauthentifizierung mit dem Parameter [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-disable_stripe_user_authentication) deaktivieren.

## Stripe-Nutzerauthentifizierung deaktivieren

Verwenden Sie die Funktion [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-disable_stripe_user_authentication), um zu steuern, ob die Komponente eine Stripe-Nutzerauthentifizierung erfordert.

- Standardmäßig ist `disable_stripe_user_authentication` das Gegenteil des Werts [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-financial_account-features-external_account_collection).
- Wenn Sie `external_account_collection` nicht festlegen, wird standardmäßig „true“ verwendet, sodass `disable_stripe_user_authentication` standardmäßig auf „false“ gesetzt wird.

- Wenn `controller.requirement_collection` `stripe` ist, sind beide Werte standardmäßig „false“.

Dieser Wert kann nur für Konten gelten, bei denen `controller.requirement_collection` `application` ist.

Wir empfehlen die Implementierung von 2FA oder gleichwertigen Sicherheitsmaßnahmen als [Best Practice](https://docs.stripe.com/connect/risk-management/best-practices.md#prevent-account-take-overs). Bei Kontokonfigurationen, die diese Funktion unterstützen, wie z. B. Custom-Konten, übernehmen Sie die Haftung für verbundene Konten, wenn diese [Negativsalden](https://docs.stripe.com/connect/risk-management/best-practices.md#decide-your-approach-to-negative-balance-liability) nicht zurückzahlen können.

## Kontositzung erstellen

Aktivieren Sie [beim Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) die Finanzkonto-Komponente, indem Sie `financial_account` im Parameter `components` angeben. Sie können einzelne Funktionen der Finanzkontokomponente aktivieren oder deaktivieren, indem Sie den Parameter `features` unter `financial_account` angeben.

```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"
```

Nachdem die Kontositzung erstellt und [ConnectJS initialisiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Finanzkonto-Komponente im Frontend darstellen:

#### JavaScript

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

Diese eingebettete Komponente unterstützt die folgenden Parameter:

#### HTML + JS

| Methode               | Typ      | Beschreibung                           | Standard     |
| --------------------- | -------- | -------------------------------------- | ------------ |
| `setFinancialAccount` | `string` | Die ID des anzuzeigenden Finanzkontos. | erforderlich |

#### React

| React-Eigenschaft  | Typ      | Beschreibung                           |              |
| ------------------ | -------- | -------------------------------------- | ------------ |
| `financialAccount` | `string` | Die ID des anzuzeigenden Finanzkontos. | erforderlich |