Disputes Management

The Disputes API allows you to manage merchant's dispute cases programmatically. Use this API to retrieve dispute details, view status history, access submitted responses and submit responses with supporting evidence with additional comments.

Usage information

To submit a dispute response, ensure the following conditions are met:

Condition	Requirement
Eligible case type	Chargebacks Retrievals
Required case status	Awaiting Response New Activity

Ineligible cases

Do not submit a response for the following cases:

Condition	API Response
Case status is Under Review or Completed	406 Not Acceptable
Case type is not Chargeback or Retrieval	406 Not Acceptable
Case is in Pre-Arbitration or Arbitration stage	406 Not Acceptable with below message

Message:

You cannot respond to this case type using Xplor’s dispute management tool. The merchant will receive a letter with instructions. For more information, call +1.844.663.8797 with the case number ready. Pursuing this type of case can incur significant fees for the losing party.

Evidence submission

Submit evidence only for Chargeback and Retrieval case types.

Field	Requirement
caseNumber	Required
responseMessage	Maximum 500 characters
evidence	Allowed formats are .tiff, .tif, .pdf, .jpg, and .jpeg
File Size	Maximum 10 MB per file (configurable)
File Name	Maximum 50 characters (configurable)

Submitting a response without evidence attachments may result in an error for some dispute case types.