Payout reversals

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

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.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

.NET

No results

Requirements

To be reversed, a payout:

Must be to a bank account in the US or Canada.
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.