Quick start

Disputes (also known as chargebacks) occur when a cardholder wants to query a transaction on their card statement. The card schemes (Visa, MasterCard & JCB) provide a dispute process that allows transactions to be 'disputed' in cases of fraud, incorrect processing or unknown transactions.

The Disputes API is designed to make the complex disputes process flow easier for the consumer to understand the required responses expected by the card schemes.



The following features are available today:

Our Disputes API is designed to allow a merchant to retrieve, manage and respond to disputes. It supports

  • requesting all and/or individual disputes details
  • retrieve supporting documentation pertaining to the individual dispute
  • action (accept or decline) each dispute throughout the life-cycle of the dispute
  • upload evidence (tiff, tif, pdf, jpeg, jpg, doc or docx format) when declining a dispute
  • undo an action (response) where permitted

Make your first API call

Prereqs - ensure the following has been completed:



Disputes production APIs are in development. You can find the API specification here. If you are interested in gaining access when available then please contact us via our support page


The disputes sandbox contains some mocked data to reflect:

  • Sample list of disputes
  • Retrieve a single dispute from the list by disputeId 20220602835125
  • Retrieving a dispute document by disputeId 20220602835125 and documentId 20220627739641
  • Execute an action by disputeId 20220602835125 and eventId TXN-20220602695615
  • Undo an action by disputeId 20220602835125, eventId TXN-20220602695615 and actionId 040
  • Add a note by disputeId 20220602835125
  • Update a note by disputeId 20220602835125 and noteId 20220721948337

Did this page help you?