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

FieldWhat it is
referencerequiredYour own unique ID for this order (1 to 64 letters, digits, dot, dash or underscore).
networkrequiredMTN, GLO, AIRTEL or T2.
cardrequiredThe card's named ID, e.g. MTN_200. Plan IDs list.
quantityrequiredHow many.
name_on_cardrequiredYour 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"}'

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.