Payout reversals

In cases where funds for an Express or Custom account have been paid to the wrong bank account, the platform can make a payout reversal from the bank account back to the connected account’s balance.

Payout reversals can be requested from the dashboard on the payout details page

or via the API.

curl https://api.stripe.com/v1/payouts/po_1HKchiD8z0M6mPs2dEUJPcV4/reverse \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -X POST
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.
• expected to arrive less than 90 days ago.
• not a debit or an Instant Payout.

Webhooks

A payout reversal will appear as a debit and will have the same webhooks as other payouts. For example, when the payout reversal is first requested, there will be a payout.updated event on the original payout. Then, the payout reversal will have the payout.created, payout.updated, payout.paid, and possible payout.failed events.

Failures

In the event that the original payout fails while the payout reversal is still in a pending state, Stripe will cancel the reversing payout.

If the payout reversal fails, we do not allow for retries.