v1

latestOpenAPI 3.1.02026-07-2684271522.2 KB

Disputes

Close Dispute

Closes a dispute, accepting it as lost and forfeiting the disputed funds.

Use this when you do not wish to contest the dispute. Closing is irreversible: it forfeits the disputed amount and the dispute fee, and no further evidence can be submitted. The dispute must be in a needs_response or warning_needs_response status.

post/v1/disputes/{dispute_id}/close

Path parameters

dispute_idstring required

Example:fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA

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"
  }
}