Consultar devolução

get https://api.pix.voluti.com.br/pix/{e2eid}/devolucao/{id}

Use este endpoint para consultar uma devolução através de um e2eid do Pix e do id da devolução.

Responses

Response body

object

string

required

Identificação gerada pelo cliente para representar uma devolução.

rtrId

string

required

length between 32 and 32

ReturnIdentification é utilizado para identificar de forma única uma transação de devolução na mensagem PACS.004. Ele assegura a correta associação entre a devolução e a transação original.

A utilização do ReturnIdentification garante a integridade e a rastreabilidade das devoluções no sistema de pagamentos.

valor

string

required

Valor da devolução.

natureza

string

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),
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).

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);
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);
- Quando a devolução for referente ao troco, o valor limita-se ao valor do troco (a natureza nesse caso deve ser RETIRADA).

ORIGINAL RETIRADA MED_OPERACIONAL MED_FRAUDE

descricao

string

length ≤ 140

O campo descricao é opcional e permite que informações sobre a devolução sejam apresentadas ao pagador. Na mensagem PACS.004, este campo é preenchido pelo PSP do recebedor e inserido no campo RemittanceInformation.

horario

object

required

solicitacao

date-time

Horário no qual a devolução foi solicitada no PSP.

liquidacao

date-time

Horário no qual a devolução foi liquidada no PSP.

status

string

required

Status da devolução.

EM_PROCESSAMENTO DEVOLVIDO NAO_REALIZADO

motivo

string

length ≤ 140

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.

Language

Credentials

OAuth2


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.pix.voluti.com.br/pix/e2eid/devolucao/id \
3
     --header 'accept: application/json'


xxxxxxxxxx
 
1
{
2
  "id": "123456",
3
  "rtrId": "D12345678202009091000abcde123456",
4
  "valor": "7.89",
5
  "horario": {
6
    "solicitacao": "2020-09-11T15:25:59.411Z"
7
  },
8
  "status": "EM_PROCESSAMENTO"
9
}

200Dados da devolução.

403Requisição de participante autenticado que viola alguma regra de autorização.

404Recurso solicitado não foi encontrado.

503Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.