Verificar status do estorno de um Pix (Assíncrono)
POST
/api/Pix/DevolucaoPixConsulta
Pix
Funcionalidade principal
Como o processo de devolução é assíncrono, esta consulta é fundamental para confirmar se o valor foi efetivamente retornado ao pagador. A requisição utiliza o End2Endda operação de devolução (retornado no momento da solicitação de estorno) para rastrear o seu progresso e resultado final (ex: "Concluído", "Falha").
Casos de uso comuns
1.
2.
3.
Nota importante: O End2Enda ser enviado neste endpoint não é o da transação de pagamento original. É o identificador específico da transação de devolução, que é gerado e retornado pela API "Devolução do PIX (Parcial ou Inteiro)".
Requisição
Parâmetros Header
Parâmetros Bodyapplication/jsonNecessário
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/Pix/DevolucaoPixConsulta' \
--header 'UserName;' \
--header 'RequestOrigin;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"Data": {
"CodigoCanal": 0,
"CodigoCliente": 0,
"End2End": "string"
}
}'Response Response Example
{
"Data": {
"CodigoCanal": 0,
"CodigoCliente": 0,
"LpfId": 0,
"ValorOriginal": 0,
"ValorDisponivelDevolucao": 0,
"SomaValoresDevovidos": 0,
"DataTransacao": "2019-08-24T14:15:22.123Z",
"DescricaoTransacao": "string",
"DataLimiteDevolucaoPix": "2019-08-24T14:15:22.123Z",
"DestinatarioNome": "string",
"DestinatarioInstituicao": "string"
},
"ResultCode": 0,
"Message": "string",
"ValidationData": {
"ResultCode": 0,
"Message": "string",
"Errors": [
{
"ErrorMessage": "string",
"FieldName": "string"
}
]
}
}Modificado em 2026-03-03 15:10:25