Skip to main content

Pix Refund

Refunds — lifecycle and error codes.

API: PUT /v1/pix/refund/{endToEndId}, GET /v1/pix/refund/{endToEndId}

StatusMeaning
PROCESSINGRefund submitted; not yet final
REFUNDEDRefund completed
NOT_EXECUTEDRefund could not be executed

Webhook statuses for Refund: see Webhook events.

Error codes​

BAD_REQUEST (400)​

Error codeDescription
InvalidContentTypeRefund body must be sent as application/json.
InvalidJSONRefund request body could not be parsed.
InvalidParameterPath or body parameters failed validation.

NOT_FOUND (404)​

Error codeDescription
NotFoundOriginal Pix transaction or refund record was not found.

INTERNAL_SERVER_ERROR (500)​

Error codeDescription
InternalErrorRefund could not be processed due to an internal error.

See also HTTP errors.