Refunds
Refund a customer fully or partially, and understand how refunds affect your balance.
You can refund a completed payment back to your customer — in full or in part — from the dashboard or via the API.
What you can refund
- The payment must be Completed.
- You can refund the full amount or any partial amount.
- Across one or more partial refunds, the total refunded can never exceed the original payment.
- A refund needs a reason, and you can attach your own reference for your records.
How a refund progresses
A refund isn't instant — it's sent to the provider and settles over a short period. It moves through these states:
| Status | Meaning |
|---|---|
| Initiated | The refund has been created and queued with the provider |
| Processing | The provider has accepted the refund request |
| Completed | The provider has settled the refund to the customer |
| Failed | The provider rejected the refund |
If you use webhooks, you'll receive a payment.refunded event when a refund
completes, or payment.refund_failed if it fails.
Effect on the payment
- A full refund moves the original payment to Refunded.
- A partial refund leaves the payment as Completed, with the refunded amount tracked separately.
Effect on your balance
Refunds reduce what you're owed. If a payment has already been paid out to your bank, a later refund is clawed back from a future payout — you'll see it as a deduction on your next settlement statement. See Balance & payouts.
Refunds are final
Once a refund completes, the money has gone back to the customer and the refund can't be reversed. Double-check the amount before confirming.
Next steps
- Balance & payouts
- Developers: Refunds API guide