Guides
Refunds
Refund an approved payment in full or in part.
Refund a payment that is approved or partially_refunded. The money goes
back to the customer through the same provider, in the payment's currency.
Create a refund
Send an amount for a partial refund, or leave it out to refund everything left:
{
"id": "ref_01JBX8A1B2C3D4E5F6G7H8J9KM",
"payment_id": "pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA",
"provider_refund_id": "987654321",
"amount": 500000,
"currency": "ARS",
"status": "approved",
"provider_status": "approved",
"failure_code": null,
"created_at": "2026-11-12T16:10:00Z",
"updated_at": "2026-11-12T16:10:02Z"
}Partial refunds
You can refund a payment several times, until the refunds add up to the payment amount. Refunds
still pending count too, so two refunds sent at the same moment can't exceed the payment; the
second one returns 409. The payment becomes partially_refunded, then refunded.
Refund statuses
| Status | Meaning |
|---|---|
pending | The provider is processing it. |
approved | The money is on its way back to the customer. |
rejected | The provider refused the refund. |
failed | The provider returned an error. failure_code says which. |
unknown | The provider's answer was lost. Don't refund again with a new key. |
Camel sends a refund.* webhook each time a refund changes. To list a payment's
refunds, see List refunds.