KIkiwify
PIX Refunds

Get Refund

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

get/v1/refunds/{id}

Request

  • Base URL
    https://conta-public-api.kiwify.com
  • URL
    https://conta-public-api.kiwify.com/v1/refunds/{id}
  • Auth
    API key in header x-access-id and API key in header X-PoP-Challenge and API key in header X-PoP-Format and API key in header X-PoP-Signature

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"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.