Docs
Search the docs
Find a page in the docs

API reference

List refunds

List the refunds of a payment, newest first.

GET /v1/payments/{payment_id}/refunds

Returns every refund of the payment in one response, without a cursor.

Path parameters

payment_id string required
The payment id, starting with pay_.

Request

curl https://api.camelpayment.com/v1/payments/pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA/refunds \
  -H "Authorization: Bearer $CAMEL_API_KEY"

Response

200
{
  "data": [
    {
      "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"
    }
  ]
}

Errors

StatusWhen
401 The API key is missing, malformed, or revoked.
404 No payment with this id in this environment.
429 Too many requests. Wait for Retry-After seconds.