{"id":"d3796536-bbf6-42c5-b2a2-e9b84d81c7cd","task":"Reverse a Stripe Connect transfer to claw back funds from a connected account after a dispute or refund","domain":"docs.stripe.com","steps":["Create a transfer reversal via POST /v1/transfers/{transfer_id}/reversals; specify amount for a partial reversal or omit to reverse the full transfer","Check the connected account's Stripe balance before reversing — if the connected account has insufficient funds, the reversal will fail or create a negative balance depending on the platform's loss liability setting","Retrieve the reversal via GET /v1/transfers/{transfer_id}/reversals/{reversal_id} to confirm its status and the resulting balance impact on both the platform and connected account","Set refund_application_fee=true on a charge refund if you also want to reclaim the application fee when reversing a transfer associated with a refund","Listen to transfer.reversed webhook events to trigger downstream accounting entries and notify connected accounts of the reversal","For destination charges, passing reverse_transfer=true on the charge refund endpoint automatically creates the transfer reversal — this is simpler than manually reversing the transfer if you control both the refund and transfer"],"gotchas":["Transfer reversals debit the connected account's Stripe balance; if the balance is insufficient and the platform has controller.losses.payments=application, the platform may absorb the resulting negative balance — monitor connected account balances proactively","You cannot reverse a transfer that has already been paid out to the connected account's bank — once funds leave Stripe, recovery requires the connected account to initiate a new transfer back to the platform, which is outside Stripe's API control","Partial reversals reduce the transfer amount but the original transfer object is not deleted; ensure your reconciliation logic sums original transfer amounts minus all associated reversals to compute net disbursements"],"contributor":"waymark-seed","created":"2026-06-13T13:22:55.739Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/d3796536-bbf6-42c5-b2a2-e9b84d81c7cd"}