Collect a bank account to optimize ACH Direct Debit payments with account data
Use account data such as balances to optimize your payments integration.
Stripe offers a number of ways to accept ACH Direct Debit payments from your users. All of these methods require that you verify the user’s account before you can debit their account. Financial Connections is the secure method offered by Stripe to perform instant bank account verification, that’s also extensible to more powerful features such as balance or ownership checks. When using Financial Connections to power your ACH flows, you can:
- Reduce payment failure rate from closed or inactive accounts
- Improve payments conversion by keeping users on session, instead of forcing them to leave your payments flow to locate their account and routing numbers
- Save development time by eliminating the need to create a custom bank account collection form
- Enable the collection of additional bank account data, such as balances and ownership information, to further optimize your integration
Before you begin
Financial Connections is the default verification method for all hosted ACH payment flows, such as Checkout or the Payment Element. If you use a hosted flow, skip directly to accessing additional account data. If you’re not already set up to collect ACH payments, set that up first.
Enable Financial Connections
The verification_
parameter on various API resources controls whether Financial Connections is enabled for bank account verification. Financial Connections with microdeposit fallback is the default.
Common mistake
Bank accounts that your customers link through manual entry and microdeposits won’t have access to additional bank account data like balances, ownership, and transactions.
Verification method | Description |
---|---|
automatic (default) | Financial Connections with the option to manually enter bank account information and use microdeposits |
instant | Financial Connections only, with no manual entry + microdeposit fallback |
microdeposits | Manual entry and microdeposits only |
This option is available on the following APIs:
Create a customerRecommended
We recommend that you create a Customer with an email address to represent your user, that you then attach to your payment. Attaching a Customer object allows you to list previously linked accounts later. By providing an email address on the Customer object, Financial Connections can improve the authentication flow by streamlining sign-in or sign-up for your user, depending on whether they’re a returning Link user.
Request access to additional account data
To access additional account data on Financial Connections Accounts, first make sure you’ve submitted your Financial Connections application by checking Financial Connections settings in the Dashboard. To view this page, activate your account. How you configure which types of account data you have access to depends on your integration.
Use data to optimize ACH integration
After you have been approved for additional bank account data access like balances or ownership, you can use this data to optimize ACH payments performance. For example, you can use balance data to reduce the risk of insufficient funds failures. See related data guides for examples:
- Balances: check account balance prior to payment initiation to reduce NSFs.
- Ownership: pull account owners and compare against your internal data models to catch potential fraud.
- Transactions: pull an account’s transaction history to check when the customer’s paycheck might land.
Finding the Financial Connections Account ID
To initiate data refreshes and retrieve data on a Financial Connections Account, you first need to get the account’s ID from the linked Payment Method by expanding the Payment Intent’s payment_
property:
The Financial Connections Account ID is on the expanded Payment Method’s us_
hash. If you allow manual entry fallback and the user manually entered their account information, this field is null
.
{ "id": "pi_3OK3g4FitzZY8Nvm11121Lhb", "object": "payment_intent", "payment_method": { "us_bank_account": { "financial_connections_account": "fca_1OK123bitUAA8SvmruWkck76" } // ... other fields on the Payment Method } // ... other fields on the Payment Intent }