Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
Example integrations
Onboard accounts
Configure account Dashboards
Accept payments
Pay out to accounts
    Payouts to connected accounts
    Manage payout accounts for connected accounts
    Manage payout schedule
    Manual payouts
    Payout reversals
    Payout statement descriptors
    Multi-currency settlement
    Instant Payouts
    Cross-border payouts
    Stablecoin payouts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesPay out to accounts

Payout reversals

Learn how to reverse a payout sent to a connected account.

Copy page

When the platform is responsible for risk and negative balances, you can make a payout reversal from an external bank account back to the connected account’s balance.

You can make payout reversals from the Dashboard payout details page or by calling reverse payout.

Reverse payouts in the Stripe Dashboard
Command Line
cURL
curl -X POST https://api.stripe.com/v1/payouts/
{{PAYOUT_ID}}
/reverse
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"

Requirements

To be reversed, a payout:

  • Must be to a bank account in the US.
  • Must be expected to arrive less than 90 days ago.
  • Can’t be a debit or an Instant Payout.

Webhooks

Payout reversals are considered debits and have the same webhooks as other payouts. For example, when a payout reversal is first requested, a payout.updated event is sent for the original payout. Then, events for the payout reversal are sent, including payout.created, payout.updated, payout.paid, and possibly a payout.failed event.

Failures

If the original payout fails while the payout reversal is in a pending state, Stripe cancels the reversing payout. A payout reversal in the paid state can later be refused by the associated bank and transition to the failed state. This results in a payout.failed event. Failed payout reversals aren’t retried.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc