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.
Live environment required
Dispute endpoints require the sk.… private key and are only available in the live environment.
Key endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /disputes | List all disputes |
GET | /disputes/{uid} | Retrieve a single dispute |
POST | /disputes/{uid}/submit-evidence | Upload evidence to counter the dispute |
POST | /disputes/{uid}/accept | Accept the dispute (refund the customer) |
POST | /disputes/{uid}/close | Close the dispute |
POST | /disputes/{uid}/messages | Send a message in the dispute thread |
Authentication
Disputes require a private key (sk.…) — public keys cannot access this resource.
See Authentication.
GET
https://api.wajub.com/disputescurl https://api.wajub.com/disputes \
-H "Authorization: sk.xxxxxxxxxxxxxxxxxxxxxxxx"Response
{
"status": "OK",
"code": 200,
"disputes": [
{
"id": "dsp_01JXXXXXXXXXXXXX",
"status": "needs_response",
"amount": 5000,
"currency": "XAF",
"reason": "fraudulent",
"created_at": "2026-07-15T10:21:08.000Z"
}
],
"meta": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1 }
}Resources
Related pages