API reference
List refunds
List the refunds of a payment, newest first.
GET
/v1/payments/{payment_id}/refundsReturns every refund of the payment in one response, without a cursor.
Path parameters
payment_idstring required- The payment id, starting with pay_.
Request
Response
{
"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
| Status | When |
|---|---|
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. |