POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

Headers

Accept-Language
string
default:en

Preferred language for the response

Body

application/json
merchantAccountNumber
integer
required

Merchant account number to retrieve disputes for.

Example:

11223344

pageNumber
integer
required

The page number to retrieve.

Required range: x >= 1
Example:

1

numberOfReturnedRows
integer
required

The number of rows to return per page.

Required range: x >= 1
Example:

10

isIncremental
boolean
default:true

Determines whether records should be fetched incrementally.

Example:

true

searchBy
enum<string>
default:TransactionReferenceNumber

The field used for searching disputes.

Available options:
TransactionReferenceNumber
Example:

"TransactionReferenceNumber"

searchText
string
default:""

Search value for filtering disputes. Leave empty to retrieve all disputes.

Example:

""

Response

Success Response (200)

disputeId
string<uuid>

Unique identifier of the dispute.

Example:

"3f2504e0-4f89-11d3-9a0c-0305e82c3301"

amountDisputed
number<decimal>

Amount disputed by the merchant or customer.

Example:

12500

transactionReferenceNumber
string

Unique transaction reference number.

Example:

"250828AU2LXJ"

reason
string

Reason for opening the dispute.

Example:

"Service not rendered"

description
string

Detailed description of the dispute.

Example:

"The receiver did not get the funds despite being successful"

dateOpened
string<date-time>

Date and time when the dispute was opened.

Example:

"2026-04-01 18:22:51"

statusCode
string

Current dispute status code R=Review, O=Open, W=Win, L=Lose

Example:

"W"

beneficiaryName
string

Name of the transaction beneficiary.

Example:

"JAMES BANDA"