Optimization Protection

Dispute management changelog

October 15, 2026

API Release v1.1.8

New

New features for Dispute Management API
Feature name	Description
API Specification	API specification version 1.1.8 was released.
Pre-arbitration	Pre-arbitration support through the Dispute Management API is available for supported dispute processing in Australia and for card-present disputes in Europe.

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

Updated fields in the API specification
Field name	Description	Endpoint
`disputeTypes`	The `disputeTypes` filter list now includes `PRE_ARBITRATION` and `ALL` as allowed values in the request body.	`POST /disputes` - Retrieve a list of disputes
disputes.`disputeType`	The `disputes` list now includes `PRE_ARBITRATION` as an allowed value in the response body.	`POST /disputes` - Retrieve a list of disputes
relatedItemsData.`disputeType`	`disputeType` now includes `PRE_ARBITRATION` as an allowed value in the response body.	`POST /disputes/status-query` - Retrieve disputes status
disputeDetails.`disputeType`	`disputeType` now includes `PRE_ARBITRATION` as an allowed value in the response body.	`GET /disputes/{disputeId}` - Get dispute details
relatedItems.`disputeType`	`disputeType` now includes `PRE_ARBITRATION` as an allowed value in the response body.	`GET /disputes/{disputeId}` - Get dispute details
disputes[].`outcome`	Updated in response. Adds `LIABILITY_CONTESTED` and `LIABILITY_CONFIRMED` as possible dispute outcomes.	`POST /disputes` - Retrieve a list of disputes
disputeDetails.`outcome`	Updated in response. Adds `LIABILITY_CONTESTED` and `LIABILITY_CONFIRMED` as possible dispute outcomes.	`GET /disputes/{disputeId}` - Get dispute details
disputesStatusList[].`outcome`	Updated in response. Adds `LIABILITY_CONTESTED` and `LIABILITY_CONFIRMED` as possible dispute outcomes.	`POST /disputes/status-query` - Retrieve disputes status

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 /disputes` - Retrieve 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.disputeDetails.relatedItems.disputeType