Disputes
Manage customer disputes: view, submit evidence, accept or close disputed payments.
GET
https://api.wajub.com/disputesDisputes occur when a customer challenges a payment with their bank or Mobile Money provider. Wajub tracks each dispute and lets you respond with evidence directly from the API.
Private key required
Dispute endpoints take a private (sk.…) or restricted key, in live and in sandbox. A public key
gets a 406.
Key endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /disputes | List all disputes |
GET | /disputes/{id} | Retrieve a single dispute |
POST | /disputes/{id}/submit-evidence | Record evidence to counter the dispute |
POST | /disputes/{id}/accept | Accept the dispute and refund the customer |
POST | /disputes/{id}/close | Same as accept: the dispute is lost, refund included |
POST | /disputes/{id}/messages | Send a message in the dispute thread |
Authentication
Disputes require a private (sk.…) or restricted key, public keys get a 406.
See Authentication.
GET
https://api.wajub.com/disputescurl https://api.wajub.com/disputes \
-H "Authorization: sk.xxxxxxxxxxxxxxxx…"{
"code": 200,
"status": "OK",
"message": "Disputes retrieved",
"items": [
{
"id": "dsp_hrgUOE225KMKULRQqYvl",
"transaction": "trx_CSUGajfv9xh0XQ5wu2lx",
"status": "open",
"amount": 5000,
"currency": "XAF",
"reason": "fraudulent",
"created_at": "2026-07-15T10:21:08+00:00"
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 25,
"total": 1
}
}
Resources
Related pages