Cartão

Estornar cobrança

POST/api/v1/charges/{id}/refund

Estorna integralmente uma cobrança paga. O valor é devolvido ao pagador pelo adquirente e o saldo correspondente é debitado da conta.

Somente cobranças com status paid podem ser estornadas. Estorno total (sem parcial) no v1. O suporte depende do adquirente que processou a cobrança.

Requisição

curl -X POST https://beta.venopayments.com/api/v1/charges/{id}/refund \
  -H "Authorization: Bearer veno_live_..."

Resposta · 200

{
  "id": "uuid-do-deposito",
  "status": "refunded",
  "amount": 10000,
  "refunded_at": "2026-06-26T12:34:56Z"
}

Erros

404Cobrança não encontrada para esta conta.

409Cobrança não está em estado estornável (somente paid).

422Estorno não suportado pelo adquirente da cobrança.