API Reference

Our reference library for integrating with our API


Find answers to our most frequently asked questions

Classic Docs

Documentation for our Classic API

Manage disputes

Disputes (also known as chargebacks) are a challenging but inevitable part of e-commerce. They arise when a customer queries a transaction with their card issuer. The issuer creates a formal dispute which immediately reverses the payment, debiting your account for both the payment amount and a dispute fee.

It's important for you to monitor such disputes and respond to them as quickly as possible—thankfully, we've made the workflow simple.

Only administrator owners and administrators can respond to a dispute (e.g., accept a dispute or submit evidence). Users can view disputes and the dispute details but cannot respond.

This page explains how to manage disputes in the Hub, but you can also use our Disputes API.

About the dispute lifecycle and dispute statuses 

StepStatusDescriptionPossible actions in the Hub
1Payment disputedYour customer disputes the payment. This status does not show in the Dashboard but is the starting point of all disputes. The only financial repercussion at this stage is a fee being applied.-
2aEvidence requiredAn action on your side is required (you need to respond to the dispute). At this stage, your account gets debited the disputed amount.
  • Blacklist
  • Accept dispute
  • Submit evidence


We automatically resolve the dispute because it had already been refunded previously. There are no further financial implications.
  • Blacklist
3aEvidence under reviewYou have submitted evidence to defend against the dispute. Your evidence is now under review by our Disputes team. Once reviewed, the team will send it to the card scheme for review. No further action is required on your side.
  • Blacklist
3bExpiredThe time limit to take action is met. There is no further implication and you can’t respond to the dispute anymore.
  • Blacklist
3cAcceptedYou have accepted the dispute. There is no further implication or action required.
  • Blacklist
3dCanceledThe dispute is canceled by the issuing bank and your account is credited back the amount of the dispute. You don’t need to take any further action.
  • Blacklist
4aLostThe issuing bank has rejected your evidence and you have lost the dispute. There are no further financial implications.
  • Blacklist
4bWonThe issuing bank has accepted your evidence and you have won the dispute. Your account has been credited back of the amount of the dispute.
  • Blacklist

View disputes

In the Disputes screen

You can only view disputes at a business level, not at an account level.

The Disputes screen contains two tabs:

  • Unanswered: this tab contains all payments for which an action is required
  • All disputes: this tab contains all payments that have been disputed, including unanswered ones

Each tab shows the following information:

  • disputed amount
  • currency (as a 3-letter ISO code)
  • status (see above for more information)
  • reason for the dispute
  • payment ID
  • reference
  • initiated on

Additionally, the Unanswered tab shows the dispute expiry date while the All disputes tab shows the date the dispute was last updated on.

In the All disputes tab, you can:

  • filter by date range based on the Updated on date
  • filter by Payment ID, Dispute ID, ARN, Reference (exact match)

In the Payments screen

In the Action column, disputed payments have a DISPUTED label next to the payment action.
The DISPUTED label will appear on all rows relevant to that payment (e.g., auth, capture) and for any stage of the disputed payment (e.g., evidence required, evidence under review, won, lost).

You can search for a dispute using its payment ID, dispute ID, or any other filter relevant in the page, such as reference or customer email.

View payment details

Click on any disputed payment in the Disputes or Payments screens to bring up the Payment details. You can view the dispute details, as well as the latest status of the payment.

If a dispute has a status of EVIDENCE REQUIRED, you can perform one of the following actions:

  • accept dispute
  • submit evidence (see below for more information)

Submit evidence

  1. In the Payment details screen, review the dispute reason and details.
  2. Click Submit evidence.
  3. Select a tab:
    • General: here you can upload all 7 different types of evidence (one file maximum per evidence type).
    • Recommended: here you can upload the recommended types of evidence, according to the dispute reason.
  4. Attach the relevant evidence, then:
    • If you've finished, click Submit evidence. The dispute has been answered and its status changes to EVIDENCE UNDER REVIEW. It will no longer appear in the Unanswered tab anymore, only in the All disputes tab.
    • If you would like to come back and complete your submission later, click Save and continue later. The dispute status remains EVIDENCE REQUIRED.