API reference
Recharge PINs
Buy printable recharge card PINs with your business name.
POSThttps://uzobestgsm.com/api/v2/recharge-pins/
Header Authorization: Bearer YOUR_API_KEY. Try it free with your test key.
What to send
| Field | What it is |
|---|---|
| referencerequired | Your own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore). |
| networkrequired | MTN, GLO, AIRTEL or T2. |
| cardrequired | The card's named ID, e.g. MTN_200. Plan IDs list. |
| quantityrequired | How many. |
| name_on_cardrequired | Your business name, printed on the cards. |
Example
curl -X POST https://uzobestgsm.com/api/v2/recharge-pins/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference": "ORD10028", "network": "MTN", "card": "MTN_200", "quantity": 2, "name_on_card": "ADA STORES"}'
$ch = curl_init('https://uzobestgsm.com/api/v2/recharge-pins/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 150,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'ORD10028',
'network' => 'MTN',
'card' => 'MTN_200',
'quantity' => 2,
'name_on_card' => 'ADA STORES'
]),
]);
$answer = json_decode(curl_exec($ch), true);
const res = await fetch('https://uzobestgsm.com/api/v2/recharge-pins/', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({"reference": "ORD10028", "network": "MTN", "card": "MTN_200", "quantity": 2, "name_on_card": "ADA STORES"}),
});
const answer = await res.json();
import requests
answer = requests.post(
'https://uzobestgsm.com/api/v2/recharge-pins/',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={"reference": "ORD10028", "network": "MTN", "card": "MTN_200", "quantity": 2, "name_on_card": "ADA STORES"},
timeout=150,
).json()
The answer
Read data.status: successful, pending or failed (refunded).
Answer
{
"status": true,
"message": "Order successful.",
"data": {
"reference": "ORD10028",
"id": "Data8935fa7f7",
"service": "recharge-pins",
"status": "successful",
"message": "Order successful.",
"amount": "1000.00",
"balance_before": "5000.00",
"balance_after": "4000.00",
"pins": [
"123456789012"
],
"quantity": 2
},
"request_id": "req_3f9a1c2b7d4e5f60"
}
Pending? Look it up. Refused? See Errors.
Using the Classic / MSORG address instead?
POST https://uzobestgsm.com/api/rechargepin/, header Token YOUR_API_KEY, fields network, network_amount, quantity, name_on_card.
Updated 2026-11-20. Questions? Contact support.

