Devoluções Pix

Devolve um Pix recebido pela conta autenticada.

Regras

• O Pix original precisa ter esta conta como recebedora. Outro e2eid é recusado.
• valor é decimal (ex.: 50.00).
• A soma das devoluções com status DEVOLVIDO mais o valor pedido não pode ser maior que o valor original.
• Se existir devolução EM_PROCESSAMENTO para o mesmo Pix, a nova solicitação é recusada.
• NAO_REALIZADO não entra na soma.

Endpoints

Listar

GET /api/v2/pix/devolucoes

Scope: pix.refunds.read

Consultar

GET /api/v2/pix/{e2eid}/devolucoes/{txid}

Scope: pix.refunds.read

Solicitar

PUT /api/v2/pix/{e2eid}/devolucoes/{txid}

Scope: pix.refunds.write

Body

{
  "valor": 50.00,
  "motivo": "Devolução solicitada pelo usuário",
  "descricao": "opcional"
}

e2eid é o end-to-end do Pix original. txid identifica esta devolução.

Retorno (200)

id, endToEndId, valor, status (EM_PROCESSAMENTO, DEVOLVIDO ou NAO_REALIZADO), horario.

Recusa de dono ou de valor: HTTP 400 com message.

Contrato: Listar, Consultar, Solicitar.