Skip to main content
Um dispute representa uma contestação aberta sobre uma charge. Ele aponta para a charge original e acompanha o prazo de evidência, o envio da defesa e a decisão final. O status público permanece under_review enquanto a análise final está em andamento. A decisão final muda o objeto para won ou lost.

​
Data Object

Este é o formato completo retornado em get, itens de list, update, close e em data.object dos webhooks charge.dispute.*. 
{
  "id": "dp_123",
  "object": "dispute",
  "amount": 15000,
  "charge": "ch_123",
  "closed_at": null,
  "created_at": "2026-05-22T03:00:00Z",
  "currency": "brl",
  "customer": "cus_123",
  "evidence": {
    "file": "file_123"
  },
  "evidence_details": {
    "due_by": "2026-05-29T03:00:00Z",
    "has_evidence": true,
    "past_due": false,
    "submission_count": 1
  },
  "is_charge_refundable": true,
  "livemode": true,
  "metadata": {},
  "payment_intent": "pi_123",
  "reason": "fraudulent",
  "status": "under_review",
  "updated_at": "2026-05-22T18:10:00Z"
}
​
id
string
Identificador do dispute. Usa o prefixo dp_*.
​
object
string
Sempre "dispute".
​
amount
integer
Valor contestado, em centavos.
​
charge
string
ID da charge contestada (ch_*).
​
evidence
object
Evidências associadas à defesa. Quando houver arquivo, file aponta para o arquivo registrado na Chargefy.
​
evidence_details
object
Estado da evidência: prazo, presença de arquivo, atraso e quantidade de envios.
​
is_charge_refundable
boolean
Indica se a charge ainda pode receber refund.
​
metadata
object
Pares chave-valor livres. Quando vazio, retorna {}.
​
reason
string | null
Motivo normalizado quando disponível: fraudulent, product_not_received, product_unacceptable, duplicate, credit_not_processed, subscription_canceled, unrecognized ou general.
​
status
string
Estado do dispute: warning_needs_response, warning_under_review, warning_closed, needs_response, under_review, won ou lost.