Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use caseUse Managed PaymentsRecurring payments
In-person payments
Payment methods
Payment operations
Balances and settlement timeReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

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
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/financial_connections/accounts/
{{ACCOUNT_ID}}
/disconnect \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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.