Build with the API
Webhooks
Get the final answer of every order on your server, signed so you know it came from us.
How it works
Save your webhook address on your API page. When an order is final (successful or failed, and again only if that changes, for example a refund), we send one POST to it.
What we send
{
"event": "transaction.updated",
"data": {
"reference": "ORD10023",
"id": "Data8935fa7f7-2a0",
"service": "data",
"status": "successful",
"message": "Dear Customer, You have successfully shared 1GB Data to 2348031234567.",
"amount": "1000.00",
"balance_before": "5000.00",
"balance_after": "4000.00",
"phone": "08031234567",
"network": "MTN",
"plan": "MTN_SME_1GB_30DAYS",
"plan_name": "1GB",
"account": null,
"customer_name": null,
"token": null,
"units": null,
"pins": null,
"quantity": null,
"created_at": "2026-11-14T10:15:02+01:00",
"replayed": false
}
}
Check that it came from us
The header X-Uzobest-Signature is the HMAC SHA512 of the raw body, made with your API key. Compare it before you trust the message.
<?php
$body = file_get_contents('php://input');
$sent = $_SERVER['HTTP_X_UZOBEST_SIGNATURE'] ?? '';
$mine = hash_hmac('sha512', $body, 'YOUR_API_KEY');
if (!hash_equals($mine, $sent)) { http_response_code(401); exit; }
$order = json_decode($body, true);
// $order['ident'], $order['Status'] (successful / failed) ...
http_response_code(200);
import hmac, hashlib
body = request.body # the raw bytes
sent = request.headers.get('X-Uzobest-Signature', '')
mine = hmac.new(b'YOUR_API_KEY', body, hashlib.sha512).hexdigest()
if not hmac.compare_digest(mine, sent):
return HttpResponse(status=401)
Rules
- Answer with HTTP 200 within 5 seconds.
- We send each webhook once and do not follow redirects. Missed one? Look the order up.
- Your API page asks for your PIN to change the address, and we email you when it changes.
Using the Classic / MSORG address instead?
Orders bought through the Classic address get the MSORG style webhook: the order fields with
Status and ident. Same address, same signature.
Updated 2026-11-20. Questions? Contact support.

