Dispute Responses

Submit dispute response

post

Submit a response for a specific dispute case, with optional text comments and supporting evidence files.

Body

ResponseTypeinteger · int32Optional

Indicates whether the merchant’s response is accepted or declined. Example: 1 for Accepted, 2 for Declined.

Example: 1

CaseNumberstringOptional

The unique dispute case identification number eligible for Chargeback or Retrieval cases. The dispute case must be Awaiting Response or New Activity.

Example: CN123456789

ResponsestringOptional

The message provided by the merchant for the dispute case. Free text up to 500 characters.

Example: Merchant disagrees with the chargeback.

evidencesstring · binary[]Optional

One or more evidence files included with the dispute case response.

Responses

202

Accepted

application/json

Response containing upload event details for a submitted dispute case response.

responseIdinteger · int32Optional

Unique identifier for the submitted merchant response.

Example: 1

responseMessagestring · nullableOptional

A message confirming the status of the submitted response.

Example: text

caseNumberstring · nullableOptional

Unique dispute case identification number associated with the submitted response.

Example: text

exchangeIdstring · nullableOptional

Identifier used to track the exchange of information with the dispute processing system.

Example: text

correlationIdstring · nullableOptional

Unique identifier used for tracking the request across systems.

Example: 123e4567-e89b-12d3-a456-426614174000

parentIdstring · nullableOptional

Identifier that links the response to a parent transaction or message.

Example: 123e4567-e89b-12d3-a456-426614174000

parentSystemCodestring · nullableOptional

System code for the upstream system that originated the request.

Example: text

merchantNumberstring · nullableOptional

The merchant's unique identification number.

Example: text

204

No Content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

500

Server Error

application/json

post/api/disputes/v2.0/responses

POST /api/disputes/v2.0/responses HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "ResponseType": 1,
  "CaseNumber": "CN123456789",
  "Response": "Merchant disagrees with the chargeback.",
  "evidences": [
    "binary"
  ]
}

{
  "attachments": [
    {
      "merchantNumber": "text",
      "attachmentId": 1,
      "fileName": "text",
      "filePath": "text",
      "uploadedDateTime": "2025-12-09T10:30:00.000Z"
    }
  ],
  "responseId": 1,
  "responseMessage": "text",
  "caseNumber": "text",
  "exchangeId": "text",
  "correlationId": "123e4567-e89b-12d3-a456-426614174000",
  "parentId": "123e4567-e89b-12d3-a456-426614174000",
  "parentSystemCode": "text",
  "merchantNumber": "text"
}