Estornos e chargebacks

Um estorno (refund) devolve o valor pago ao comprador. O payload de refund é simples: você informa a cobrança, a carteira e o valor.

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

Estorna uma cobrança. Envie o corpo apenas com o valor (parcial) e, opcionalmente, uma URL de webhook específica.

Requisição

POST /bank/wallet/charge/c3d4e5f6-7a8b-9c0d-1e2f-3a4b5c6d7e8f/refund/00000000-0000-0000-0000-000000000000/
Authorization: Bearer <token>
Content-Type: application/json

{
  "amount": 199.90,
  "webhook_refund_url": "https://your-store.com/webhook/refund"
}

Resposta

{
  "charge_uuid": "c3d4e5f6-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
  "local_currency": 199.90,
  "currency": "BRL",
  "usd_currency": 36.34,
  "type": "credit_card",
  "date": "2026-09-14 15:10:22",
  "description": "Order #1234",
  "due_date": "2026-09-30",
  "status": "refunding",
  "message": "Refund in progress"
}

Chargebacks

Quando o comprador contesta a cobrança pelo banco emissor, a cobrança entra em chargeback. O adquirente conduz a contestação conforme as regras das bandeiras; você acompanha pelos status chargeback_won e chargeback_lost e envia documentos pelo portal.

Chargeback recebido: status chargeback. Nenhuma ação de API necessária.
Chargeback ganho: status chargeback_won — valor é mantido.
Chargeback perdido: status chargeback_lost — valor é devolvido.
Reduza chargebacks usando Zeroauth, tokenização e 3DS (veja serviços de cartão).