POST
/
disputes
/
add
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/disputes/add" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  -d '{
    "documentTypeId": "CUC",
    "contentType": "PDF",
    "contentBase64": "UEsDBBQAAAAIAA..",
    "transactionId": 3,
    "merchantAccountNumber": 55555836,
    "beneficiaryAccountNumber": "10012301020",
    "amountDisputed": 1000000000,
    "transactionReferenceNumber": "250828AU2LXJ",
    "sourceReferenceNumber": "154HAGSB4",
    "currencyCode": "MWK",
    "reason": "Service not rendered",
    "description": "The receiver did not get the funds despite being successful",
    "evidenceDueBy": "2026-04-27T09:47:36.088Z",
    "isBatchTransaction": false,
    "capturedBy": "jamesgongwe@gmail.com"
  }'
{
  "message": "Dispute has been created successfully"
}

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
ā€‹
transactionId
integer
required

Unique identifier for the transaction being disputed being supported by Get Transaction Inquiries

Example:

383

ā€‹
merchantAccountNumber
integer
required

Required string length: 8

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

55555836

ā€‹
beneficiaryAccountNumber
string
required

Account number or phone number of beneficiary

Example:

"10012301020"

ā€‹
amountDisputed
integer
required

The amount being disputed

Example:

100000000

ā€‹
transactionReferenceNumber
string
required

Unique reference number for the transaction

Example:

"250828AU2LXJ"

ā€‹
sourceReferenceNumber
string
required

Unique identifier from your source system

Example:

"154HAGSB4"

ā€‹
currencyCode
string
required

Currency code used for the transaction

Example:

"MWK"

ā€‹
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"

ā€‹
evidenceDueBy
string<date-time>
required

Due date of the evidence

Example:

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

ā€‹
isBatchTransaction
boolean
required

Whether the transaction is from single or batch transaction

Example:

false

ā€‹
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"