Docs
Search the docs
Find a page in the docs

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:

curl -X POST https://api.camelpayment.com/v1/payments/pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA/refunds \
  -H "Authorization: Bearer $CAMEL_API_KEY" \
  -H "Idempotency-Key: refund-1524-1" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500000
  }'
201 Created
{
  "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

StatusMeaning
pendingThe provider is processing it.
approvedThe money is on its way back to the customer.
rejectedThe provider refused the refund.
failedThe provider returned an error. failure_code says which.
unknownThe 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.