Managing bank accounts and debit cards

Learn how to manage bank accounts and debit cards on your Custom connected accounts.

Payout accounts can either be a bank account or debit card, and are added with the external_accounts parameter when creating or updating Custom accounts.

For Custom accounts in the US, Stripe recommends collecting bank account details with Stripe Financial Connections, which helps you:

Increase onboarding conversion by making sure that Custom accounts don’t leave your website or application to locate their account and routing numbers.
Eliminate the need to store sensitive data such as account and routing numbers on your server.
Eliminate the need to build form validations when Custom accounts enter account details.
Reduce first payout failure rates by eliminating errors that result from manual entry of account and routing numbers.
Access additional information on a user’s bank account, such as balances, ownership details, and transactions. For example, mitigate fraud when onboarding Custom accounts by verifying the ownership details of their bank account, such as the name and address of the account holder.

Enable Stripe Financial Connections either within the Connect Onboarding web form or within your own custom onboarding flow (using Financial Connections incurs fees).

Alternatively, you can collect bank account or debit card details from Custom accounts with your own manual entry form directly within your onboarding flow.

Connect Onboarding for Custom Accounts is a web form hosted by Stripe that takes care of collecting information required to onboard Custom accounts. You can currently only collect bank account details within the Connect Onboarding form. To collect debit card details, you must build a custom onboarding form.

Note

Financial Connections is available within the Connect Onboarding form as part of a US private beta. Request access.

Stripe platforms in the US can enable Stripe Financial Connections within the Connect Onboarding form. Follow these steps to enable Stripe Financial Connections within the form:

In Connect Settings, under Account types > Custom, select Manage to manage optional features of Connect Onboarding.
Under Collect bank account information for payouts, allow Stripe to collect bank account information by turning on the toggle.
Select the box to collect instantly verified account information with Financial Connections.
(Optional) Request permission to access additional data on the accounts instantly verified with Financial Connections, such as balances, ownership details, and transactions. If you opt to request this additional information, you’ll be prompted to sign up for Stripe Financial Connections.

After Stripe Financial Connections is enabled, all Custom accounts are prompted to authenticate their bank account using the Stripe-hosted modal UI embedded within the Connect Onboarding form.

This is a representation of what Custom accounts experience:

A Connect onboarding flow using Stripe Financial Connections to collect a payout account.

If a Custom account can’t instantly verify their bank account using Financial Connections, the verification process automatically falls back to manual entry. This is a representation of what users experience in the embedded manual entry form:

A Connect onboarding flow using the Stripe Financial Connections modal to collect a payout account using manual entry.

After your user completes the form, their bank account automatically attaches to the relevant Custom account.

Warning

The Stripe Financial Connections Terms describe the terms that apply to your use of Stripe Financial Connections. You may not access or use Stripe Financial Connections unless you abide by all of the terms, and by accessing or using Stripe Financial Connections, you agree to abide by all of the terms.