Pricing Plan

Data Bundle Prices
ID Name Amount (NGN) Bundle
45 MTN SME 1GB 7Days) 530.00 MTN -SME-1GB
106 MTN SME 2GB (30Days) 1,060.00 MTN-SME-2GB
108 MTN SME 3GB (30Days) 1,590.00 MTN-SME-3GB
117 MTN SME 500MB (30Days) 340.00 MTN-SME-500MB
122 MTN CG 10GB (30Days) 2,800.00 MTN-10GB- CORPORATE
125 MTN CG 1GB (30Days) 280.00 MTN-1GB-CORPORATE
129 MTN CG2GB (30Days) 560.00 MTN-2GB-CORPORATE
140 Glo CG 1GB (30days) 400.00 GLO-1GB-CORPORATE
144 Glo CG2gb (30Days) 800.00 GLO-2GB-CORPORATE
148 Glo CG 3gb (30Day) 1,200.00 GLO-3GB-CORPORATE
154 GLO CG 500MB (30days) 200.00 GLO-500MB-CORPORATE
157 GLO CG 5GB (30Days) 2,000.00 GLO-5GB-CORPORATE
166 Airtel CG 1GB (30Days) 860.00 AIRTEL-1GB-CORPORATE
170 Airtel CG 2GB (30Days) 1,720.00 AIRTEL-2GB-CORPORATE
173 Airtel 3GB (30days) 2,580.00 AIRTEL-3GB-CORPORATE
181 MTN CG 3gb (30Days) 825.00 MTN-3GB-CORPORATE
186 MTN CG 500mb (30Days) 145.00 MTN-500MB-CORPORATE
190 MTN CG5gb (30DayS) 1,400.00 MTN-5GB-CORPORATE
194 Airtel CG 5gb (30Days) 4,300.00 AIRTEL-5GB-CORPORATE
255 MTN DATASHARE 1GB (30Days) 600.00 MTN-1GB-SHARE
269 MTN datashare 2GB (30Days) 1,200.00 MTN-2GB-SHARE
271 MTN DATASHARE 3GB (1 month) 1,800.00 MTN-3GB-SHARE
273 MTN DATASHARE 5GB (1 month) 3,000.00 MTN-5GB-SHARE
282 500MB Weekly 485.00 500MB Weekly Plan
300 airtel CG 10gb (30days) 8,600.00 AIRTEL CORPORATE-10GB
301 GLO CG 200MB(14days) 80.00 GLO CORPORATE-200MB
302 MTN SME 5GB (30Days) 2,650.00 MTN-SME-5GB
303 AIRTEL CG 300MB (30Days) 258.00 AIRTEL-CG-300MB
304 AIRTEL CG 100MB (30Days) 86.00 AIRTEL-CG-100MB
305 MTN CG 50MB (30Days) 20.00 MTN CORPORATE-50MB
306 MTN CG 150MB (30Days) 70.00 MTN CORPORATE-150MB
307 MTN CG 250MB (30Days) 100.00 MTN CORPORATE-250MB
311 GLO CG 10GB (30Days) 4,000.00 GLO CORPORATE-10GB
312 GLO CG 1GB (3Days) 400.00 GLO-CG-1GB
313 9MOBILE CG 500MB (30Days) 100.00 9MOBILE-CG-500MB
314 GLO CG 3GB (3Days) 1,200.00 GLO-CG-3GB
315 GLO CG 3GB (7Days) 1,200.00 GLO-CG-3GB
316 GLO CG 5GB (3Days) 2,000.00 GLO-CG-5GB
317 GLO CG 5GB (7Days) 2,000.00 GLO-CG-5GB
318 9MOBILE CG 5GB (30Days) 1,000.00 9MOBILE-CG-5GB
319 GLO CG 1GB (7Days) 400.00 GLO-CG-1GB
320 MTN SME2 500MB (30Days) 305.00 MTN-SME2-500MB
321 MTN SME2 1GB (30Days) 610.00 MTN-SME2-1GB
322 MTN SME2 2GB(30Days) 1,220.00 MTN-SME2-2GB
323 MTN SME2 3GB(30Days) 1,830.00 MTN-SME2-3GB
324 MTN SME2 5GB(30Days) 3,050.00 MTN-SME2-5GB
332 MTN AWOOF 7GB (7DAYS) 2,880.00 MTN-7GB-AWOOF
336 2.5GB 2-Days 873.00 2.5GB 2-Days Plan
337 MTN-GIFTING 750MB (3DAYS) 432.00 MTN-GIFTING 750MB
339 MTN-GIFTING 10GB (30DAYS) 4,320.00 MTN-GIFTING 10GB
340 MTN-GIFTING 11GB (7DAYS) 3,360.00 MTN-GIFTING 11GB
341 MTN-GIFTING 20GB (30DAYS) 7,200.00 MTN-GIFTING 20GB
343 MTN-GIFTING 36GB (30DAYS) 10,560.00 MTN-GIFTING 36GB
344 1GB+1.5mins Daily 485.00 1GB+1.5mins Daily Plan
348 1.. Days 860.00 1GB
350 230MB Daily 196.00 230 MB Daily Plan
351 2GB+2mins Monthly 1,455.00 2GB+2mins Monthly
354 2.5GB Daily 727.50 2.5GB Daily Bundle
355 1GB Weekly Plan 610.00 1GB monthly plan
357 2GB 2 Days 727.50 2GB 2 Days Plan
358 MTN-SME 1GB 💛(30DAYS) 600.00 MTN-1GB-SME1💛
359 Glo CG 1GB (30days) 3,900.00 GLO-GIFT-1GB
360 4GB 800.00 Ff

GETTING STARTED WITH OUR DOCUMENTATION

Thank you for choosing Tawfiqsub and we are always available to attend to all our customers request at all time. Our API is very easy to implement and we have make it simple for developers to integrate in a jiffy.

AUTHENTICATION / AUTHORIZATION

Bearer: xxxxxxxxxxxxxxxxxxxxxxxx

Token: xxxxxxxxxxxxxxxxxxxxxxxx Only For Tokenized Buy Data

Check My Balance

Endpoint: https://Tawfiqsub.com/api/v2/buyservice

PayLoad: {"service":"check-balance"}


Method: POST


Success Response: { "status": "success", "message": "Balance is fetched", "balance": "280" }


Failed Response: { "status": "failed", "message": "No data available for this user" }


Pending Response: { "status": "pending", "message": "Balance is fetching" }


Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/v2/buyservice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"check-balance",
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/v2/buyservice"
payload = json.dumps({
"service": "check-balance",
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Purchase Data (Tokenized Version)

Endpoint: https://Tawfiqsub.com/api/data/

PayLoad: {'network'=> 1, 'mobile_number'=> '081xxxxxx', 'plan' => 277, 'Ported_number'=>true}


Method: POST


Network: MTN: 1, GLO: 2, AIRTEL: 3, 9MOBILE: 4


Success Response: { "Status": "successful", "message": "Transaction is successful", "amount": "280", "api_response": "You have successfully purchased 1GB on 06060000000", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "DATA", "last_bal": "380", "new_bal": "100" }


Failed Response: { "Status": "failed", "message": "Transaction failed", "amount": "140", "api_response": "The Phone Number provided is not a valid mtn number", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "DATA", "last_bal": "380", "new_bal": "380" }



Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/data/',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"buy-data",
"network": "MTN",
"mobile_number":"06060000000",
"plan": "277"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Token ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/data/"
payload = json.dumps({
"service":"buy-data",
"network": "MTN",
"mobile_number":"06060000000",
"plan": "277"
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Token ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Purchase Data

Endpoint: https://Tawfiqsub.com/api/v2/buyservice

PayLoad: {"service":"buy-data", "network": "MTN", "mobile":"08130767357", "bundle_id": "277"}


Method: POST


Success Response: { "status": "success", "message": "Transaction is successful", "amount": "280", "content": "You have successfully purchased 1GB on 06060000000", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "DATA", "last_bal": "380", "new_bal": "100" }


Failed Response: { "status": "failed", "message": "Transaction failed", "amount": "140", "content": "The Phone Number provided is not a valid mtn number", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "DATA", "last_bal": "380", "new_bal": "380" }


Pending Response: { "status": "pending", "message": "Transaction is pending", "amount": "140", "content": "You have successfully purchased 500MB on 06060000000 which is still pending", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "DATA", "last_bal": "380", "new_bal": "240" }


Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/v2/buyservice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"buy-data",
"network": "MTN",
"mobile":"06060000000",
"bundle_id": "277"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/v2/buyservice"
payload = json.dumps({
"service": "buy-data",
"network": "MTN",
"mobile": "06060000000",
"bundle_id": "277"
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Purchase Airtime

Endpoint: https://Tawfiqsub.com/api/v2/buyservice

PayLoad: {"service":"buy-airtime", "network": "MTN", "mobile":"06034567867", "amount": "100", "type": "VTU"}


Type can be VTU or AWUF or SNS


Method: POST


Success Response: { "status": "success", "message": "Transaction is successful", "amount": "100", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "AIRTIME", "last_bal": "380", "new_bal": "100" }


Failed Response: { "status": "failed", "message": "Transaction failed", "amount": "100", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "AIRTIME", "last_bal": "380", "new_bal": "280" }


Pending Response: { "status": "pending", "message": "Transaction is pending", "amount": "100", "content": "You have successfully purchased 500MB on 06060000000 which is still pending", "date_created": "2024-10-24 04:55:04 AM", "receiver": "06060000000", "type": "AIRTIME", "last_bal": "380", "new_bal": "280" }


Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/v2/buyservice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"buy-airtime",
"network": "MTN",
"mobile":"06060000000",
"amount": "100", "type": "VTU"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/v2/buyservice"
payload = json.dumps({
"service": "buy-airtime",
"network": "MTN",
"mobile": "06060000000",
"amount": "100", "type": "VTU"
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Purchase Cable

Endpoint: https://Tawfiqsub.com/api/v2/buyservice

PayLoad: {"service":"buy-cable", "smartcard": "0773635353535", "brand":"GOTV", "plan": "GOHAN", "decoder_owner": "Test Test"}


Method: POST


Success Response: { "status": "success", "message": "Transaction is successful", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "CABLE", "last_bal": "", "new_bal": "" }


Failed Response: { "status": "failed", "message": "Transaction failed", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "CABLE", "last_bal": "", "new_bal": "" }


Pending Response: { "status": "pending", "message": "Transaction is pending", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "CABLE", "last_bal": "", "new_bal": "" }


Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/v2/buyservice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"buy-cable",
"smartcard": "0773635353535",
"brand":"GOTV",
"plan": "GOHAN",
"decoder_owner": "Test Test"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/v2/buyservice"
payload = json.dumps({
"service":"buy-cable",
"smartcard": "0773635353535",
"brand":"GOTV",
"plan": "GOHAN",
"decoder_owner": "Test Test"
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Purchase Electric

Endpoint: https://Tawfiqsub.com/api/v2/buyservice

PayLoad: {"service":"buy-power", "meter_no": "0773635353535", "meter_name":"ibadan-electric", "amount": "100", "mobile": "0828957577", "meter_owner": "Test Test"}


Method: POST


Success Response: { "status": "success", "message": "Transaction is successful", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "ELECTRIC", "last_bal": "", "new_bal": "" }


Failed Response: { "status": "failed", "message": "Transaction failed", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "ELECTRIC", "last_bal": "", "new_bal": "" }


Pending Response: { "status": "pending", "message": "Transaction is pending", "amount": "", "content": "", "date_created": "2024-10-24 04:55:04 AM", "receiver": "07012344555", "type": "ELECTRIC", "last_bal": "", "new_bal": "" }


Sample PHP Code:
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://Tawfiqsub.com/api/v2/buyservice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"service":"buy-electric",
"meter_no": "0773635353535",
"meter_name":"ibadan-electric",
"amount": "100",
"mobile": "0828957577",
"meter_owner": "Test Test",
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer ••••••'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;


Sample PYTHON Code:
url = "https://Tawfiqsub.com/api/v2/buyservice"
payload = json.dumps({
"service":"buy-electric",
"meter_no": "0773635353535",
"meter_name":"ibadan-electric",
"amount": "100",
"mobile": "0828957577",
"meter_owner": "Test Test",
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer ••••••'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)


Verify Power


Verify Payload: {
"service":"smartcard-check",
"smartcard": "0773635353535",
"brand":"GOTV"
}


Method: POST


Success Response: {
"status": "success",
"name": "TEST TEST"
}


Verify Power


Verify Payload: {
"service":"meter-check",
"meter_no": "0773635353535",
"meter_name":"ibadan-electric"
}


Method: POST


Success Response: {
"status": "success",
"name": "TEST TEST"
}


Complaint

If you have any issue please raise a complaint to our support Tawfiqsub