Skip to main content

​
Resumo

  • Método: POST
  • Rota: /api/pix/refund-in/{id}
  • Autenticação: Authorization: Bearer <seu_api_token>

​
Path (crítico)

{id} = UUID do cash-in retornado no POST /api/pix/cash-in (campo id). Não use o transactionId do BaaS neste path.

​
Corpo (exemplo)

{
  "refundValue": 150.75,
  "reason": "Pedido cancelado pelo cliente",
  "externalId": "estorno-12345"
}
CampoObrigatório
refundValueSim (BRL)
reasonNão
externalIdNão (pode ser gerado se omitido)

​
Regras (alto nível)

  • Cash-in em PAID
  • Prazo 89 dias após o recebimento
  • Soma de devoluções ≤ valor original; parciais múltiplos permitidos; competição por teto (pendentes/confirmados)

​
Resposta

201 com identificador do refund-in (ver implementação) — a consulta pública de refund usa o id do refund em GET /api/pix/refund/{id}.

​
HTTP

  • 201 Criado.
  • 4xx/422 Regras de negócio (ver mensagens).
  • 500 Interno.

​
Ver