Obter uma disputa

Retorna o dispute completo e atual, incluindo valor contestado, charge original, customer, prazo de evidência e status do caso. Use este endpoint quando você já tem o dp_* e precisa reconciliar o estado atual antes de mostrar uma timeline interna, enviar uma defesa ou decidir se ainda é possível reembolsar a charge. Para encontrar disputes por status, charge, customer, payment_intent ou janela de criação, use Listar Disputas.

string

required

ID do dispute (dp_*).

curl -X GET "https://api.chargefy.io/v1/disputes/dp_isLGK1ZB2ZQFwyEg" \
  -H "Authorization: Bearer {{API_KEY}}"

200

{
  "id": "dp_isLGK1ZB2ZQFwyEg",
  "object": "dispute",
  "amount": 15000,
  "charge": "ch_GvBuDg61xJ5U94kc",
  "closed_at": null,
  "created_at": "2026-05-22T03:00:00Z",
  "currency": "brl",
  "customer": "cus_DAoqbf8fnW6W88Ma",
  "evidence": {
    "file": "file_BwrqLeg3Ta1WJsyY"
  },
  "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_AHq52khH3LNsgbDp",
  "reason": "fraudulent",
  "status": "under_review",
  "updated_at": "2026-05-22T18:10:00Z"
}

Campos para observar

Campo	Por que importa
`status`	Mostra se o caso ainda exige defesa (`needs_response`), está em análise (`under_review`) ou já terminou (`won`/`lost`).
`evidence_details.due_by`	Prazo máximo para enviar evidência quando o dispute exige resposta.
`evidence_details.has_evidence`	Indica se já existe defesa registrada.
`evidence_details.submission_count`	Quantas defesas já foram enviadas com sucesso.
`is_charge_refundable`	Ajuda a decidir se ainda faz sentido oferecer reembolso fora do fluxo de contestação.
`reason`	Motivo normalizado da contestação, útil para roteamento de suporte e automação.

Erros comuns

401

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}

404

{
  "error": {
    "code": "resource_missing",
    "message": "Dispute not found.",
    "param": "id",
    "type": "invalid_request_error"
  }
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Obter uma disputa

Campos para observar

Erros comuns

​Campos para observar

​Erros comuns

Campos para observar

Erros comuns