Disputas
Obter uma disputa
Retorna um dispute pelo ID.
curl -X GET "https://api.chargefy.io/v1/disputes/dp_isLGK1ZB2ZQFwyEg" \
-H "Authorization: Bearer {{API_KEY}}"
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.
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": {
"access_activity_log": null,
"billing_address": null,
"cancellation_policy": null,
"cancellation_policy_disclosure": null,
"cancellation_rebuttal": null,
"customer_communication": null,
"customer_email_address": "[email protected]",
"customer_name": "Comprador",
"customer_purchase_ip": "187.34.12.90",
"customer_signature": null,
"duplicate_charge_documentation": null,
"duplicate_charge_explanation": null,
"duplicate_charge_id": null,
"product_description": "Assinatura mensal do plano Pro, com acesso imediato",
"receipt": "file_BwrqLeg3Ta1WJsyY",
"refund_policy": null,
"refund_policy_disclosure": null,
"refund_refusal_explanation": null,
"service_date": null,
"service_documentation": null,
"shipping_address": null,
"shipping_carrier": null,
"shipping_date": null,
"shipping_documentation": null,
"shipping_tracking_number": null,
"uncategorized_file": null,
"uncategorized_text": null
},
"evidence_details": {
"due_by": "2026-05-28T03:00:00Z",
"has_evidence": true,
"past_due": false,
"submission_count": 1
},
"is_charge_refundable": false,
"livemode": true,
"metadata": {},
"payment_intent": "pi_AHq52khH3LNsgbDp",
"reason": "fraudulent",
"status": "under_review",
"transactions": [
{
"id": "txn_Qm3vR8kZp2LwN7cT",
"object": "transaction",
"affiliate_fee_rate": null,
"affiliation": null,
"amount": -14415,
"available_at": "2026-05-22T03:00:00Z",
"created_at": "2026-05-22T03:00:00Z",
"currency": "brl",
"description": "Dispute",
"exchange_rate": null,
"expected_payout_at": null,
"fee_amount": 256,
"fee_details": [
{
"affiliation": null,
"amount": 256,
"currency": "brl",
"description": "Dispute received fee",
"type": "dispute_received_fee"
}
],
"installment": null,
"installment_count": null,
"livemode": true,
"metadata": {},
"net_amount": -14671,
"payment_intent": "pi_AHq52khH3LNsgbDp",
"settled_at": "2026-05-22T03:00:00Z",
"source": "dp_isLGK1ZB2ZQFwyEg",
"source_organization": "org_Nt99XL6FzLb1oCxT",
"status": "paid",
"type": "adjustment",
"updated_at": "2026-05-22T03:00:00Z"
}
],
"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 | Os 27 campos nomeados da defesa — texto e arquivos (file_*) —, sempre presentes e null quando vazios. |
evidence_details.due_by | Prazo máximo para preencher evidence e enviar a defesa quando o dispute exige resposta. |
evidence_details.has_evidence | Indica se algum campo de evidence está preenchido. |
evidence_details.submission_count | 1 depois que a defesa foi enviada — o envio é único. |
is_charge_refundable | false com a disputa aberta ou perdida: o refund da charge responde 409 charge_disputed. |
reason | Motivo normalizado da disputa, útil para roteamento de suporte e automação. |
Erros comuns
401
{
"error": {
"code": "authentication_failed",
"message": "Invalid API Key provided: ch_live_***************************************9f2c",
"type": "authentication_error"
}
}
404
{
"error": {
"code": "resource_missing",
"message": "No such dispute",
"type": "invalid_request_error"
}
}
⌘I
curl -X GET "https://api.chargefy.io/v1/disputes/dp_isLGK1ZB2ZQFwyEg" \
-H "Authorization: Bearer {{API_KEY}}"

