Estornos e chargebacks

Estornar é devolver o dinheiro. Também é um ato operacional fino: parcial ou total, por carteira, com rastreio e reconciliação exata.

Estorno total e parcial

O estorno é atrelado a uma carga e a uma carteira de origem do dinheiro. Você pode devolver o valor cheio ou uma fração, e o estado da cobrança reflete o que sobrou.

Estorno total: a cobrança termina em refunded.
Estorno parcial: a cobrança termina em partially_refunded.
Falha no estorno é sinalizada como refund_error, pronta para retentativa.

POST /api/v1/bank/wallet/charge/<charge_uuid>/refund/<wallet_uuid>/

O ciclo completo do chargeback

Estado	Significado
chargeback	Disputa aberta pelo banco do portador
chargeback_requested	Chargeback tecido pelo emissor
chargeback_disputed	Você contestou a disputa
chargeback_won	Disputa vencida — valores de volta
chargeback_lost	Disputa perdida — valor retido
chargeback_reversed	Disputa revertida a seu favor
chargeback_refunded	Valor devolvido pela plataforma após o desfecho
pre_chargeback_resolution	Prevenção de chargeback em andamento

Conciliação contábil

Do ponto de vista de saldo, um chargeback perdido movimenta a carteira como uma reversão. Mantenha os estados anteriores na sua trilha de auditoria para reconciliar exatamente.