v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBDisputes
Update Dispute
Updates the evidence on a dispute, and optionally submits it to the card network.
Saves the provided evidence fields, leaving any omitted fields unchanged; a file field sent as "" is cleared. File fields reference Flex file IDs that must have purpose dispute_evidence; they are resolved to the underlying card-network files before submission. When submit is true, the evidence is finalized and submitted to the network to contest the dispute — evidence cannot be edited after submission.
The dispute must be in a needs_response or warning_needs_response status.
post/v1/disputes/{dispute_id}
Path parameters
dispute_idstring required
Example:fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA
Request body
Example request
{
"dispute": {
"evidence": {},
"submit": false
}
}Response
An envelope wrapping a single dispute object.
Example response
{
"dispute": {
"dispute_id": "fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"payment_intent_id": "fpi_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"checkout_session_id": "fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"amount": 2500,
"currency": "usd",
"charge_id": "fch_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"metadata": {
"order_id": "8842",
"channel": "shopify"
},
"created_at": "2026-06-15T14:30:00Z",
"status": "lost",
"reason": "bank_cannot_process",
"is_charge_refundable": false,
"evidence": {},
"evidence_details": {},
"payment_method_details": {},
"test_mode": false,
"client_reference_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
}
}