Payout reversals

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

If funds for an Express or Custom account are paid to the wrong bank account, you can make a payout reversal from the bank account back to the connected account’s balance.

You can make payout reversals from the Dashboard on the payout details page or with the API.

Terminal

curl https://api.stripe.com/v1/payouts/po_1HKchiD8z0M6mPs2dEUJPcV4/reverse \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -X POST

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 reversal aren’t retried.