Skip to main content
Um refund representa a reversão de parte ou de todo o valor capturado em uma charge. Ele sempre aponta para a charge original e, quando disponíveis, para o payment_intent e o customer relacionados. Refunds têm ciclo próprio: podem começar como pending ou requires_action e depois mudar para succeeded, failed ou canceled. O valor disponível para refund é calculado a partir da charge capturada menos os refunds já em andamento ou concluídos. Fees cobradas pela Chargefy não são devolvidas quando um refund é criado.

​
Data Object

Este é o formato completo retornado em create, get, itens de list e em data.object dos webhooks refund.*. 
{
  "id": "re_123",
  "object": "refund",
  "amount": 5000,
  "balance_transaction": null,
  "charge": "ch_123",
  "created_at": "2026-05-20T18:35:00Z",
  "currency": "brl",
  "customer": "cus_123",
  "description": null,
  "destination_details": null,
  "failure_balance_transaction": null,
  "failure_reason": null,
  "instructions_email": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_intent": "pi_123",
  "pending_reason": null,
  "reason": "requested_by_customer",
  "receipt_number": null,
  "source_transfer_reversal": null,
  "status": "succeeded",
  "transfer_reversal": null,
  "updated_at": "2026-05-20T18:35:00Z"
}
​
id
string
Identificador do refund. Usa o prefixo re_*.
​
object
string
Sempre "refund".
​
amount
integer
Valor do refund, em centavos.
​
balance_transaction
string | null
Reservado para a transação financeira associada ao refund. Retorna null enquanto não houver ledger público para expor.
​
charge
string
ID da charge original (ch_*).
​
currency
string
Moeda em código de 3 letras minúsculas, como brl.
​
destination_details
object | null
Detalhes de destino ou referência bancária do refund quando disponíveis.
​
failure_reason
string | null
Motivo da falha quando status é failed. Pode ser declined, insufficient_funds, merchant_request, unknown e outros motivos financeiros.
​
metadata
object
Pares chave-valor livres enviados na criação. Quando vazio, retorna {}.
​
reason
string | null
Motivo informado na criação do refund: duplicate, fraudulent ou requested_by_customer. Chargeback/dispute não é motivo de refund; é um fluxo separado.
​
status
string
Estado do refund: pending, requires_action, succeeded, failed ou canceled.