Solicitar devolução

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

Use este endpoint para solicitar uma devolução através de um e2eid do Pix e do id da devolução. O motivo que será atribuído à PACS.004 será "MD06" ou "SL02" de acordo com a aba RTReason da PACS.004 que consta no Catálogo de Mensagens do Pix a depender da natureza da devolução (Vide a descrição deste campo).

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

e2eid

string

required

length between 32 and 32

O identificador da transação ou End to End ID é utilizado para identificar um pagamento Pix realizado contemplando todo o mercado que transita na PACS002, PACS004 e PACS008.

PACS.002: Mensagem de status de pagamento. Utiliza o EndToEndIdentification para relacionar a resposta ao pagamento original.
PACS.004: Mensagem de devolução de pagamento. Garante que a devolução seja associada corretamente ao pagamento inicial.
PACS.008: Mensagem de crédito interbancário. Rastreia o pagamento da origem ao destino final.

string

required

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

Body Params

Dados para pedido de devolução.

valor

string

required

Valor solicitado para devolução. A soma dos valores de todas as devolucões não podem ultrapassar o valor total do Pix.

natureza

string

Indica qual é a natureza da devolução solicitada. Uma solicitação de devolução pelo usuário recebedor pode ser relacionada a um Pix
comum (com código: MD06 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).

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 deve ser: ORIGINAL);
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); 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

length ≤ 140

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.

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 PUT \
2
     --url https://api.pix.voluti.com.br/pix/e2eid/devolucao/id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: 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
}

201Dados da devolução.

400Requisição com formato inválido.

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.