deprecated

Submit an Issuing dispute

​

Beta

Use the Create an Issuing dispute endpoint instead to create and submit a dispute in a single step.

You can also use the Amend endpoint to submit changes if the dispute status is action_required. This endpoint may still be used to re-submit after a rejected submission or to re-attempt an escalation; existing clients will receive advance communication when the new re-open flow is available.

Path Parameters
  • disputeId
    Type: string ·
    min length:  
    31
    max length:  
    31    Pattern: ^idsp_[a-z0-9]{26}$
    required

    The unique identifier for the Issuing dispute.

Headers
  • Cko-Idempotency-Key
    Type: string
    min length:  
    1
    max length:  
    256    Pattern: ^[A-Za-z0-9._-]+$
    required

    An idempotency key for safely retrying requests.

Body·
application/json
  • reason
    Type: string

    The updated four-digit scheme-specific reason code. If not provided, Checkout.com uses the existing reason code.

  • evidence
    Type: array object[] ·

    Your evidence for the chargeback, if updated since you created the dispute.

  • amount
    Type: number

    The updated disputed amount, in the minor unit of the transaction or representment currency. If not provided, Checkout.com uses the existing disputed amount.

Responses
  • application/json
Request Example for post/issuing/disputes/{disputeId}/submit
curl 'https://{prefix}.api.sandbox.checkout.com/issuing/disputes/idsp_fa6psq242dcd6fdn5gifcq1491/submit' \
  --request POST \
  --header 'Cko-Idempotency-Key: 7c1b9f96-4f2e-4b1a-bc2b-3d0f1a2e9f3a' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "reason": "4807",
  "evidence": [
    {
      "name": "evidence.pdf",
      "content": "",
      "description": "Goods were not received."
    }
  ],
  "amount": 100
}'

{
  "id": "idsp_fa6psq242dcd6fdn5gifcq1491",
  "reason": "4802",
  "disputed_amount": {
    "amount": 100,
    "currency": "USD"
  },
  "status": "processing",
  "status_reason": "chargeback_processed",
  "transaction_id": "trx_aayhhfwbdyxwcaeyhhfwbd4xga",
  "presentment_message_id": "msg_fa6psq242dcd6fdn5gifcq1491",
  "merchant": {
    "id": "(*)123456789",
    "name": "Software Company",
    "city": "Paris",
    "state": "",
    "country_code": "FR",
    "category_code": "5331",
    "evidence": [
      "file_6lbss42ezvoufcb2beo76rvwly"
    ]
  },
  "created_on": "2026-09-23T13:52:07.856Z",
  "modified_on": "2026-09-23T13:52:07.856Z",
  "action_details": {
    "instructions": "string",
    "last_action_response": "string"
  },
  "chargeback": {
    "submitted_on": "2025-09-10T10:11:12Z",
    "reason": "4802",
    "amount": {
      "amount": 100,
      "currency": "USD"
    },
    "evidence": [
      {
        "file_id": "file_6lbss42ezvoufcb2beo76rvwly",
        "description": "Goods were not received."
      }
    ],
    "justification": "string"
  },
  "representment": {
    "received_on": "2026-09-23T13:52:07.856Z",
    "amount": {
      "amount": 100,
      "currency": "USD"
    },
    "evidence": [
      {
        "file_id": "file_6lbss42ezvoufcb2beo76rvwly",
        "description": "Goods were not received."
      }
    ]
  },
  "pre_arbitration": {
    "submitted_on": "2025-09-10T10:11:12Z",
    "evidence": [
      {
        "file_id": "file_6lbss42ezvoufcb2beo76rvwly",
        "description": "Goods were not received."
      }
    ],
    "amount": {
      "amount": 100,
      "currency": "USD"
    },
    "reason_change": {
      "reason": "4807",
      "justification": "string"
    },
    "justification": "string",
    "merchant_responded_on": "2026-09-23T13:52:07.856Z",
    "merchant_evidence": [
      {
        "file_id": "file_6lbss42ezvoufcb2beo76rvwly",
        "description": "Goods were not received."
      }
    ]
  },
  "arbitration": {
    "submitted_on": "2025-09-10T10:11:12Z",
    "amount": {
      "amount": 100,
      "currency": "USD"
    },
    "justification": "string",
    "decided_on": "2025-01-31T10:20:30Z"
  },
  "_links": {
    "self": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "card": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "cardholder": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "transaction": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "amend": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "escalate": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    },
    "cancel": {
      "href": "string",
      "actions": [
        "GET"
      ],
      "types": [
        "string"
      ]
    }
  }
}

Issuing dispute submitted successfully