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

Request

Base URL
https://api.withflex.com
URL
https://api.withflex.com/v1/disputes/{dispute_id}/close
Auth
HTTP bearer

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": {
      "access_activity_log": "string",
      "customer_name": "string",
      "customer_email_address": "string",
      "customer_purchase_ip": "string",
      "billing_address": "string",
      "shipping_address": "string",
      "shipping_tracking_number": "string",
      "shipping_carrier": "string",
      "shipping_date": "string",
      "service_date": "string",
      "product_description": "string",
      "refund_policy_disclosure": "string",
      "refund_refusal_explanation": "string",
      "cancellation_policy_disclosure": "string",
      "cancellation_rebuttal": "string",
      "duplicate_charge_explanation": "string",
      "duplicate_charge_id": "string",
      "uncategorized_text": "string",
      "customer_communication": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "customer_signature": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "shipping_documentation": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "receipt": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "duplicate_charge_documentation": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "service_documentation": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "uncategorized_file": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "cancellation_policy": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      },
      "refund_policy": {
        "file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "filename": "string",
        "stripe_file_id": "string"
      }
    },
    "evidence_details": {
      "due_by": "2026-06-15T14:30:00Z",
      "has_evidence": false,
      "past_due": false,
      "submission_count": 3
    },
    "balance_transactions": [
      {
        "balance_transaction_id": "fbtxn_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
        "amount": 2500,
        "fee": 2500,
        "net": 2500,
        "status": "available",
        "type": "string",
        "reporting_category": "example_value",
        "category": "example_value",
        "created_at": "2026-06-15T14:30:00Z"
      }
    ],
    "payment_method_details": {
      "type": "string",
      "card": {
        "brand": "visa",
        "network_reason_code": "example_value"
      }
    },
    "test_mode": false,
    "client_reference_id": "obj_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.