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

post
Airtime API

https://app.cashbuddy.ng/apis/apiAirtime
This endpoint allows you to get free airtime.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
Account email attributed your secret key.
amount
required
number
Amount of the airtime
phone
required
number
Phone number to recharge
network
required
string
The network provider of the user
Response
200: OK
Airtime purchase successfully.
{ "status": "1", "message": "Airtime purchase was successful", "network": "mtn"}
302: Found
{ "status": "0", "message": "Could not make transaction", "network": "mtn"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiAirtime' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'phone=""' \
--form 'network=""' \
--form 'amount=""'
PHP
<?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' => '[email protected]','phone' => '','network' => '','amount' => ''),
CURLOPT_HTTPHEADER => array(
'secret_key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
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': '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\[email protected]\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();
JAVA
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("email","[email protected]")
.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();

post
Data API

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.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
biller_name
required
string
Get the biller name from fetch bills endpoint after supplying the network needed, all list of data plans will be returned.
amount
required
number
The amount attributed to the data plan.
network
required
string
The network providers e.g mtn, glo, 9mobile, airtel, smile, spectranet.
phone
required
number
Phone number to recharge.
email
required
string
The email attributed to your secret key.
Response
200: OK
{ "status": "1", "message": "Data purchase was successful", "network": "mtn"}
302: Found
{ "status": "0", "message": "Could not make transaction", "network": "mtn"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiData' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'phone="08103******"' \
--form 'network="mtn"' \
--form 'amount="500"' \
--form 'biller_name=""'
PHP
<?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' => '[email protected]','phone' => '08103******','network' => 'mtn','amount' => '500','biller_name' => ''),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiData',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]',
'phone': '08103******',
'network': 'mtn',
'amount': '500',
'biller_name': ''
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("email","[email protected]")
.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", "YOUR_SECRET_KEY")
.build();
Response response = client.newCall(request).execute();

post
Electricity API

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.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
amount
required
integer
Amount to be paid to the electricity distribution.
meter_number
required
number
The meter number of your electronic meter.
biller_name
required
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
required
string
Available networks are eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric.
email
required
string
The email account attributed to your secret key.
Response
200: OK
{ "status": "1", "message": "Electricity payment was successful"}
302: Found
{ "status": "0", "message": "Could not make transaction"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiElectricity' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'meter_number="29728728*******"' \
--form 'network="eko-electric"' \
--form 'amount="10000"' \
--form 'biller_name="EKEDC PREPAID TOPUP"'
PHP
<?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' => '[email protected]','meter_number' => '29728728*****','network' => 'eko-electric','amount' => '10000','biller_name' => 'EKEDC PREPAID TOPUP'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiElectricity',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]',
'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);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiElectricity")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.field("meter_number", "2972872827*****")
.field("network", "eko-electric")
.field("amount", "10000")
.field("biller_name", "EKEDC PREPAID TOPUP")
.asString();

post
Cable/TV Subscription API

https://app.cashbuddy.ng/apis/apiTv
Use this endpoint to pay for your dstv, gotv and startimes and earn commission on each single transaction.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
card_no
required
number
This is your smart card number from your service provider's decoder.
network
required
string
Networks are gotv, dstv and startimes.
biller_name
required
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
required
number
The amount returned by fetch cable/tv bills endpoint.
email
required
string
The email account attributed to your secret key.
Response
200: OK
{ "status": "1", "message": "Cable subscription was successful"}
302: Found
{ "status": "0", "message": "Could not make transaction"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiTv' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'amount="200"' \
--form 'card_no="12345*****"' \
--form 'network="dstv"' \
--form 'biller_name=""'
PHP
<?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' => '[email protected]','amount' => '200','card_no' => '12345*****','network' => 'dstv','biller_name' => ''),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiTv',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]',
'amount': '200',
'card_no': '12345*****',
'network': 'dstv',
'biller_name': ''
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiTv")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.field("amount", "200")
.field("card_no", "12345*****")
.field("network", "dstv")
.field("biller_name", "")
.asString();

Funds API

post
Funds Transfer API

https://app.cashbuddy.ng/apis/apiTransfer
This endpoint will enable you to transfer money to any bank in Nigeria.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
message
optional
string
Transfer description.
amount
required
integer
The amount to be transfered.
bank_code
required
number
the bank code of the bank gotten from Fetch all banks api.
account_number
required
number
The account number to send the money to.
email
required
string
The email account attributed to your secret key.
Response
200: OK
{ "status": "1", "message": "Your transfer was successful"}
302: Found
{ "status": "0", "message": "Could not make transaction"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiTransfer' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'amount="200"' \
--form 'account_number="12345*****"' \
--form 'bank_code="046"' \
--form 'message="Funds Description"'
PHP
<?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' => '[email protected]','amount' => '200','account_number' => '12345*****','bank_code' => '046','message' => 'Funds Description'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiTransfer',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]',
'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);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiTransfer")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.field("amount", "200")
.field("account_number", "12345*****")
.field("bank_code", "046")
.field("message", "Funds Description")
.asString();

Cash Pin Generation

post
Generate Pin

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.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
amount
required
integer
Amount value to pin printed on cash card.
count
required
number
The number of times to generate that value.
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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"
}
]
}
302: Found
{
"status": "0",
"message": " - Cannot perform transaction, Insufficient Balance."
}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiGeneratePins' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"' \
--form 'amount="200"' \
--form 'count="5"'
PHP
<?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' => '[email protected]','amount' => '200','count' => '5'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiGeneratePins',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]',
'amount': '200',
'count': '5'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiGeneratePins")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.field("amount", "200")
.field("count", "5")
.asString();

Fetch bills payment item

post
Fetch all banks with bank codes API

https://app.cashbuddy.ng/apis/apiFetchBanks
Fetch all banks in nigeria with this endpoint.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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"
}
]
}
302: Found
{ "status": "0", "message": "Could not make transaction"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBanks' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"'
PHP
<?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' => '[email protected]'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBanks',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBanks")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.asString();

post
Fetch all bills items API

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.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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"
}
]
}
302: Found
{ "status": "0", "message": "Could not make transaction"}
304: Not Modified
{ "status": "0", "message": "Invalid access key"}
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=all' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"'
PHP
<?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' => '[email protected]'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=all',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=all")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.asString();

post
Fetch electricity bills plans {eko-electric, ibadan-electric, ikeja-electric, portharcourt-electric and enugu-electric}

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
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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%"
}
}
}
302: Found
CURL
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"'
PHP
<?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' => '[email protected]'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric',
'headers': {
'Secret-Key': 'YOUR_SECRET_KEY'
},
formData: {
'email': '[email protected]'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://app.cashbuddy.ng/apis/apiFetchBills?network=eko-electric")
.header("Secret-Key", "YOUR_SECRET_KEY")
.multiPartContent()
.field("email", "[email protected]")
.asString();

post
Fetch data plans{mtn, glo, 9mobile, airtel}

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
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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
PHP
NODE
JAVA
CURL
curl --location --request POST 'https://app.cashbuddy.ng/apis/apiFetchBills?network=mtn' \
--header 'Secret-Key: YOUR_SECRET_KEY' \
--form 'email="[email protected]"'
PHP
<?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' => '[email protected]'),
CURLOPT_HTTPHEADER => array(
'Secret-Key: YOUR_SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
NODE
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': '[email protected]'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JAVA
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", "[email protected]")
.asString();

post
Fetch cable/tv subscription plans{dstv, gotv, startimes}

https://app.cashbuddy.ng/apis/apiFetchBills?network=dstv
Pay for your cable subscription with this endpoint.
Request
Response
Request
Headers
Secret-Key
required
string
Secret Authentication Key to access your product, found in your cashbuddy settings.
Body Parameters
email
required
string
The email account attributed to your secret key.
Response
200: OK
{
"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%",