Disconnect a Financial Connections account

Use the Disconnect API to unlink customer bank accounts.

Disconnect a user’s Financial Connections Account if you no longer need data access or if your user writes into you requesting disconnection. Alternatively, your users can disconnect their accounts themselves.

If you disconnect an account, you can’t refresh their data and access previously refreshed data. However, any associated PaymentMethods remain usable.

To regain access to new account data, your user needs to re-authenticate their account through the authentication flow.

Disconnect a Financial Connections account

To disconnect an account, use the disconnect API:

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

.NET

No results

This request returns the account with an updated status to reflect the successful disconnection.

{
 "id": "fca_zbyrdjTrwcYZJZc6WBs6GPid",
 "object": "financial_connections.account",
 "account_holder": {
 "customer": "cus_NfjonN9919dELB",
 "type": "customer"
 },
 "institution_name": "PNC Bank",
 "status": "disconnected",
 // ...
}

After account disconnection, Stripe emits a financial_connections.account.disconnected webhook.