Payout reversals

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.

curl -X POST https://api.stripe.com/v1/payouts/
{{PAYOUT_ID}}
/reverse \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 reversal aren’t retried.