---
title: "Consultar devolução."
method: GET
path: "/pix/{e2eid}/devolucao/{id}"
tags: ["Pix"]
---

# Consultar devolução.

`GET /pix/{e2eid}/devolucao/{id}`

Endpoint para consultar uma devolução através de um End To End ID do Pix e do ID da devolução

## Response `200`

Dados da devolução.

- Devolucao
  - `id` string, required — Id gerado pelo cliente para representar unicamente uma devolução.
  - `rtrId` string, required — ReturnIdentification que transita na PACS004.
  - `valor` string, required — Valor a devolver.
  - `natureza` 'ORIGINAL' | 'RETIRADA' | 'MED_OPERACIONAL' | 'MED_FRAUDE' | 'MED_PIX_AUTOMATICO' — Indica qual é a natureza da devolução. Uma devolução pode ser relacionada a um Pix comum (com códigos possíveis: `MD06`, `BE08` e `FR01` da pacs.004 e `REFU` da pacs.008), ou a um Pix de Saque ou Troco (com códigos possíveis: `MD06` e `SL02` da pacs.004). Na ausência deste campo a natureza deve ser interpretada como sendo de um Pix comum (`ORIGINAL`). As naturezas são assim definidas: - `ORIGINAL`: quando a devolução é solicitada pelo usuário recebedor e se refere a um Pix comum ou ao valor da compra em um Pix Troco (`MD06`); - `RETIRADA`: quando a devolução é solicitada pelo usuário recebedor e se refere a um Pix Saque ou ao valor do troco em um Pix Troco (`SL02`); - `MED_OPERACIONAL`: quando a devolução ocorre no âmbito do MED por motivo de falha operacional e se refere a um Pix comum (`BE08`); - `MED_FRAUDE`: quando a devolução ocorre no âmbito do MED por fundada suspeita de fraude e se refere a um Pix comum (`FR01`). - `MED_PIX_AUTOMATICO`: reembolso total ou parcial ao participante do usuário pagador no âmbito do MED (Mecanismo Especial de Devolução) para o Pix Automático pela utilização de recursos próprios para ressarcimento do usuário pagador.(`REFU`); Os valores de devoluções são sempre limitados aos valores máximos a seguir: - Pix comum: o valor da devolução é limitado ao valor do próprio Pix (a natureza nesse caso pode ser: ORIGINAL, MED_OPERACIONAL ou MED_FRAUDE); - Pix Saque: o valor da devolução é limitado ao valor da retirada (a natureza nesse caso deve ser: RETIRADA); e - Pix Troco: o valor da devolução é limitado ao valor relativo à compra ou ao troco: - Quando a devolução for referente à compra, o valor limita-se ao valor da compra (a natureza nesse caso deve ser ORIGINAL); e - Quando a devolução for referente ao troco, o valor limita-se ao valor do troco (a natureza nesse caso deve ser RETIRADA).
  - `descricao` string — O campo `descricao`, opcional, determina um texto a ser apresentado ao pagador contendo informações sobre a devolução. Esse texto será preenchido, na pacs.004, pelo PSP do recebedor, no campo RemittanceInformation. O tamanho do campo na pacs.004 está limitado a 140 caracteres.
  - `horario` object, required
    - `solicitacao` string, date-time — Horário no qual a devolução foi solicitada no PSP.
    - `liquidacao` string, date-time — Horário no qual a devolução foi liquidada no PSP.
  - `status` 'EM_PROCESSAMENTO' | 'DEVOLVIDO' | 'NAO_REALIZADO', required — Status da devolução.
  - `motivo` string — # Status da Devolução Campo opcional que pode ser utilizado pelo PSP recebedor para detalhar os motivos de a devolução ter atingido o status em questão. Pode ser utilizado, por exemplo, para detalhar o motivo de a devolução não ter sido realizada.

## Other responses

- `403` — Requisição de participante autenticado que viola alguma regra de autorização.
- `404` — Recurso solicitado não foi encontrado.
- `503` — Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.

## Changes

- **2024-08-30** `e60160879b89` — 1 warning
  - added the new `MED_PIX_AUTOMATICO` enum value to the `natureza` response property for the response status `200`
- **2021-10-29** `6f97f801c056` — 2 warning
  - added the new `MED_FRAUDE` enum value to the `natureza` response property for the response status `200`
  - added the new `MED_OPERACIONAL` enum value to the `natureza` response property for the response status `200`
- **2021-09-20** `8bf881e6822d` — 1 info
  - added the optional property `descricao` to the response with the `200` status
- **2021-09-02** `715882909c1c` — 1 info
  - added the optional property `natureza` to the response with the `200` status
- **2020-12-03** `1ab8ae73a0ae` — 3 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`

[Full history](https://skmtc.dev/bacen/apis/api-pix/changes/pix/:e2eid/devolucao/:id/get.md)

---

[API](https://skmtc.dev/bacen/apis/api-pix.md) · [All operations](https://skmtc.dev/bacen/apis/api-pix/llms.txt) · [OpenAPI document](https://skmtc.dev/bacen/apis/api-pix/revisions/c1461275c67b?raw)