---
title: "Submit an Issuing dispute"
method: POST
path: "/issuing/disputes/{disputeId}/submit"
tags: ["Issuing disputes"]
deprecated: true
---

# Submit an Issuing dispute

`POST /issuing/disputes/{disputeId}/submit`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/disputes/{disputeId}/submit`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:disputes-write`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/disputes/:disputeId/submit/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p>
Use the <a target="_blank" href="https://api-reference.checkout.com/tag/Issuing-disputes#operation/createDispute">Create an Issuing dispute</a> endpoint instead to create and submit a dispute in a single step.

You can also use the <a target="_blank" href="https://api-reference.checkout.com/tag/Issuing-disputes#operation/amendDispute">Amend</a> 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` string, required: The unique identifier for the Issuing dispute.

## Headers

- `Cko-Idempotency-Key` string, required

## Request body

- SubmitDisputeRequest
  - `reason` string: The updated four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes#Mastercard). If not provided, Checkout.com uses the existing reason code.
  - `evidence` IssuingDisputeEvidence[]: Your evidence for the chargeback, if updated since you created the dispute.
    - `name` string, required: The complete file name, including the extension.
    - `content` string, required: The base64-encoded string that represents a single JPG, PDF, TIFF, or ZIP file. ZIP files can contain multiple JPG, PDF, or TIFF files.
    - `description` string: A brief description of the evidence.
  - `amount` number: The updated disputed amount, in the [minor unit](https://www.checkout.com/docs/payments/accept-payments/format-the-payment-amount) of the transaction or representment currency. If not provided, Checkout.com uses the existing disputed amount.

## Response `200`

Issuing dispute submitted successfully

- GetDisputeResponse: The client's dispute view.
  - `id` string: The unique identifier for the Issuing dispute.
  - `reason` string: The four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes#Mastercard) you provide for the chargeback.
  - `disputed_amount` IssuingTransactionAmount
    - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
    - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
  - `status` 'created' | 'canceled' | 'processing' | 'action_required' | 'won' | 'lost': The [dispute status](https://www.checkout.com/docs/developer-resources/codes/issuing-dispute-codes) as returned to the client.
  - `status_reason` '' | 'expired' | 'chargeback_pending' | 'chargeback_change_requested' | 'chargeback_evidence_invalid_or_insufficient' | 'chargeback_processed' | 'chargeback_rejected' | 'chargeback_reversal_pending' | 'chargeback_reversed' | 'chargeback_response_accepted' | 'prearbitration_pending' | 'escalation_change_requested' | 'prearbitration_evidence_invalid_or_insufficient' | 'prearbitration_processed' | 'prearbitration_rejected' | 'prearbitration_reversal_pending' | 'prearbitration_reversed' | 'prearbitration_response_accepted' | 'arbitration_pending' | 'arbitration_processed' | 'presentment_reversed': The status reason as returned to the client. An empty string indicates no status reason currently applies.
  - `transaction_id` string: The transaction's unique identifier.
  - `presentment_message_id` string: The message's unique Checkout.com identifier.
  - `merchant` IssuingDisputeMerchant
    - `id` string: The merchant's identifier. This can vary from one acquirer to another.
    - `name` string: The merchant's name.
    - `city` string: The city where the merchant is located.
    - `state` string: The state where the merchant is located (US only).
    - `country_code` string: The two-digit [country code](https://www.checkout.com/docs/developer-resources/codes/country-codes) where the merchant is located.
    - `category_code` string: The merchant's [category code](https://www.checkout.com/docs/developer-resources/testing/codes/merchant-category-codes) for the disputed transaction.
    - `evidence` IssuingFileId[]: Any evidence submitted by the merchant during the dispute lifecycle.
  - `created_on` string, date-time: The date and time when the dispute was created, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `modified_on` string, date-time: The date and time when the dispute was last modified, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `action_details` IssuingDisputeActionDetails: Provides instructions on the amendments required before the dispute can proceed, if the dispute `status` is `action_required`. Use the <a target="_blank" href="https://api-reference.checkout.com/tag/Issuing-disputes#operation/amendDispute">Amend an Issuing dispute</a> endpoint to submit your amendments. Use the correct endpoint to send your updates as requested.
    - `instructions` string: The amendments required before the dispute can proceed. For example, if you need to provide a reason code, or update the submitted evidence.
    - `last_action_response` string: Specifies whether the dispute was previously amended and an action response was provided.
  - `chargeback` IssuingDisputeChargeback: The dispute details at the chargeback stage.
    - `submitted_on` string, date-time: The date and time when the chargeback was successfully submitted to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `reason` string: The four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes#Mastercard) you provide for the chargeback.
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `evidence` object[]: Your evidence for the chargeback.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
    - `justification` string: A brief description of why the dispute is being raised. This is forwarded to the scheme.
  - `representment` IssuingDisputeSecondPresentment: The information provided by the merchant when they reject the chargeback and send a representment.
    - `received_on` string, date-time: The date and time when you received the representment, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `evidence` object[]: The evidence provided by the merchant against the chargeback.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
  - `pre_arbitration` IssuingDisputePreArbitration: The dispute details at the pre-arbitration stage.
    - `submitted_on` string, date-time: The date and time when the pre-arbitration was successfully escalated to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `evidence` object[]: The evidence relating to the Issuing dispute provided at the pre-arbitration stage.
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `reason_change` IssuingDisputeReasonChange: The change to the dispute reason and your justification for changing it.
      - `reason` string, required: The updated four-digit scheme-specific [reason code](https://www.checkout.com/docs/developer-resources/codes/chargeback-codes) for the chargeback.
      - `justification` string, required: Your justification for changing the dispute reason. Allowed characters are: - Letters - Numbers - Spaces - The following special characters: <br> `~!@#$%^&*()_+{}|:"<>?,./;'[]-=`.
    - `justification` string: Your justification for escalating the dispute to pre-arbitration.
    - `merchant_responded_on` string, date-time: The date and time when the merchant provided evidence against the pre-arbitration, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `merchant_evidence` object[]
      - `file_id` string, required: The unique Checkout.com identifier for the uploaded file.
      - `description` string: A brief description of the evidence.
  - `arbitration` IssuingDisputeArbitration: The dispute details during the arbitration stage.
    - `submitted_on` string, date-time: The date and time when the arbitration was successfully escalated to the card scheme, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
    - `amount` IssuingTransactionAmount
      - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `justification` string: Your justification for escalating the dispute to arbitration.
    - `decided_on` string, date-time: The date and time when the card scheme decided the arbitration case, in UTC. <br/>Format – ISO 8601 code <br/>Example – `2025-01-31T10:20:30.456`
  - `_links` object: The links related to the dispute.
    - `self` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `card` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `cardholder` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `transaction` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `amend` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `escalate` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `cancel` IssuingLink
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized Request
- `404`: Issuing dispute not found
- `409`: Issuing dispute cannot be submitted
- `422`: Request missing required information

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)