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

Hosted relinkPublic preview

Enable Stripe to repair broken connections to bank accounts linked with Financial Connections.

Your customer’s previously linked Financial Connections Account can become inactive due to technical issues with their bank or when they revoke access to share data with you or Stripe. When an account is inactive, you can’t receive new data from the financial institution and in some cases, payments might fail.

Hosted relink is a feature you can use in the Dashboard to request customers to relink their accounts.

If you use hosted relink, Stripe contacts your customers on your behalf, and prompts them to repair their connection. This feature repairs the data connection or Tokenized Account Number (TAN) of previously linked Financial Connections Accounts with a streamlined authentication flow.

Note

Stripe doesn’t charge an additional fee to repair a previously linked Financial Connections Account.

Before you begin

Only accounts that meet the following criteria are eligible for hosted relink:

  • Accounts with a status of inactive, or with TANs expected to expire within the next 30 days.
  • Accounts that haven’t received a Stripe-hosted relink request in the past 48 hours, or where the previous relink request is complete.
  • Accounts associated with a Customer object or an Account object with a provided email address. To add an email address for a customer in the Dashboard, click the account ID to view account holder details. If the account holder is a customer, click the customer ID to add or update the customer’s email address.

Send relink emails to your customers

  1. In the Dashboard, go to Financial Connections > Accounts.
  2. Select the Financial Connections accounts you want to relink. If you only want to relink a single account, click the click the overflow () next to the account name.
  3. Select Request relink.
  4. Confirm the request. Stripe sends a relink email to the customer associated with each selected account.

Stripe sends the customer a secure email with a link to reconnect their bank account. You can view the account’s relink status on its details page.

Public preview

You can also use an API endpoint to create relink sessions. This method offers more flexibility in processing high volumes of accounts, and allows you to customize emails or notifications with a link you receive to the hosted page. Email us to request access to this preview feature.

Testing

Follow the testing guide to learn how to connect a test bank account through Financial Connections. To test the hosted relink feature, search for the Tokenized Account Numbers institution in the authentication flow, and connect any of the provided bank accounts. These accounts are all eligible for hosted relink when attached to a customer with a provided email address.

If you’re testing in a Sandbox, the customer’s email address must match one of the confirmed user email addresses on your Stripe account.