Cashbuddy API
We have discovered a more inclusive and convenient way for you to pay your bills, receive payments and also become a bill payment service provider.
Bills Payments
Airtime API
POST
https://app.cashbuddy.ng/apis/apiAirtime
This endpoint allows you to get free airtime.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
Account email attributed your secret key.
amount
number
Amount of the airtime
phone
number
Phone number to recharge
network
string
The network provider of the user
{ "status": "1", "message": "Airtime purchase was successful", "network": "mtn"}
{ "status": "0", "message": "Could not make transaction", "network": "mtn"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiAirtime' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'phone=""' \
--form 'network=""' \
--form 'amount=""'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiAirtime',
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 => array('email' => 'developer@cashbuddy.com','phone' => '','network' => '','amount' => ''),
CURLOPT_HTTPHEADER => array(
'secret_key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var https = require('follow-redirects').https;
var fs = require('fs');
var options = {
'method': 'POST',
'hostname': 'https://app.cashbuddy.ng',
'path': '/apis/apiAirtime',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
'maxRedirects': 20
};
var req = https.request(options, function (res) {
var chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
res.on("error", function (error) {
console.error(error);
});
});
var postData = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ndeveloper@cashbuddy.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"phone\"\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"network\"\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--";
req.setHeader('content-type', 'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW');
req.write(postData);
req.end();
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("email","developer@cashbuddy.com")
.addFormDataPart("phone","")
.addFormDataPart("network","")
.addFormDataPart("amount","")
.build();
Request request = new Request.Builder()
.url("https://app.cashbuddy.ng/apis/apiAirtime")
.method("POST", body)
.addHeader("Secret-Key", "Bearer YOUR_SECRET_KEY")
.build();
Response response = client.newCall(request).execute();
Data API
POST
https://app.cashbuddy.ng/apis/apiData
This endpoint help you to recharge data and internet services To get biller_name call https://app.cashbuddy.ng/apis/apiFetchBills?network=airtel, See https://cashbuddyng.gitbook.io/cashbuddy/#fetch-bills-items. The networks available are airtel, 9mobile, glo, mtn, smile, spectranet. Send the amount of the plan returned on bills endpoint.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
biller_name
string
Get the biller name from fetch bills endpoint after supplying the network needed, all list of data plans will be returned.
amount
number
The amount attributed to the data plan.
network
string
The network providers e.g mtn, glo, 9mobile, airtel, smile, spectranet.
phone
number
Phone number to recharge.
string
The email attributed to your secret key.
{ "status": "1", "message": "Data purchase was successful", "network": "mtn"}
{ "status": "0", "message": "Could not make transaction", "network": "mtn"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiData' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'phone="08103******"' \
--form 'network="mtn"' \
--form 'amount="500"' \
--form 'biller_name=""'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiData',
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 => array('email' => 'developer@cashbuddy.com','phone' => '08103******','network' => 'mtn','amount' => '500','biller_name' => ''),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiData',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'phone': '08103******',
'network': 'mtn',
'amount': '500',
'biller_name': ''
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("email","developer@cashbuddy.com")
.addFormDataPart("phone","08103******")
.addFormDataPart("network","mtn")
.addFormDataPart("amount","500")
.addFormDataPart("biller_name","")
.build();
Request request = new Request.Builder()
.url("https://app.cashbuddy.ng/apis/apiData")
.method("POST", body)
.addHeader("Secret-Key", "Bearer YOUR_SECRET_KEY")
.build();
Response response = client.newCall(request).execute();
Electricity API
POST
https://app.cashbuddy.ng/apis/apiElectricity
This endpoint help you pay for your electricity bills, to get biller_name call https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric, See https://cashbuddyng.gitbook.io/cashbuddy/#fetch-bills-items. The distributions available are eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric. Send the amount to be paid by users to the distribution.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
amount
integer
Amount to be paid to the electricity distribution.
meter_number
number
The meter number of your electronic meter.
biller_name
string
Get bills name from fetch electricity bills payment after supplying the network, URL https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric to fetch your data.
network
string
Available networks are eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric.
string
The email account attributed to your secret key.
{ "status": "1", "message": "Electricity payment was successful"}
{ "status": "0", "message": "Could not make transaction"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiElectricity' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'meter_number="29728728*******"' \
--form 'network="eko-electric"' \
--form 'amount="10000"' \
--form 'biller_name="EKEDC PREPAID TOPUP"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiElectricity',
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 => array('email' => 'developer@cashbuddy.com','meter_number' => '29728728*****','network' => 'eko-electric','amount' => '10000','biller_name' => 'EKEDC PREPAID TOPUP'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiElectricity',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'meter_number': '297287282*****',
'network': 'eko-electric',
'amount': '10000',
'biller_name': 'EKEDC PREPAID TOPUP'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiElectricity")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("meter_number", "2972872827*****")
.field("network", "eko-electric")
.field("amount", "10000")
.field("biller_name", "EKEDC PREPAID TOPUP")
.asString();
Cable/TV Subscription API
POST
https://app.cashbuddy.ng/apis/apiTv
Use this endpoint to pay for your dstv, gotv and startimes and earn commission on each single transaction.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
card_no
number
This is your smart card number from your service provider's decoder.
network
string
Networks are gotv, dstv and startimes.
biller_name
string
Get bills name from fetch cable/tv subscription payment after supplying the network, URL https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv to fetch your data.
amount
number
The amount returned by fetch cable/tv bills endpoint.
string
The email account attributed to your secret key.
{ "status": "1", "message": "Cable subscription was successful"}
{ "status": "0", "message": "Could not make transaction"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiTv' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'amount="200"' \
--form 'card_no="12345*****"' \
--form 'network="dstv"' \
--form 'biller_name=""'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiTv',
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 => array('email' => 'developer@cashbuddy.com','amount' => '200','card_no' => '12345*****','network' => 'dstv','biller_name' => ''),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiTv',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'amount': '200',
'card_no': '12345*****',
'network': 'dstv',
'biller_name': ''
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiTv")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("amount", "200")
.field("card_no", "12345*****")
.field("network", "dstv")
.field("biller_name", "")
.asString();
Funds API
Funds Transfer API
POST
https://app.cashbuddy.ng/apis/apiTransfer
This endpoint will enable you to transfer money to any bank in Nigeria.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
message
string
Transfer description.
amount
integer
The amount to be transfered.
bank_code
number
the bank code of the bank gotten from Fetch all banks api.
account_number
number
The account number to send the money to.
string
The email account attributed to your secret key.
{ "status": "1", "message": "Your transfer was successful"}
{ "status": "0", "message": "Could not make transaction"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiTransfer' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'amount="200"' \
--form 'account_number="12345*****"' \
--form 'bank_code="046"' \
--form 'message="Funds Description"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiTransfer',
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 => array('email' => 'developer@cashbuddy.com','amount' => '200','account_number' => '12345*****','bank_code' => '046','message' => 'Funds Description'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiTransfer',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'amount': '200',
'account_number': '12345*****',
'bank_code': '046',
'message': 'Funds Description'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiTransfer")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("amount", "200")
.field("account_number", "12345*****")
.field("bank_code", "046")
.field("message", "Funds Description")
.asString();
Cash Pin Generation
Generate Pin
POST
https://app.cashbuddy.ng/apis/apiGeneratePins
Cash card pin is one card unlimited use, used to recharge, purchace data, pay for bills e.g bet, gotv, dstv, startimes, electricity and funds transfer also to pay for anything online using Cashbuddy Payment Processor.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
amount
integer
Amount value to pin printed on cash card.
count
number
The number of times to generate that value.
string
The email account attributed to your secret key.
{
"status": "1",
"message": "PIN GENERATED SUCCESSFULLY",
"generated_pin": "3",
"pin": [
{
"pin": "67104******",
"amount": "100",
"status": "available"
},
{
"pin": "35053******",
"amount": "100",
"status": "available"
},
{
"pin": "92722******",
"amount": "100",
"status": "available"
}
]
}
{
"status": "0",
"message": " - Cannot perform transaction, Insufficient Balance."
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiGeneratePins' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'amount="200"' \
--form 'count="5"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiGeneratePins',
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 => array('email' => 'developer@cashbuddy.com','amount' => '200','count' => '5'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiGeneratePins',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'amount': '200',
'count': '5'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiGeneratePins")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("amount", "200")
.field("count", "5")
.asString();
Fetch bills payment item
Fetch all banks with bank codes API
POST
https://app.cashbuddy.ng/apis/apiFetchBanks
Fetch all banks in nigeria with this endpoint.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
{
"status": "success",
"message": "Banks fetched successfully",
"data": [
{
"id": 1,
"code": "044",
"name": "Access Bank"
},
{
"id": 2,
"code": "023",
"name": "Citi Bank"
},
{
"id": 4,
"code": "050",
"name": "EcoBank PLC"
},
{
"id": 5,
"code": "011",
"name": "First Bank PLC"
},
{
"id": 6,
"code": "214",
"name": "First City Monument Bank"
},
{
"id": 7,
"code": "070",
"name": "Fidelity Bank"
},
{
"id": 8,
"code": "058",
"name": "Guaranty Trust Bank"
},
{
"id": 9,
"code": "076",
"name": "Polaris bank"
},
{
"id": 10,
"code": "221",
"name": "Stanbic IBTC Bank"
},
{
"id": 11,
"code": "068",
"name": "Standard Chaterted bank PLC"
},
{
"id": 12,
"code": "232",
"name": "Sterling Bank PLC"
},
{
"id": 13,
"code": "033",
"name": "United Bank for Africa"
},
{
"id": 14,
"code": "032",
"name": "Union Bank PLC"
},
{
"id": 15,
"code": "035",
"name": "Wema Bank PLC"
},
{
"id": 16,
"code": "057",
"name": "Zenith bank PLC"
},
{
"id": 17,
"code": "215",
"name": "Unity Bank PLC"
},
{
"id": 18,
"code": "101",
"name": "ProvidusBank PLC"
},
{
"id": 183,
"code": "082",
"name": "Keystone Bank"
},
{
"id": 184,
"code": "301",
"name": "Jaiz Bank"
},
{
"id": 186,
"code": "030",
"name": "Heritage Bank"
},
{
"id": 231,
"code": "100",
"name": "Suntrust Bank"
},
{
"id": 252,
"code": "608",
"name": "FINATRUST MICROFINANCE BANK"
},
{
"id": 253,
"code": "090175",
"name": "Rubies Microfinance Bank"
},
{
"id": 254,
"code": "090267",
"name": "Kuda"
},
{
"id": 258,
"code": "090115",
"name": "TCF MFB"
},
{
"id": 259,
"code": "400001",
"name": "FSDH Merchant Bank"
},
{
"id": 260,
"code": "502",
"name": "Rand merchant Bank"
},
{
"id": 301,
"code": "103",
"name": "Globus Bank"
},
{
"id": 389,
"code": "327",
"name": "Paga"
},
{
"id": 395,
"code": "000026",
"name": "Taj Bank Limited"
},
{
"id": 596,
"code": "100022",
"name": "GoMoney"
},
{
"id": 597,
"code": "090180",
"name": "AMJU Unique Microfinance Bank"
},
{
"id": 638,
"code": "090393",
"name": "BRIDGEWAY MICROFINANCE BANK"
},
{
"id": 639,
"code": "090328",
"name": "Eyowo MFB"
},
{
"id": 640,
"code": "090281",
"name": "Mint-Finex MICROFINANCE BANK"
},
{
"id": 659,
"code": "070006",
"name": "Covenant Microfinance Bank"
},
{
"id": 660,
"code": "090110",
"name": "VFD Micro Finance Bank"
},
{
"id": 661,
"code": "090317",
"name": "PatrickGold Microfinance Bank"
},
{
"id": 728,
"code": "090325",
"name": "Sparkle"
},
{
"id": 784,
"code": "305",
"name": "Paycom"
},
{
"id": 811,
"code": "070001",
"name": "NPF MicroFinance Bank"
},
{
"id": 812,
"code": "110001",
"name": "PayAttitude Online"
},
{
"id": 813,
"code": "100027",
"name": "Intellifin"
},
{
"id": 814,
"code": "100032",
"name": "Contec Global Infotech Limited (NowNow)"
},
{
"id": 815,
"code": "100031",
"name": "FCMB Easy Account"
},
{
"id": 816,
"code": "100030",
"name": "EcoMobile"
},
{
"id": 817,
"code": "100029",
"name": "Innovectives Kesh"
},
{
"id": 818,
"code": "100026",
"name": "One Finance"
},
{
"id": 819,
"code": "100025",
"name": "Zinternet Nigera Limited"
},
{
"id": 820,
"code": "100023",
"name": "TagPay"
},
{
"id": 821,
"code": "100021",
"name": "Eartholeum"
},
{
"id": 822,
"code": "100020",
"name": "MoneyBox"
},
{
"id": 824,
"code": "100019",
"name": "Fidelity Mobile"
},
{
"id": 825,
"code": "000019",
"name": "Enterprise Bank"
},
{
"id": 826,
"code": "060001",
"name": "Coronation Merchant Bank"
},
{
"id": 827,
"code": "060002",
"name": "FBNQUEST Merchant Bank"
},
{
"id": 828,
"code": "060003",
"name": "Nova Merchant Bank"
},
{
"id": 829,
"code": "070007",
"name": "Omoluabi savings and loans"
},
{
"id": 830,
"code": "090001",
"name": "ASOSavings & Loans"
},
{
"id": 831,
"code": "090005",
"name": "Trustbond Mortgage Bank"
},
{
"id": 832,
"code": "090006",
"name": "SafeTrust "
},
{
"id": 833,
"code": "090107",
"name": "FBN Mortgages Limited"
},
{
"id": 834,
"code": "100024",
"name": "Imperial Homes Mortgage Bank"
},
{
"id": 835,
"code": "100028",
"name": "AG Mortgage Bank"
},
{
"id": 836,
"code": "070009",
"name": "Gateway Mortgage Bank"
},
{
"id": 837,
"code": "070010",
"name": "Abbey Mortgage Bank"
},
{
"id": 838,
"code": "070011",
"name": "Refuge Mortgage Bank"
},
{
"id": 839,
"code": "070012",
"name": "Lagos Building Investment Company"
},
{
"id": 840,
"code": "070013",
"name": "Platinum Mortgage Bank"
},
{
"id": 841,
"code": "070014",
"name": "First Generation Mortgage Bank"
},
{
"id": 842,
"code": "070015",
"name": "Brent Mortgage Bank"
},
{
"id": 843,
"code": "070016",
"name": "Infinity Trust Mortgage Bank"
},
{
"id": 844,
"code": "090003",
"name": "Jubilee-Life Mortgage Bank"
},
{
"id": 845,
"code": "070017",
"name": "Haggai Mortgage Bank Limited"
},
{
"id": 846,
"code": "090108",
"name": "New Prudential Bank"
},
{
"id": 847,
"code": "070002",
"name": "Fortis Microfinance Bank"
},
{
"id": 848,
"code": "070008",
"name": "Page Financials"
},
{
"id": 849,
"code": "090004",
"name": "Parralex Microfinance bank"
},
{
"id": 850,
"code": "090097",
"name": "Ekondo MFB"
},
{
"id": 851,
"code": "090112",
"name": "Seed Capital Microfinance Bank"
},
{
"id": 852,
"code": "090114",
"name": "Empire trust MFB"
},
{
"id": 853,
"code": "090116",
"name": "AMML MFB"
},
{
"id": 854,
"code": "090117",
"name": "Boctrust Microfinance Bank"
},
{
"id": 855,
"code": "090118",
"name": "IBILE Microfinance Bank"
},
{
"id": 856,
"code": "090119",
"name": "Ohafia Microfinance Bank"
},
{
"id": 857,
"code": "090120",
"name": "Wetland Microfinance Bank"
},
{
"id": 858,
"code": "090121",
"name": "Hasal Microfinance Bank"
},
{
"id": 859,
"code": "090122",
"name": "Gowans Microfinance Bank"
},
{
"id": 860,
"code": "090123",
"name": "Verite Microfinance Bank"
},
{
"id": 861,
"code": "090124",
"name": "Xslnce Microfinance Bank"
},
{
"id": 862,
"code": "090125",
"name": "Regent Microfinance Bank"
},
{
"id": 863,
"code": "090126",
"name": "Fidfund Microfinance Bank"
},
{
"id": 864,
"code": "090127",
"name": "BC Kash Microfinance Bank"
},
{
"id": 865,
"code": "090128",
"name": "Ndiorah Microfinance Bank"
},
{
"id": 866,
"code": "090129",
"name": "Money Trust Microfinance Bank"
},
{
"id": 867,
"code": "090130",
"name": "Consumer Microfinance Bank"
},
{
"id": 868,
"code": "090131",
"name": "Allworkers Microfinance Bank"
},
{
"id": 869,
"code": "090132",
"name": "Richway Microfinance Bank"
},
{
"id": 870,
"code": "090133",
"name": " AL-Barakah Microfinance Bank"
},
{
"id": 871,
"code": "090134",
"name": "Accion Microfinance Bank"
},
{
"id": 872,
"code": "090135",
"name": "Personal Trust Microfinance Bank"
},
{
"id": 873,
"code": "090136",
"name": "Baobab Microfinance Bank"
},
{
"id": 874,
"code": "090137",
"name": "PecanTrust Microfinance Bank"
},
{
"id": 875,
"code": "090138",
"name": "Royal Exchange Microfinance Bank"
},
{
"id": 876,
"code": "090139",
"name": "Visa Microfinance Bank"
},
{
"id": 877,
"code": "090140",
"name": "Sagamu Microfinance Bank"
},
{
"id": 878,
"code": "090141",
"name": "Chikum Microfinance Bank"
},
{
"id": 879,
"code": "090142",
"name": "Yes Microfinance Bank"
},
{
"id": 880,
"code": "090143",
"name": "Apeks Microfinance Bank"
},
{
"id": 881,
"code": "090144",
"name": "CIT Microfinance Bank"
},
{
"id": 882,
"code": "090145",
"name": "Fullrange Microfinance Bank"
},
{
"id": 883,
"code": "090146",
"name": "Trident Microfinance Bank"
},
{
"id": 884,
"code": "090147",
"name": "Hackman Microfinance Bank"
},
{
"id": 885,
"code": "090148",
"name": "Bowen Microfinance Bank"
},
{
"id": 886,
"code": "090149",
"name": "IRL Microfinance Bank"
},
{
"id": 887,
"code": "090150",
"name": "Virtue Microfinance Bank"
},
{
"id": 888,
"code": "090151",
"name": "Mutual Trust Microfinance Bank"
},
{
"id": 889,
"code": "090152",
"name": "Nagarta Microfinance Bank"
},
{
"id": 890,
"code": "090153",
"name": "FFS Microfinance Bank"
},
{
"id": 891,
"code": "090154",
"name": "CEMCS Microfinance Bank"
},
{
"id": 892,
"code": "090155",
"name": "La Fayette Microfinance Bank"
},
{
"id": 893,
"code": "090156",
"name": "e-Barcs Microfinance Bank"
},
{
"id": 894,
"code": "090157",
"name": "Infinity Microfinance Bank"
},
{
"id": 895,
"code": "090158",
"name": "Futo Microfinance Bank"
},
{
"id": 896,
"code": "090159",
"name": "Credit Afrique Microfinance Bank"
},
{
"id": 897,
"code": "090160",
"name": "Addosser Microfinance Bank"
},
{
"id": 898,
"code": "090161",
"name": "Okpoga Microfinance Bank"
},
{
"id": 899,
"code": "090162",
"name": "Stanford Microfinance Bak"
},
{
"id": 900,
"code": "090164",
"name": "First Royal Microfinance Bank"
},
{
"id": 901,
"code": "090165",
"name": "Petra Microfinance Bank"
},
{
"id": 902,
"code": "090166",
"name": "Eso-E Microfinance Bank"
},
{
"id": 903,
"code": "090167",
"name": "Daylight Microfinance Bank"
},
{
"id": 904,
"code": "090168",
"name": "Gashua Microfinance Bank"
},
{
"id": 905,
"code": "090169",
"name": "Alpha Kapital Microfinance Bank"
},
{
"id": 906,
"code": "090171",
"name": "Mainstreet Microfinance Bank"
},
{
"id": 907,
"code": "090172",
"name": "Astrapolaris Microfinance Bank"
},
{
"id": 908,
"code": "090173",
"name": "Reliance Microfinance Bank"
},
{
"id": 909,
"code": "090174",
"name": "Malachy Microfinance Bank"
},
{
"id": 910,
"code": "090175",
"name": "HighStreet Microfinance Bank"
},
{
"id": 911,
"code": "090176",
"name": "Bosak Microfinance Bank"
},
{
"id": 912,
"code": "090177",
"name": "Lapo Microfinance Bank"
},
{
"id": 913,
"code": "090178",
"name": "GreenBank Microfinance Bank"
},
{
"id": 914,
"code": "090179",
"name": "FAST Microfinance Bank"
},
{
"id": 915,
"code": "090188",
"name": "Baines Credit Microfinance Bank"
},
{
"id": 916,
"code": "090189",
"name": "Esan Microfinance Bank"
},
{
"id": 917,
"code": "090190",
"name": "Mutual Benefits Microfinance Bank"
},
{
"id": 918,
"code": "090191",
"name": "KCMB Microfinance Bank"
},
{
"id": 919,
"code": "090192",
"name": "Midland Microfinance Bank"
},
{
"id": 920,
"code": "090193",
"name": "Unical Microfinance Bank"
},
{
"id": 921,
"code": "090194",
"name": "NIRSAL Microfinance Bank"
},
{
"id": 922,
"code": "090195",
"name": "Grooming Microfinance Bank"
},
{
"id": 923,
"code": "090196",
"name": "Pennywise Microfinance Bank"
},
{
"id": 924,
"code": "090197",
"name": "ABU Microfinance Bank"
},
{
"id": 925,
"code": "090198",
"name": "RenMoney Microfinance Bank"
},
{
"id": 926,
"code": "090205",
"name": "New Dawn Microfinance Bank"
},
{
"id": 927,
"code": "090251",
"name": "UNN MFB"
},
{
"id": 928,
"code": "090258",
"name": "Imo State Microfinance Bank"
},
{
"id": 929,
"code": "090259",
"name": "Alekun Microfinance Bank"
},
{
"id": 930,
"code": "090260",
"name": "Above Only Microfinance Bank"
},
{
"id": 931,
"code": "090261",
"name": "Quickfund Microfinance Bank"
},
{
"id": 932,
"code": "090262",
"name": "Stellas Microfinance Bank"
},
{
"id": 933,
"code": "090263",
"name": "Navy Microfinance Bank"
},
{
"id": 934,
"code": "090264",
"name": "Auchi Microfinance Bank"
},
{
"id": 935,
"code": "090265",
"name": "Lovonus Microfinance Bank"
},
{
"id": 936,
"code": "090266",
"name": "Uniben Microfinance Bank"
},
{
"id": 937,
"code": "090268",
"name": "Adeyemi College Staff Microfinance Bank"
},
{
"id": 938,
"code": "090269",
"name": "Greenville Microfinance Bank"
},
{
"id": 939,
"code": "090270",
"name": "AB Microfinance Bank"
},
{
"id": 940,
"code": "090271",
"name": "Lavender Microfinance Bank"
},
{
"id": 941,
"code": "090272",
"name": "Olabisi Onabanjo University Microfinance Bank"
},
{
"id": 942,
"code": "090273",
"name": "Emeralds Microfinance Bank"
},
{
"id": 943,
"code": "090276",
"name": "Trustfund Microfinance Bank"
},
{
"id": 944,
"code": "090277",
"name": "Al-Hayat Microfinance Bank"
},
{
"id": 945,
"code": "100001",
"name": "FET"
},
{
"id": 946,
"code": "100003",
"name": "Parkway-ReadyCash"
},
{
"id": 947,
"code": "100005",
"name": "Cellulant"
},
{
"id": 948,
"code": "100006",
"name": "eTranzact"
},
{
"id": 949,
"code": "100007",
"name": "Stanbic IBTC @ease wallet"
},
{
"id": 950,
"code": "100008",
"name": "Ecobank Xpress Account"
},
{
"id": 951,
"code": "100009",
"name": "GTMobile"
},
{
"id": 952,
"code": "100010",
"name": "TeasyMobile"
},
{
"id": 953,
"code": "100011",
"name": "Mkudi"
},
{
"id": 954,
"code": "100012",
"name": "VTNetworks"
},
{
"id": 955,
"code": "100013",
"name": "AccessMobile"
},
{
"id": 956,
"code": "100014",
"name": "FBNMobile"
},
{
"id": 957,
"code": "100015",
"name": "Kegow"
},
{
"id": 958,
"code": "100016",
"name": "FortisMobile"
},
{
"id": 959,
"code": "100017",
"name": "Hedonmark"
},
{
"id": 960,
"code": "100018",
"name": "ZenithMobile"
},
{
"id": 961,
"code": "110002",
"name": "Flutterwave Technology Solutions Limited"
},
{
"id": 962,
"code": "999999",
"name": "NIP Virtual Bank"
}
]
}
{ "status": "0", "message": "Could not make transaction"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBanks' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiFetchBanks',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBanks',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBanks")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Fetch all bills items API
POST
https://app.cashbuddy.ng/apis/apiFetchBills?network=all
To fetch bills categories send the network as query get params ?network=value e.g airtel, mtn, glo, 9mobile/etisalat, smile, spectranet, gotv, dstv, startimes, eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric, enugu-electric and all.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
{
"status": 1,
"message": "all bills retreived successfully.",
"data": [
{
"id": 1,
"biller_name": "AIRTIME",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL099"
},
{
"id": 2,
"biller_name": "AIRTIME",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL099"
},
{
"id": 3,
"biller_name": "AIRTIME",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL099"
},
{
"id": 4,
"biller_name": "AIRTIME",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL099"
},
{
"id": 6,
"biller_name": "AIRTIME",
"label_name": "Mobile Number",
"amount": 10,
"biller_code": "BIL135"
},
{
"id": 8,
"biller_name": "DSTV",
"label_name": "Smart card Number",
"amount": 0,
"biller_code": "BIL137"
},
{
"id": 12,
"biller_name": "TIGO",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL133"
},
{
"id": 13,
"biller_name": "MTN",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL132"
},
{
"id": 14,
"biller_name": "VODAFONE",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL134"
},
{
"id": 238,
"biller_name": "FIRS Company Tax Payment",
"label_name": "Tax Identification Number (TIN)",
"amount": 0,
"biller_code": "BIL130"
},
{
"id": 239,
"biller_name": "FIRS Education Tax",
"label_name": "Tax Identification Number (TIN)",
"amount": 0,
"biller_code": "BIL130"
},
{
"id": 255,
"biller_name": "DSTV Compact Plus",
"label_name": "SmartCard Number",
"amount": 180000,
"biller_code": "BIL156"
},
{
"id": 256,
"biller_name": "DSTV Family Uganda",
"label_name": "SmartCard Number",
"amount": 60000,
"biller_code": "BIL156"
},
{
"id": 257,
"biller_name": "DSTV Access Uganda",
"label_name": "SmartCard Number",
"amount": 33000,
"biller_code": "BIL156"
},
{
"id": 258,
"biller_name": "GOTV Light (Monthly)",
"label_name": "SmartCard Number",
"amount": 11000,
"biller_code": "BIL157"
},
{
"id": 259,
"biller_name": "GOTV PLUS",
"label_name": "SmartCard Number",
"amount": 28000,
"biller_code": "BIL157"
},
{
"id": 260,
"biller_name": "GOTV MAX",
"label_name": "SmartCard Number",
"amount": 39000,
"biller_code": "BIL157"
},
{
"id": 261,
"biller_name": "Gotv Value",
"label_name": "SmartCard Number",
"amount": 16000,
"biller_code": "BIL157"
},
{
"id": 262,
"biller_name": "Startime Basic",
"label_name": "SmartCard Number",
"amount": 1300,
"biller_code": "BIL160"
},
{
"id": 263,
"biller_name": "Startime Classic",
"label_name": "SmartCard Number",
"amount": 1900,
"biller_code": "BIL160"
},
{
"id": 264,
"biller_name": "Prepaid Topup",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL158"
},
{
"id": 265,
"biller_name": "PostPaid Top up",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL158"
},
{
"id": 266,
"biller_name": "NWSC Top up",
"label_name": "NWSC Number",
"amount": 1000,
"biller_code": "BIL159"
},
{
"id": 267,
"biller_name": "EKEDC PREPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL112"
},
{
"id": 268,
"biller_name": "EKEDC POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL112"
},
{
"id": 269,
"biller_name": "IKEDC PREPAID TOP UP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL113"
},
{
"id": 270,
"biller_name": "IKEDC POSTPAID TOP UP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL113"
},
{
"id": 271,
"biller_name": "IBADAN DISCO ELECTRICITY PREPAID TOP UP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL114"
},
{
"id": 272,
"biller_name": "IBADAN DISCO ELECTRICITY POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL114"
},
{
"id": 273,
"biller_name": "ENUGU DISCO ELECTRIC BILLS PREPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL115"
},
{
"id": 274,
"biller_name": "ENUGU DISCO ELECTRIC BILLS POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL115"
},
{
"id": 275,
"biller_name": "PHC DISCO POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL116"
},
{
"id": 276,
"biller_name": "BENIN DISCO POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL117"
},
{
"id": 277,
"biller_name": "BENIN DISCO PREPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL117"
},
{
"id": 278,
"biller_name": "YOLA DISCO TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL118"
},
{
"id": 279,
"biller_name": "KANO DISCO PREPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL120"
},
{
"id": 280,
"biller_name": "KANO DISCO POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL120"
},
{
"id": 287,
"biller_name": "DSTV COMPACT",
"label_name": "SmartCard Number",
"amount": 7900,
"biller_code": "BIL121"
},
{
"id": 288,
"biller_name": "DSTV COMPACT + HD",
"label_name": "SmartCard Number",
"amount": 10400,
"biller_code": "BIL121"
},
{
"id": 289,
"biller_name": "DSTV COMPACT PLUS",
"label_name": "SmartCard Number",
"amount": 12400,
"biller_code": "BIL121"
},
{
"id": 290,
"biller_name": "DSTV COMPACT PLUS + ASIA",
"label_name": "SmartCard Number",
"amount": 18600,
"biller_code": "BIL121"
},
{
"id": 291,
"biller_name": "DSTV COMPACT PLUS + HD",
"label_name": "SmartCard Number",
"amount": 14900,
"biller_code": "BIL121"
},
{
"id": 292,
"biller_name": "DSTV PREMIUM",
"label_name": "SmartCard Number",
"amount": 18400,
"biller_code": "BIL121"
},
{
"id": 293,
"biller_name": "DSTV PREMIUM ASIA",
"label_name": "SmartCard Number",
"amount": 17700,
"biller_code": "BIL121"
},
{
"id": 294,
"biller_name": "DSTV PREMIUM + HD",
"label_name": "SmartCard Number",
"amount": 20900,
"biller_code": "BIL121"
},
{
"id": 295,
"biller_name": "DSTV BOX OFFICE",
"label_name": "SmartCard Number",
"amount": 0,
"biller_code": "BIL121"
},
{
"id": 296,
"biller_name": "GOTV LIGHT",
"label_name": "SmartCard Number",
"amount": 410,
"biller_code": "BIL122"
},
{
"id": 299,
"biller_name": "GOTV MAX",
"label_name": "SmartCard Number",
"amount": 3600,
"biller_code": "BIL122"
},
{
"id": 300,
"biller_name": "NOVA - One Day",
"label_name": "SmartCard Number",
"amount": 60,
"biller_code": "BIL123"
},
{
"id": 301,
"biller_name": "NOVA - One Week",
"label_name": "SmartCard Number",
"amount": 300,
"biller_code": "BIL123"
},
{
"id": 302,
"biller_name": "NOVA - One Month",
"label_name": "SmartCard Number",
"amount": 900,
"biller_code": "BIL123"
},
{
"id": 303,
"biller_name": "BASIC - One Day",
"label_name": "SmartCard Number",
"amount": 90,
"biller_code": "BIL123"
},
{
"id": 304,
"biller_name": "BASIC - One Week",
"label_name": "SmartCard Number",
"amount": 450,
"biller_code": "BIL123"
},
{
"id": 305,
"biller_name": "BASIC - One Month",
"label_name": "SmartCard Number",
"amount": 1300,
"biller_code": "BIL123"
},
{
"id": 306,
"biller_name": "SMART - One Day",
"label_name": "SmartCard Number",
"amount": 120,
"biller_code": "BIL123"
},
{
"id": 307,
"biller_name": "SMART - One Week",
"label_name": "SmartCard Number",
"amount": 600,
"biller_code": "BIL123"
},
{
"id": 308,
"biller_name": "SMART - One Month",
"label_name": "SmartCard Number",
"amount": 1900,
"biller_code": "BIL123"
},
{
"id": 309,
"biller_name": "CLASSIC - One Day",
"label_name": "SmartCard Number",
"amount": 180,
"biller_code": "BIL123"
},
{
"id": 310,
"biller_name": "CLASSIC - One Week",
"label_name": "SmartCard Number",
"amount": 900,
"biller_code": "BIL123"
},
{
"id": 311,
"biller_name": "CLASSIC - One month",
"label_name": "SmartCard Number",
"amount": 2600,
"biller_code": "BIL123"
},
{
"id": 312,
"biller_name": "UNIQUE - One Day",
"label_name": "SmartCard Number",
"amount": 240,
"biller_code": "BIL123"
},
{
"id": 314,
"biller_name": "UNIQUE - One Month",
"label_name": "SmartCard Number",
"amount": 3800,
"biller_code": "BIL123"
},
{
"id": 315,
"biller_name": "SUPER - One Day",
"label_name": "SmartCard Number",
"amount": 240,
"biller_code": "BIL123"
},
{
"id": 316,
"biller_name": "SUPER - One Week",
"label_name": "SmartCard Number",
"amount": 1200,
"biller_code": "BIL123"
},
{
"id": 317,
"biller_name": "SUPER - One Month",
"label_name": "SmartCard Number",
"amount": 3800,
"biller_code": "BIL123"
},
{
"id": 365,
"biller_name": "MTN 200 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 200,
"biller_code": "BIL108"
},
{
"id": 366,
"biller_name": "MTN 750MB data top-up service",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL108"
},
{
"id": 367,
"biller_name": "MTN 1.5 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 1000,
"biller_code": "BIL108"
},
{
"id": 368,
"biller_name": "MTN 4.5 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 2000,
"biller_code": "BIL108"
},
{
"id": 369,
"biller_name": "MTN 10 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 3500,
"biller_code": "BIL108"
},
{
"id": 370,
"biller_name": "MTN 15 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 5000,
"biller_code": "BIL108"
},
{
"id": 371,
"biller_name": "MTN 40 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 10000,
"biller_code": "BIL108"
},
{
"id": 372,
"biller_name": "MTN 75 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 20000,
"biller_code": "BIL108"
},
{
"id": 373,
"biller_name": "MTN 120 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 30000,
"biller_code": "BIL108"
},
{
"id": 374,
"biller_name": "GLO 35 MB data bundle",
"label_name": "Mobile Number",
"amount": 100,
"biller_code": "BIL109"
},
{
"id": 375,
"biller_name": "GLO 100 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 200,
"biller_code": "BIL109"
},
{
"id": 376,
"biller_name": "GLO 920 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL109"
},
{
"id": 377,
"biller_name": "GLO 1.8GB data purchase",
"label_name": "Mobile Number",
"amount": 1000,
"biller_code": "BIL109"
},
{
"id": 378,
"biller_name": "GLO 4.5GB data bundle",
"label_name": "Mobile Number",
"amount": 2000,
"biller_code": "BIL109"
},
{
"id": 379,
"biller_name": "GLO 7.2GB data bundle",
"label_name": "Mobile Number",
"amount": 2500,
"biller_code": "BIL109"
},
{
"id": 380,
"biller_name": "GLO 8.75GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 3000,
"biller_code": "BIL109"
},
{
"id": 381,
"biller_name": "GLO 12.5GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 4000,
"biller_code": "BIL109"
},
{
"id": 382,
"biller_name": "GLO 15.6GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 5000,
"biller_code": "BIL109"
},
{
"id": 383,
"biller_name": "GLO 25GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 8000,
"biller_code": "BIL109"
},
{
"id": 384,
"biller_name": "GLO 32.5GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 10000,
"biller_code": "BIL109"
},
{
"id": 385,
"biller_name": "GLO 52.5GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 15000,
"biller_code": "BIL109"
},
{
"id": 386,
"biller_name": "GLO 62.5GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 18000,
"biller_code": "BIL109"
},
{
"id": 387,
"biller_name": "AIRTEL 40 MB data bundle",
"label_name": "Mobile Number",
"amount": 50,
"biller_code": "BIL110"
},
{
"id": 388,
"biller_name": "AIRTEL 100 MB data bundle",
"label_name": "Mobile Number",
"amount": 100,
"biller_code": "BIL110"
},
{
"id": 389,
"biller_name": "AIRTEL 200 MB data bundle",
"label_name": "Mobile Number",
"amount": 200,
"biller_code": "BIL110"
},
{
"id": 390,
"biller_name": "AIRTEL 350 MB data bundle",
"label_name": "Mobile Number",
"amount": 300,
"biller_code": "BIL110"
},
{
"id": 391,
"biller_name": "AIRTEL 750 MB data bundle",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL110"
},
{
"id": 392,
"biller_name": "AIRTEL 1.5GB data bundle",
"label_name": "Mobile Number",
"amount": 1000,
"biller_code": "BIL110"
},
{
"id": 393,
"biller_name": "AIRTEL 3GB Data Bundle",
"label_name": "Mobile Number",
"amount": 1500,
"biller_code": "BIL110"
},
{
"id": 394,
"biller_name": "AIRTEL 6GB Data Bundle",
"label_name": "Mobile Number",
"amount": 2500,
"biller_code": "BIL110"
},
{
"id": 395,
"biller_name": "AIRTEL 8GB Data Bundle",
"label_name": "Mobile Number",
"amount": 3000,
"biller_code": "BIL110"
},
{
"id": 396,
"biller_name": "AIRTEL 11GB Data Bundle",
"label_name": "Mobile Number",
"amount": 4000,
"biller_code": "BIL110"
},
{
"id": 397,
"biller_name": "AIRTEL 15GB Data Bundle",
"label_name": "Mobile Number",
"amount": 5000,
"biller_code": "BIL110"
},
{
"id": 398,
"biller_name": "AIRTEL 40GB Data Bundle",
"label_name": "Mobile Number",
"amount": 10000,
"biller_code": "BIL110"
},
{
"id": 399,
"biller_name": "AIRTEL 75GB Data Bundle",
"label_name": "Mobile Number",
"amount": 15000,
"biller_code": "BIL110"
},
{
"id": 402,
"biller_name": "9MOBILE 1.5GB data bundle",
"label_name": "Mobile Number",
"amount": 1000,
"biller_code": "BIL111"
},
{
"id": 403,
"biller_name": "9MOBILE 4.5GB data bundle",
"label_name": "Mobile Number",
"amount": 2000,
"biller_code": "BIL111"
},
{
"id": 404,
"biller_name": "9MOBILE 4GB data bundle",
"label_name": "Mobile Number",
"amount": 3000,
"biller_code": "BIL111"
},
{
"id": 405,
"biller_name": "9MOBILE 11.5GB data bundle ",
"label_name": "Mobile Number",
"amount": 4000,
"biller_code": "BIL111"
},
{
"id": 406,
"biller_name": "9MOBILE 15GB data bundle ",
"label_name": "Mobile Number",
"amount": 5000,
"biller_code": "BIL111"
},
{
"id": 407,
"biller_name": "9MOBILE 27.5GB data bundle ",
"label_name": "Mobile Number",
"amount": 18000,
"biller_code": "BIL111"
},
{
"id": 408,
"biller_name": "9MOBILE 30GB data bundle ",
"label_name": "Mobile Number",
"amount": 27500,
"biller_code": "BIL111"
},
{
"id": 409,
"biller_name": "9MOBILE 60GB data bundle ",
"label_name": "Mobile Number",
"amount": 55000,
"biller_code": "BIL111"
},
{
"id": 410,
"biller_name": "LCC Top up",
"label_name": "Lcc Number",
"amount": 0,
"biller_code": "BIL127"
},
{
"id": 411,
"biller_name": "Lekki Concession Company (Lekki - Epe Expressway)",
"label_name": "Lcc Number",
"amount": 0,
"biller_code": "BIL127"
},
{
"id": 412,
"biller_name": "Lekki Concession Company (Ikoyi Bridge)",
"label_name": "Lcc Number",
"amount": 0,
"biller_code": "BIL127"
},
{
"id": 432,
"biller_name": "TOP UP ACCOUNT",
"label_name": "Account Number",
"amount": 0,
"biller_code": "BIL125"
},
{
"id": 433,
"biller_name": "SWIFT TOP UP",
"label_name": "Account Number",
"amount": 0,
"biller_code": "BIL126"
},
{
"id": 434,
"biller_name": "ipNX Family Plan",
"label_name": "Account Number",
"amount": 6300,
"biller_code": "BIL129"
},
{
"id": 435,
"biller_name": "Starter Basic Plan",
"label_name": "Account Number",
"amount": 7900,
"biller_code": "BIL129"
},
{
"id": 436,
"biller_name": "Unlimited Starter Plan",
"label_name": "Account Number",
"amount": 12900,
"biller_code": "BIL129"
},
{
"id": 437,
"biller_name": "SMILE 21GB BUNDLE",
"label_name": "Account Number",
"amount": 8190,
"biller_code": "BIL124"
},
{
"id": 438,
"biller_name": "SMILE LITE 1.5GB BUNDLE",
"label_name": "Account Number",
"amount": 1020,
"biller_code": "BIL124"
},
{
"id": 439,
"biller_name": "SMILE 7GB BUNDLE",
"label_name": "Account Number",
"amount": 4090,
"biller_code": "BIL124"
},
{
"id": 440,
"biller_name": "SMILE 15GB DATA BUNDLE",
"label_name": "Account Number",
"amount": 6140,
"biller_code": "BIL124"
},
{
"id": 441,
"biller_name": "SMILE 1GB Flexi Daily Data Plan 1 Day",
"label_name": "Account Number",
"amount": 350,
"biller_code": "BIL124"
},
{
"id": 442,
"biller_name": "SMILE 2GB Flexi Weekly Data Plan 7 Days",
"label_name": "Account Number",
"amount": 1020,
"biller_code": "BIL124"
},
{
"id": 443,
"biller_name": "SMILE 30GB Bumpa Data Plan 60 Days",
"label_name": "Account Number",
"amount": 15350,
"biller_code": "BIL124"
},
{
"id": 444,
"biller_name": "SMILE 60GB BumpaValue Data Plan 90 Days",
"label_name": "Account Number",
"amount": 30700,
"biller_code": "BIL124"
},
{
"id": 445,
"biller_name": "SMILE 80GB BumpaValue Plan 120 Days",
"label_name": "Account Number",
"amount": 50000,
"biller_code": "BIL124"
},
{
"id": 446,
"biller_name": "SMILE 2GB MidNite Plan",
"label_name": "Account Number",
"amount": 1020,
"biller_code": "BIL124"
},
{
"id": 447,
"biller_name": "SMILE 3GB MidNite Plan",
"label_name": "Account Number",
"amount": 1530,
"biller_code": "BIL124"
},
{
"id": 448,
"biller_name": "SMILE 3GB Weekend Plan",
"label_name": "Account Number",
"amount": 1530,
"biller_code": "BIL124"
},
{
"id": 449,
"biller_name": "SMILE 3GB Data Bundle",
"label_name": "Account Number",
"amount": 3000,
"biller_code": "BIL124"
},
{
"id": 450,
"biller_name": "SMILE 10GB Data Bundle",
"label_name": "Account Number",
"amount": 9000,
"biller_code": "BIL124"
},
{
"id": 451,
"biller_name": "SMILE 50GB Data Bundle",
"label_name": "Account Number",
"amount": 36850,
"biller_code": "BIL124"
},
{
"id": 452,
"biller_name": "Smile UnlimitedLite Plan",
"label_name": "Account Number",
"amount": 10230,
"biller_code": "BIL124"
},
{
"id": 453,
"biller_name": "SMILE - Unlimited Premium ",
"label_name": "Account Number",
"amount": 19800,
"biller_code": "BIL124"
},
{
"id": 454,
"biller_name": "SMILE - 100GB Data Bundle ",
"label_name": "Account Number",
"amount": 71650,
"biller_code": "BIL124"
},
{
"id": 455,
"biller_name": "SMILE - 200GB Data Bundle ",
"label_name": "Account Number",
"amount": 138200,
"biller_code": "BIL124"
},
{
"id": 16858,
"biller_name": "MTN VTU ",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL132"
},
{
"id": 16859,
"biller_name": "TIGO VTU",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL133"
},
{
"id": 16860,
"biller_name": "VODAFONE VTU",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL134"
},
{
"id": 16861,
"biller_name": "VODAFONE POSTPAID PAYMENT",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL140"
},
{
"id": 16862,
"biller_name": "AIRTEL ",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL187"
},
{
"id": 16863,
"biller_name": "SAFARICOM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL188"
},
{
"id": 16864,
"biller_name": "TELKOM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL189"
},
{
"id": 16865,
"biller_name": "DSTV Payment",
"label_name": "Smart card Number",
"amount": 0,
"biller_code": "BIL190"
},
{
"id": 16866,
"biller_name": "GOTV Payment",
"label_name": "Smart card Number",
"amount": 0,
"biller_code": "BIL192"
},
{
"id": 16867,
"biller_name": "STARTIMES Payment",
"label_name": "Smart card Number",
"amount": 0,
"biller_code": "BIL193"
},
{
"id": 16868,
"biller_name": "KPLC PREPAID",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL191"
},
{
"id": 16869,
"biller_name": "KPLC POSTPAID",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL191"
},
{
"id": 16870,
"biller_name": "NAIROBI WATER",
"label_name": "Meter Number",
"amount": 0,
"biller_code": "BIL194"
},
{
"id": 16871,
"biller_name": "9MOBILE 650 MB data bundle",
"label_name": "Mobile Number",
"amount": 200,
"biller_code": "BIL111"
},
{
"id": 16872,
"biller_name": "MTN 8GB data purchase (1 Month)",
"label_name": "Mobile Number",
"amount": 3000,
"biller_code": "BIL108"
},
{
"id": 16873,
"biller_name": "MTN 2.5GB data purchase (2 Days)",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL108"
},
{
"id": 16874,
"biller_name": "MTN 6GB data purchase (1 Month)",
"label_name": "Mobile Number",
"amount": 2500,
"biller_code": "BIL108"
},
{
"id": 16881,
"biller_name": "MTN 100 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 100,
"biller_code": "BIL108"
},
{
"id": 16882,
"biller_name": "MTN 350 data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 300,
"biller_code": "BIL108"
},
{
"id": 16883,
"biller_name": "MTN 1GB data purchase (1 day)",
"label_name": "Mobile Number",
"amount": 350,
"biller_code": "BIL108"
},
{
"id": 16884,
"biller_name": "MTN 750 data purchase (7Days)",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL108"
},
{
"id": 16885,
"biller_name": "MTN 3GB data purchase",
"label_name": "Mobile Number",
"amount": 1500,
"biller_code": "BIL108"
},
{
"id": 16886,
"biller_name": "MTN 2GB data purchase",
"label_name": "Mobile Number",
"amount": 1200,
"biller_code": "BIL108"
},
{
"id": 16887,
"biller_name": "MTN 6GB data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 1500,
"biller_code": "BIL108"
},
{
"id": 16888,
"biller_name": "MTN 1GB data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 500,
"biller_code": "BIL108"
},
{
"id": 16889,
"biller_name": "DStv Yanga",
"label_name": "SmartCard Number",
"amount": 2565,
"biller_code": "BIL121"
},
{
"id": 16894,
"biller_name": "DStv Confam",
"label_name": "SmartCard Number",
"amount": 4620,
"biller_code": "BIL121"
},
{
"id": 16895,
"biller_name": "DStv Yanga + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 5065,
"biller_code": "BIL121"
},
{
"id": 16896,
"biller_name": "DStv Confam Bouquet E36 + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 7115,
"biller_code": "BIL121"
},
{
"id": 16897,
"biller_name": "GOtv Jinja",
"label_name": "SmartCard Number",
"amount": 1640,
"biller_code": "BIL122"
},
{
"id": 16898,
"biller_name": "GOtv Jolli",
"label_name": "SmartCard Number",
"amount": 2460,
"biller_code": "BIL122"
},
{
"id": 16899,
"biller_name": "Compact Plus + Asia +Xtraview",
"label_name": "Smartcard Number",
"amount": 21100,
"biller_code": "BIL121"
},
{
"id": 16903,
"biller_name": "Compact Plus + French Touch",
"label_name": "SmartCard Number",
"amount": 14700,
"biller_code": "BIL121"
},
{
"id": 16904,
"biller_name": "Compact Plus + French Plus",
"label_name": "SmartCard Number",
"amount": 20500,
"biller_code": "BIL121"
},
{
"id": 16905,
"biller_name": "DSTV PADI",
"label_name": "SmartCard Number",
"amount": 1850,
"biller_code": "BIL121"
},
{
"id": 16906,
"biller_name": "DSTV PADI + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 4350,
"biller_code": "BIL121"
},
{
"id": 16907,
"biller_name": "DSTV",
"label_name": "Smartcard Number",
"amount": 0,
"biller_code": "BIL121"
},
{
"id": 16908,
"biller_name": "AIRTEL ZM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL196"
},
{
"id": 16909,
"biller_name": "MTN ZM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL197"
},
{
"id": 16910,
"biller_name": "VODAFONE ZM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL198"
},
{
"id": 16911,
"biller_name": "ZAMTEL ZM",
"label_name": "Mobile Number",
"amount": 0,
"biller_code": "BIL199"
}
]
}
{ "status": "0", "message": "Could not make transaction"}
{ "status": "0", "message": "Invalid access key"}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=all' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiFetchBills?network=all',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=all',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=all")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Fetch electricity bills plans {eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric}
POST
https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric
To fetch electricity plans send the distribution as the network, this is the list of available distribution eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric. biller_name will be returned at every call to identify the plan you are paying for. For electricity biller_name will carry either prepared or postpaid
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
{
"status": 1,
"message": "eko-electric bills retreived successfully.",
"data": {
"23": {
"id": 267,
"biller_name": "EKEDC PREPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"commission": "2.0%"
},
"24": {
"id": 268,
"biller_name": "EKEDC POSTPAID TOPUP",
"label_name": "Meter Number",
"amount": 0,
"commission": "2.0%"
}
}
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Fetch data plans{mtn, glo, 9mobile, airtel}
POST
https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn
To fetch data plans send the network e.g mtn, glo, etisalat/9mobile and airtel. biller_name will be returned at every call to identify the plan you are paying for. For data plan biller_name will carry either the name of the plan
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
{
"status": 1,
"message": "mtn bills retreived successfully.",
"data": {
"65": {
"id": 365,
"biller_name": "MTN 200 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 200,
"commission": "1.3%",
"profit": "₦2.6"
},
"66": {
"id": 366,
"biller_name": "MTN 750MB data top-up service",
"label_name": "Mobile Number",
"amount": 500,
"commission": "1.3%",
"profit": "₦6.5"
},
"67": {
"id": 367,
"biller_name": "MTN 1.5 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 1000,
"commission": "1.3%",
"profit": "₦13"
},
"68": {
"id": 368,
"biller_name": "MTN 4.5 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 2000,
"commission": "1.3%",
"profit": "₦26"
},
"69": {
"id": 369,
"biller_name": "MTN 10 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 3500,
"commission": "1.3%",
"profit": "₦45.5"
},
"70": {
"id": 370,
"biller_name": "MTN 15 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 5000,
"commission": "1.3%",
"profit": "₦65"
},
"71": {
"id": 371,
"biller_name": "MTN 40 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 10000,
"commission": "1.3%",
"profit": "₦130"
},
"72": {
"id": 372,
"biller_name": "MTN 75 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 20000,
"commission": "1.3%",
"profit": "₦260"
},
"73": {
"id": 373,
"biller_name": "MTN 120 GB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 30000,
"commission": "1.3%",
"profit": "₦390"
},
"149": {
"id": 16872,
"biller_name": "MTN 8GB data purchase (1 Month)",
"label_name": "Mobile Number",
"amount": 3000,
"commission": "1.3%",
"profit": "₦39"
},
"150": {
"id": 16873,
"biller_name": "MTN 2.5GB data purchase (2 Days)",
"label_name": "Mobile Number",
"amount": 500,
"commission": "1.3%",
"profit": "₦6.5"
},
"151": {
"id": 16874,
"biller_name": "MTN 6GB data purchase (1 Month)",
"label_name": "Mobile Number",
"amount": 2500,
"commission": "1.3%",
"profit": "₦32.5"
},
"152": {
"id": 16881,
"biller_name": "MTN 100 MB DATA BUNDLE",
"label_name": "Mobile Number",
"amount": 100,
"commission": "1.3%",
"profit": "₦1.3"
},
"153": {
"id": 16882,
"biller_name": "MTN 350 data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 300,
"commission": "1.3%",
"profit": "₦3.9"
},
"154": {
"id": 16883,
"biller_name": "MTN 1GB data purchase (1 day)",
"label_name": "Mobile Number",
"amount": 350,
"commission": "1.3%",
"profit": "₦4.55"
},
"155": {
"id": 16884,
"biller_name": "MTN 750 data purchase (7Days)",
"label_name": "Mobile Number",
"amount": 500,
"commission": "1.3%",
"profit": "₦6.5"
},
"156": {
"id": 16885,
"biller_name": "MTN 3GB data purchase",
"label_name": "Mobile Number",
"amount": 1500,
"commission": "1.3%",
"profit": "₦19.5"
},
"157": {
"id": 16886,
"biller_name": "MTN 2GB data purchase",
"label_name": "Mobile Number",
"amount": 1200,
"commission": "1.3%",
"profit": "₦15.6"
},
"158": {
"id": 16887,
"biller_name": "MTN 6GB data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 1500,
"commission": "1.3%",
"profit": "₦19.5"
},
"159": {
"id": 16888,
"biller_name": "MTN 1GB data purchase (7 days)",
"label_name": "Mobile Number",
"amount": 500,
"commission": "1.3%",
"profit": "₦6.5"
}
}
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Fetch cable/tv subscription plans{dstv, gotv, startimes}
POST
https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv
Pay for your cable subscription with this endpoint.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
{
"status": 1,
"message": "dstv bills retreived successfully.",
"data": {
"37": {
"id": 287,
"biller_name": "DSTV COMPACT",
"label_name": "SmartCard Number",
"amount": 7900,
"commission": "2.0%",
"profit": "₦158"
},
"38": {
"id": 288,
"biller_name": "DSTV COMPACT + HD",
"label_name": "SmartCard Number",
"amount": 10400,
"commission": "2.0%",
"profit": "₦208"
},
"39": {
"id": 289,
"biller_name": "DSTV COMPACT PLUS",
"label_name": "SmartCard Number",
"amount": 12400,
"commission": "2.0%",
"profit": "₦248"
},
"40": {
"id": 290,
"biller_name": "DSTV COMPACT PLUS + ASIA",
"label_name": "SmartCard Number",
"amount": 18600,
"commission": "2.0%",
"profit": "₦372"
},
"41": {
"id": 291,
"biller_name": "DSTV COMPACT PLUS + HD",
"label_name": "SmartCard Number",
"amount": 14900,
"commission": "2.0%",
"profit": "₦298"
},
"42": {
"id": 292,
"biller_name": "DSTV PREMIUM",
"label_name": "SmartCard Number",
"amount": 18400,
"commission": "2.0%",
"profit": "₦368"
},
"43": {
"id": 293,
"biller_name": "DSTV PREMIUM ASIA",
"label_name": "SmartCard Number",
"amount": 17700,
"commission": "2.0%",
"profit": "₦354"
},
"44": {
"id": 294,
"biller_name": "DSTV PREMIUM + HD",
"label_name": "SmartCard Number",
"amount": 20900,
"commission": "2.0%",
"profit": "₦418"
},
"45": {
"id": 295,
"biller_name": "DSTV BOX OFFICE",
"label_name": "SmartCard Number",
"amount": 0,
"commission": "2.0%",
"profit": "₦0"
},
"160": {
"id": 16889,
"biller_name": "DStv Yanga",
"label_name": "SmartCard Number",
"amount": 2565,
"commission": "2.0%",
"profit": "₦51.3"
},
"161": {
"id": 16894,
"biller_name": "DStv Confam",
"label_name": "SmartCard Number",
"amount": 4620,
"commission": "2.0%",
"profit": "₦92.4"
},
"162": {
"id": 16895,
"biller_name": "DStv Yanga + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 5065,
"commission": "2.0%",
"profit": "₦101.3"
},
"163": {
"id": 16896,
"biller_name": "DStv Confam Bouquet E36 + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 7115,
"commission": "2.0%",
"profit": "₦142.3"
},
"166": {
"id": 16899,
"biller_name": "Compact Plus + Asia +Xtraview",
"label_name": "Smartcard Number",
"amount": 21100,
"commission": "2.0%",
"profit": "₦422"
},
"167": {
"id": 16903,
"biller_name": "Compact Plus + French Touch",
"label_name": "SmartCard Number",
"amount": 14700,
"commission": "2.0%",
"profit": "₦294"
},
"168": {
"id": 16904,
"biller_name": "Compact Plus + French Plus",
"label_name": "SmartCard Number",
"amount": 20500,
"commission": "2.0%",
"profit": "₦410"
},
"169": {
"id": 16905,
"biller_name": "DSTV PADI",
"label_name": "SmartCard Number",
"amount": 1850,
"commission": "2.0%",
"profit": "₦37"
},
"170": {
"id": 16906,
"biller_name": "DSTV PADI + XTRA VIEW",
"label_name": "SmartCard Number",
"amount": 4350,
"commission": "2.0%",
"profit": "₦87"
},
"171": {
"id": 16907,
"biller_name": "DSTV",
"label_name": "Smartcard Number",
"amount": 0,
"commission": "2.0%",
"profit": "₦0"
}
}
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Verification APIs
Bank Verification/Resolve account number API
POST
https://app.cashbuddy.ng/apis/apiVerifyBank
Resolve an account number to fetch the account name with this endpoints its 100% free.
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
bank_code
string
The bank code to resolve.
account_no
number
Account number of the user.
string
The email account attributed to your secret key.
{
"status": 1,
"message": "verified|SUNDAY AYODEJI **********"
}
{
"status": 0,
"message": "not verified"
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiVerifyBank' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'account_no="123456****"' \
--form 'bank_code="046"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiVerifyBank',
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 => array('email' => 'developer@cashbuddy.com','account_no' => '123456****','bank_code' => '046'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiVerifyBank',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'account_no': '123456****',
'bank_code': '046'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiVerifyBank")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("account_no", "123456****")
.field("bank_code", "046")
.asString();
BVN Verification API
POST
https://app.cashbuddy.ng/apis/apiVerifyBVN
Supply the BVN value and get the information for the user this costs ₦20
Headers
Secret-Key
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Request Body
string
The email account attributed to your secret key.
bvn
number
The BVN to resolve.
{
"status": "1",
"message": "BVN-API verification was successfull",
"data": {
"status": true,
"message": "BVN resolved",
"data": {
"title": "",
"first_name": "*******",
"middle_name": "*******",
"last_name": "********",
"name_on_card": "******** ***** *****",
"marital_status": "Single",
"dob": "******",
"formatted_dob": "****",
"mobile": "*******",
"mobile2": "***",
"registration_date": "****",
"formatted_registration_date": "****",
"bvn": "***",
"gender": "Male",
"lga_of_origin": "Ondo West",
"state_of_origin": "Ondo State",
"residential_address": "************",
"lga_of_residence": "Ondo West",
"nationality": "Nigeria",
"email": "************",
"is_blacklisted": false,
"enrollment_bank": {
"name": "Opportunity Bank Uganda Ltd",
"code": null,
"enrollment_branch": null
},
"level_of_account": "Level 1 - Low Level Accounts",
"nin": "",
"base_64_image": "*******"
}
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiVerifyBVN' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'bvn="123456****"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiVerifyBVN',
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 => array('email' => 'developer@cashbuddy.com','bvn' => '123456****'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiVerifyBVN',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'bvn': '123456****'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiVerifyBVN")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("bvn", "123456****")
.asString();
Airtime To Cash
Request for airtime to cash conversion, be sure to dial the result returned on the data's value (replace YOUR PIN with your mobile network airtime transfer pin)
POST
https://app.cashbuddy.ng/apis/apiAirtimeToCash
Headers
Secret-Key*
string
Bearer YOUR_SECRET_KEY
Request Body
reference_id
string
j900o0PPKe93
sub_user
string
Your User's Identifier (for businesses)
phone*
string
08100000000
network*
string
mtn, airtel, glo, q9mobile
amount*
number
2000
email*
string
developer@cashbuddy.com
{
"status": "1",
"message": "Request is successful",
"data": "*777*09033772261*2000*YOUR PIN#"
}
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiAirtimeToCash' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"' \
--form 'amount="2000"' \
--form 'network="mtn"' \
--form 'phone="08100000000"' \
--form 'sub_user=""' \
--form 'reference_id="j900o0PPKe93"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiAirtimeToCash',
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 => array('email' => 'developer@cashbuddy.com','amount' => '2000','network' => 'airtel','phone' => '08100000000','reference_id' => 'j900o0PPKe93'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiAirtimeToCash',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com',
'amount': '2000',
'network': 'glo',
'phone': '08100000000',
'sub_user': '',
'reference_id': 'iksnuisdguiiw12'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiAirtimeToCash")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.field("amount", "2000")
.field("network", "9mobile")
.field("phone", "08100000000")
.field("reference_id", "jks893iukJMkjd")
.asString();
Airtime To Cash History
Get and filter airtime to cash transaction history
POST
https://app.cashbuddy.ng/apis/apiAirtimeToCashHistory
Query Parameters
status
string
Either approved, denied, pending
reference_id
string
Reference ID
Headers
Secret-Key*
string
Bearer YOUR_SECRET_KEY
{
"success": 1,
"message": "Transactions fetched",
"data": [
{
"amount": "50.00",
"fee": "11.00",
"network": "mtn",
"status": "denied",
"sub_user": null,
"reference_id": null,
"created_at": "2021-04-28 10:07:19"
},
{
"amount": "200.00",
"fee": "20.00",
"network": "mtn",
"status": "denied",
"sub_user": "jeoeiio",
"reference_id": "ii2",
"created_at": "2022-03-11 09:08:50"
}
]
}
curl --location --request POST 'https://app.cashbuddy.ng/apis//apiAirtimeToCashHistory' \
--header 'Secret-Key: Bearer YOUR_SECRET_KEY' \
--form 'email="developer@cashbuddy.com"'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.cashbuddy.ng/apis/apiAirtimeToCashHistory',
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 => array('email' => 'developer@cashbuddy.com'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: Bearer YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiAirtimeToCashHistory',
'headers': {
'Secret-Key': 'Bearer YOUR_SECRET_KEY'
},
formData: {
'email': 'developer@cashbuddy.com'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiAirtimeToCashHistory")
.header("Secret-Key", "Bearer YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "developer@cashbuddy.com")
.asString();
Last updated