v1

latestOpenAPI 3.1.02026-08-0629140119.9 KB
PIX Refunds

Get Refund

Retrieves a single PIX refund by its ID for the authenticated account.

get/v1/refunds/{id}

Path parameters

idinteger required

Refund identifier

Response

Refund retrieved successfully

cancelled_atstring date-time nullable

Cancellation timestamp (UTC, RFC 3339), if cancelled.

created_atstring date-time required

Refund creation timestamp (UTC, RFC 3339).

external_reference_idstring nullable

External reference identifier provided by the client

failed_messagestring nullable

Error message if the refund failed

idinteger required

Refund identifier

status'pending' | 'processing' | 'success' | 'cancelled' | 'failed' required
transaction_idinteger required

Original transaction identifier

updated_atstring date-time required

Last update timestamp (UTC, RFC 3339).

Example response

{
  "cancelled_at": "2026-05-28T14:30:00Z",
  "created_at": "2026-05-28T14:30:00Z",
  "updated_at": "2026-05-28T14:30:00Z"
}