Skip to main content
Beta version

Dispute Management API is in the Beta phase.

Dispute Management

Dispute management changelog

July 30, 2026

API Release v1.1.4

New

New features for Dispute Management API
Feature name Description
API Specification

API specification version 1.1.4 was released.

The following fields were updated in the API specification v1.1.4:

Updated fields added to the API specification
Field name Description Endpoint
entityIds.companyIds

Removed the status note "Reserved for future use. Currently not active." from the schema definition. This change impacts the request body.

POST /disputes - Retrieve a list of disputes
statusInquiryParameters.companyIds

Removed the status note "Reserved for future use. Currently not active." from the schema definition. This change impacts the request body.

POST /disputes/status-query - Retrieve disputes status
merchantData.companyId Removed the status note "Reserved for future use. Currently not active." from the schema definition. This change impacts the response body. GET /disputes/{disputeId} - Get dispute details
POST /disputes - Retrieve a list of disputes
merchantData.companyName Removed the status note "Reserved for future use. Currently not active." from the schema definition. This change impacts the response body. GET /disputes/{disputeId} - Get dispute details
POST /disputes - Retrieve a list of disputes

May 21, 2026

API Release v1.1.3

New

New features for Dispute Management API
Feature name Description
API Specification

API specification version 1.1.3 was released.

The following fields were added or deprecated in the API specification v1.1.3:

Added or deprecated fields added to the API specification
Field name Description Endpoint
disputeDetails.issuerDocumentExpected Added to the response. GET /disputes/{disputeId} - Get dispute details
disputeDetails.issuerDocumentReceived Added to the response. GET /disputes/{disputeId} - Get dispute details
disputeDetails.issuerDocumentCode Deprecated. GET /disputes/{disputeId} - Get dispute details
transactionData.submitterPlatformId Added to the response.

GET /disputes/{disputeId} - Get dispute details

POST /disputes - Retrieve a list of disputes

transactionData.transactionId Added to the response.

GET /disputes/{disputeId} - Get dispute details

POST /disputes - Retrieve a list of disputes

paymentMethodList Added to the request. POST /disputes - Retrieve a list of disputes
responseDueEndDate Added to the request. POST /disputes - Retrieve a list of disputes
responseDueStartDate Added to the request. POST /disputes - Retrieve a list of disputes
disputes.issuerDocumentExpected Added to the response. POST /disputesRetrieve a list of disputes
disputes.issuerDocumentReceived Added to the response. POST /disputes - Retrieve a list of disputes
disputes.issuerDocumentCode Deprecated. POST /disputes - Retrieve a list of disputes
platform-id Added to the request header.

POST /disputes - Retrieve a list of disputes

GET /disputes/{disputeId} - Get dispute details

POST /disputes/status-query - Retrieve disputes status

GET /disputes/{disputeId}/documents - Get dispute documents

POST /disputes/{disputeId}/challenge  - Challenge a dispute

POST /disputes/{disputeId}/fulfill - Fulfill a retrieval request

POST /disputes/{disputeId}/accept - Accept a dispute

September 26, 2025

API Release v1.0.6

Change

API Release v1.0.6
Feature name Description
CAT Environment

Added the sandbox server in the specification, so you can use Dispute Management CAT environment to test with the PayEdge sandBox URL.

Retrieve disputes Fixed the description of statusUpdateTimestamp.
Retrieve detailed dispute information Added statusUpdateTimestamp.
Retrieve disputes status

Changed the attribute name for disputeActionTimestamp to statusUpdateTimestamp, for consistency.

API Specification

API Specification version 1.0.6 was released.

August 14, 2025

API Release v1.0.5

New

New updates for Dispute Management API
Feature name Description
Overview

First version of dispute management API.