Get Pix Devolution by ID (V4)
GET/v4/pix/devolutions/:id
Retrieve the state and details of a pix devolution by providing its ID. Uses wallet ID only.
Request
Path Parameters
Devolution ID.
Header Parameters
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
Responses
- 200
- 400
- 401
- 422
The PIX devolution returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Devolution ID.
User defined devolution description.
Error returned when devolution is reverted.
Operation UUID. Used to get receipt and track the transaction.
End to End ID.
Payment txid identifier.
Value in R$ cents.
Possible values: [PENDING
, WAITING
, WAITING_DELAYED
, CONFIRMED
, ERROR
, FAILED
, CANCELED
]
Devolution state.
The payment owner name.
Possible values: [CPF
, CNPJ
]
The payment owner person type.
The payment owner document.
The payment owner bank name.
The payment beneficiary name.
Possible values: [CPF
, CNPJ
]
The payment beneficiary person type.
The payment beneficiary document.
The payment beneficiary bank name.
Devolution created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"description": "The party devolution.",
"failed_message": "Não foi possível processar o seu pedido. Por favor tente novamente.",
"operation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"end_to_end_id": "string",
"txid": "f6e2e084-29b9-4935-a059-5473b13033aa",
"amount": 1299,
"state": "CONFIRMED",
"owner_name": "string",
"owner_person_type": "CPF",
"owner_document": "string",
"owner_bank_name": "string",
"beneficiary_name": "string",
"beneficiary_person_type": "CPF",
"beneficiary_document": "string",
"beneficiary_bank_name": "string",
"created_at": "2025-09-05T14:27:55.312Z"
}
Invalid or missing parameters.
Wallet authentication failed.
Unable to process the provided parameters.