Skip to main content

How to disconnect the Stripe account of a user in your marketplace

When providers in your marketplace add their payout details, it creates a Stripe Connect account. You can disconnect from your marketplace and even delete it entirely, if needed.

Thomas Malbaux avatar
Written by Thomas Malbaux
Updated this week

If a provider has added their payment details but want to make a change that can't be done using Stripe's Connect Onboarding interface (for example if the provider has selected the wrong account type (business/individual)), disconnecting the account and letting them start adding their payment details from scratch may be necessary.

Disconnecting a Stripe Connect account from your marketplace can't be undone.

How to disconnect and delete the Stripe account of a seller in your marketplace

  1. Open Console and go to Manage > Users

  2. Find the user you want to edit and open their user card by clicking on it

  3. In the "Overview" section, look for "Stripe account ID"

    1. If the user has added their payment details, they have a Stripe Connect account ID (in the format acct_xxxxx)

    2. You can view the details of this Stripe Connect account, in your Stripe dashboard, by clicking on it

  4. Click the "Disconnect Stripe account" link next to the account ID

  5. If you also want to delete the Stripe Connect account from your Stripe Platform, check the "Delete the user's data from Stripe" box.

    1. If the user’s connected Stripe account has a balance that is not zero, you won't be able to delete it from Stripe, and must first resolve pending transactions and payouts manually in Stripe.

  6. Confirm

And voilà! That Stripe account is no longer connected to your marketplace and has been deleted from Stripe if you've decided to delete it.


What happens when a Stripe account is disconnected from your marketplace

When a Stripe account of a user in your marketplace is disconnected, it has the following effects:

  • The user can add new payment details.

  • If the user had ongoing transactions, their payouts will fail. You have to review the balance for that user (in your Stripe Dashboard) and figure out what to pay out, manually.

  • Refunds of past transactions will still work as expected.

  • The user's saved payment card details, if they had any, are disconnected, too. If they have ongoing transactions using that saved card, they'll fail until they add a new payment method

  • The Stripe Account and Stripe Customer information, in Stripe, is not deleted and can still be found in the Stripe Dashboard.

Did this answer your question?