POST /v2/pix/refund - NavePay

URL: POST https://seu-dominio.com/v2/pix/refund Autenticação: Authorization: Bearer {access_token}

Corpo (JSON)

Campo	Tipo	Obrigatório	Descrição
`pix_id`	string	sim	ID da transação no provedor (identificador da liquidação)
`amount`	number	sim	Valor a devolver (> 0, ≤ restante elegível)
`description`	string	não	Motivo / descrição (truncada no envio ao provedor)

Elegibilidade

Cash-in pago e pertencente ao integrador.
Valor dentro do máximo ainda reembolsável.
Carteira interna com saldo proporcional para estorno (regra NavePay).

Respostas

200: corpo conforme retorno do provedor em sucesso.
404: transação não encontrada ou não elegível.
422: valor inválido, PIX ainda não sincronizado, saldo insuficiente para estorno interno.
409: reembolso ok no provedor mas falha ao ajustar ledger (raro; mensagem orienta suporte).

curl -s -X POST "https://seu-dominio.com/v2/pix/refund" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pix_id": "ID_NO_PROVEDOR",
    "amount": 10.00,
    "description": "Pedido cancelado"
  }'