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

​
Corpo (JSON)

CampoTipoObrigatórioDescrição
pix_idstringsimID da transação no provedor (identificador da liquidação)
amountnumbersimValor a devolver (> 0, ≤ restante elegível)
descriptionstringnãoMotivo / 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"
  }'