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
disputeId
string<uuid>
required

Unique identifier of the dispute.

Example:

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

merchantAccountNumber
integer
required

Merchant account number to retrieve disputes for.

Example:

11223344

Response

Success Response (200)

disputeId
string<uuid>

Unique identifier of the dispute.

Example:

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

merchantAccountNumber
integer

Merchant account number associated with the dispute.

Example:

11223344

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"

authorisedBy
string

Name of the user who authorized the dispute resolution.

Example:

"john.phiri@example.com"

dateAuthorized
string<date-time>

Date and time when the dispute resolution was authorized.

Example:

"2026-04-05 14:30:00"

authStatus
string

Authorization status of the dispute resolution.

Example:

"A"

responseCode
string

Response code from the dispute resolution process.

Example:

"00"

responseMessage
string

Response message from the dispute resolution process.

Example:

"Dispute resolved successfully"

processedDate
string<date>

Date when the transaction was processed.

Example:

"2024-01-15"

transactionType
string

Type of the transaction associated with the dispute.

Example:

"BD"

beneficiaryName
string

Name of the transaction beneficiary.

Example:

"JAMES BANDA"