Disputes on Connect platforms

Direct charges

For connected accounts that use direct charges and where your platform isn’t liable for negative balances (including Standard accounts), those accounts handle their own disputes. The disputed funds and dispute fees are taken from their balance, not the platform’s.

For connected accounts where your platform is liable for negative balances (including Custom and Express accounts), you’re ultimately responsible for any disputes involving those accounts.

For direct payments on connected accounts where your platform is liable for negative balances, Stripe debits disputed amounts and fees from the connected account’s balance. However, your platform is ultimately liable. If Stripe can’t debit the disputed amount and fee from the connected account, Stripe debits it from your platform account.

Destination and separate charges and transfers

For destination charges and separate charges and transfers, with or without on_behalf_of, Stripe debits dispute amounts and fees from your platform account.

We recommend setting up a webhook to listen to dispute created events. When that happens, you can attempt to recover funds from the connected account by reversing the transfer through the Dashboard or by creating a transfer reversal.

If the connected account has a negative balance, Stripe attempts to debit its external account if debit_negative_balances is set to true.

If you challenge the dispute and win, you can transfer the funds that you previously reversed back to the connected account. If your platform has an insufficient balance, the transfer fails. Prevent insufficient balance errors by adding funds to your Stripe balance.

To automate dispute management and handle chargebacks, browse Fraud Stripe Apps on the App Marketplace.

Provide Connect embedded components to allow your connected accounts to respond to disputes

Your connected accounts can use Connect embedded components to manage disputes from within your site.

The following components support dispute management:

• Payments component: Displays all of an account’s payments and disputes.
• Disputes list component: Displays all of an account’s disputes.
• Disputes for a payment component: Displays the disputes for a single specified payment. You can use it to include dispute management functionality on a page with your payments UI.