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 endpoints are available today:

Our Disputes API is designed to allow a customer 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:



Please note that in order to use the full feature-set of these APIs in production you must;

  • Have an approved production API Key
  • Be onboarded as a Fiserv customer


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

Want a quick overview?