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 caseRecurring payments
In-person payments
Payment Methods
Payment operations
Balances and settlement timeReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

Use the Financial Connections API to relink an accountPublic preview

Integrate the relink authentication flow directly into your website or application.

Your customer might need to relink an existing Financial Connections account to restore data access, refresh deactivated tokenized account numbers, or update the data permissions available on the account. Use the Financial Connections server-side API and a client-side SDK library to prompt your customer to complete a relink session directly in your website or application.

Your integration will:

  1. Create a Financial Connections session on the server which sets the relink_options parameter.
  2. Pass the session’s client_secret to your front end.
  3. Use a client SDK method such as collectFinancialConnectionsAccounts to prompt your customer to complete the authentication flow.
  4. Handle the relinking outcome on the client.
  5. Optionally, handle webhook events when accounts relink successfully.

Next steps

Relink for payments or payouts

Configure the authentication flow to relink accounts used for payments or payouts.

Relink for data products

Configure the authentication flow to relink accounts used to access data such as balances, transactions, and ownership.

Stripe-hosted relink

Email your customer a link to a Stripe-hosted page to relink an account.