Financial Account

Show the details of a Financial Account.

Financial Account renders the view of an individual Financial Account for your connected accounts.

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. 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

Use the disable_stripe_user_authentication feature to control whether the component requires Stripe user authentication.

• By default, disable _ stripe _ user _ authentication is the opposite of the external_account_collection value.

• If you leave external _ account _ collection unset, it defaults to true, so disable _ stripe _ user _ authentication defaults to false.

• When controller. requirement _ collection is stripe , both values default to false.

This value can only be true for accounts where controller.requirement_collection is application.

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

When creating an Account Session, enable the financial account component by specifying financial_account in the components parameter. You can enable or disable individual features of the financial account component by specifying the features parameter under financial_account.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

After creating the account session and initializing ConnectJS, you can render the financial account component in the frontend:

financial-account.js

Select a language

JavaScript

React

No results

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

This embedded component supports the following parameters: