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.

Body

application/json
evidenceDueBy
string<date-time>
required

Due date of the evidence

Example:

"2026-04-27T09:47:36.088Z"

merchantAccountNumber
integer
required

Required string length: 8

Required range: 10000000 <= x <= 99999999
Example:

55555836

transactionReferenceNumber
string
required

Unique reference number for the transaction

Example:

"250828AU2LXJ"

transactionType
string
required

The type of the transaction being disputed (e.g., "SD", "BD")

Example:

"SD"

amountDisputed
integer
required

The amount being disputed

Example:

100000000

reason
string
required

The reason for opening the dispute

Example:

"Service not rendered"

description
string
required

More details for opening the dispute

Example:

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

capturedBy
string
required

User identifier who added the dispute

Example:

"jamesgongwe@gmail.com"

documentTypeId
string

The identifier of the document type

Example:

"CUC"

contentType
string

The content type of the file eg (PNG,JPG,CSV,XLSX & PDF)

Example:

"PDF"

contentBase64
string

Base64-encoded content of the file

Example:

"UEsDBBQAAAAIAA.."

Response

201 - application/json

Dispute has been created successfully

message
string
Example:

"Dispute has been created successfully"