{"info":{"_postman_id":"192f63fd-ccfe-4773-99c9-17c94699e14c","name":"Fcube Digitals API","description":"

Fcube Digital API collection. Vend Airtime, data bundle, subscribe cable bills, electricity, etc

\n

Need to integrate any of the services we provide into your applications? Access the tools and resources you need to offer services similar to our platform.
Kindly access your profile setting page on https://www.fcubedigital.com to get the API Key which is your token.

\n

If you will be needing technical support to integrate the API or more requests, kindly use the Contact form sending us a mail in respect to your request or you can call us or Whatsapp us too.

\n

Please take note that the BASE_URL is https://www.fcubedigital.com/api

\n

Be conscious of the Token(API Key), replace it with the token(API Key) you got from your profile page

\n

Response code and message in response body

\n\n

All errors are self-explanatory

\n

Please if you have any challenge/suggestion with the API kindly send us a mail, call us or Whatsapp us.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"2415928","collectionId":"192f63fd-ccfe-4773-99c9-17c94699e14c","publishedId":"2s8YzMYkd9","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"e5ad06"},"publishDate":"2022-12-05T06:34:20.000Z"},"item":[{"name":"Airtime","item":[{"name":"GET Airtime Networks","id":"ab86f212-5157-4737-9a83-e4e28040bb4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://fcubedigital.com/api/airtime","description":"

To vend for airtime, you need to fetch network_id.

\n","urlObject":{"protocol":"https","path":["api","airtime"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ab86f212-5157-4737-9a83-e4e28040bb4f"},{"name":"Airtime Purchase","id":"2c61c0d9-cfaa-4e44-81c6-b21d766f8679","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"amount","value":"100","type":"text"},{"key":"network","value":"10","type":"text"},{"key":"recipent","value":"070*********","type":"text"},{"key":"ported","value":"false","type":"text"}]},"url":"https://fcubedigital.com/api/airtime","description":"

Use the network_id gotten from above with the amount of airtime you wished to purchase and the phone numbers(Separate the numbers by , if phone number is more than one). Please specify if the number is ported

\n

if number(s) is/are ported use true else use false {boolean}

\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"message\": \"Thanks for using FCUBE DIGITAL. Your order 07033333333 has been processed and should be received in less than a minute.\",
}
\n
","urlObject":{"protocol":"https","path":["api","airtime"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"2c61c0d9-cfaa-4e44-81c6-b21d766f8679"}],"id":"ba2bb4c9-6af0-4e2b-ad3a-d0e337a27621","description":"

To vend for airtime, you need to fetch network_id.

\n

Then you use the network_id with the amount of airtime you wished to purchase and the phone number. Please specify if the number is ported

\n","_postman_id":"ba2bb4c9-6af0-4e2b-ad3a-d0e337a27621"},{"name":"Data Bundle","item":[{"name":"GET Data Network and Plans","id":"5816748d-0412-44d2-a5fa-a073c29ac221","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://fcubedigital.com/api/data","description":"

To vend for data bundle, you need to fetch network_id, plan_name and plan_id.

\n","urlObject":{"protocol":"https","path":["api","data"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5816748d-0412-44d2-a5fa-a073c29ac221"},{"name":"Data Purchase","id":"eb4e1811-0d60-4cfa-996f-0df1e96d0e6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"network","value":"28","type":"text"},{"key":"plan_id","value":"141","type":"text"},{"key":"recipent","value":"080**********","type":"text"},{"key":"ported","value":"false","type":"text"}]},"url":"https://fcubedigital.com/api/data","description":"

Use the network_id, plan_name and plan_id gotten from above and the phone numbers(Separate the numbers by , if phone number is more than one). Please specify if the number is ported

\n

if number(s) is/are ported use true else use false {boolean}

\n

Phone number = recipent

\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"message\": \"Thanks for using FCUBE DIGITAL. Your 1GB data plan order for 07033333333 has been processed and should be received in less than a minutes.\",
}
\n
","urlObject":{"protocol":"https","path":["api","data"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb4e1811-0d60-4cfa-996f-0df1e96d0e6d"}],"id":"f918277f-ade9-4a66-ae08-ec5b1e6c9795","description":"

To vend for data bundle, you need to fetch network_id, plan_name, plan_id, phone number, ported(if any).

\n

Phone number = recipent

\n","_postman_id":"f918277f-ade9-4a66-ae08-ec5b1e6c9795"},{"name":"Cable Bill","item":[{"name":"GET Cable List","id":"fa60bddd-d62d-4bb0-bdb0-3b0f53d52a8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://fcubedigital.com/api/cable","description":"

Fetch the cable providers names, id and network_name

\n","urlObject":{"protocol":"https","path":["api","cable"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa60bddd-d62d-4bb0-bdb0-3b0f53d52a8f"},{"name":"Verify Cable Details","id":"62545830-fc60-4441-977b-d575a57509b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"network_id","value":"15","type":"text"},{"key":"network_name","value":"dstv","type":"text"},{"key":"smart_card_number","value":"**********","type":"text"}]},"url":"https://fcubedigital.com/api/cable","description":"

Get bouquets for multichoice (DSTV and GoTV) and Packages for Startimes.

\n

Parameters:

\n
    \n
  • network_name(required): dstv
    • \n
  • smart_card_number(required): your IUC number or smart card number.
    • \n
  • network_id: 15
    • \n
\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"message\": \"Verification success...\",
\"result\": {
\"network_name\": \"gotv\",
\"smart_card_number\": \"3333333333\",
\"customer_name\": \"FCUBE DIGITAL\",
\"current_bouquet\": {
\"dueDate\": \"January 3rd, 2023\",
\"outstandingAmount\": 1900,
\"currentBouquet\": \"GOtv Jinja N1,900\",
\"currentPlan\": {
\"items\": {
\"plan\": \"gotv-jinja\",
\"amount\": 1900,
\"name\": \"GOtv Jinja N1,900\",
\"description\": \"GOtv Jinja N1,900\"
}
},
\"bouquets\": [
{
\"plan\": \"gotv-max\",
\"amount\": \"4150.00\",
\"name\": \"GOtv Max N4,150\",
\"description\": \"GOtv Max N4,150\"
},
{
\"plan\": \"gotv-jolli\",
\"amount\": \"2800.00\",
\"name\": \"GOtv Jolli N2,800\",
\"description\": \"GOtv Jolli N2,800\"
},
{
\"plan\": \"gotv-jinja\",
\"amount\": \"1900.00\",
\"name\": \"GOtv Jinja N1,900\",
\"description\": \"GOtv Jinja N1,900\"
},
{
\"plan\": \"gotv-smallie\",
\"amount\": \"900.00\",
\"name\": \"GOtv Smallie - monthly N900\",
\"description\": \"GOtv Smallie - monthly N900\"
},
{
\"plan\": \"gotv-smallie-3months\",
\"amount\": \"2400.00\",
\"name\": \"GOtv Smallie - quarterly N2,400\",
\"description\": \"GOtv Smallie - quarterly N2,400\"
},
{
\"plan\": \"gotv-smallie-1year\",
\"amount\": \"7000.00\",
\"name\": \"GOtv Smallie - yearly N7,000\",
\"description\": \"GOtv Smallie - yearly N7,000\"
},
{
\"plan\": \"gotv-supa\",
\"amount\": \"5500.00\",
\"name\": \"GOtv Supa - monthly N5,500\",
\"description\": \"GOtv Supa - monthly N5,500\"
}
]
}
}
}
\n
","urlObject":{"protocol":"https","path":["api","cable"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"62545830-fc60-4441-977b-d575a57509b0"},{"name":"Subscribe For Cable Services","id":"3d429d71-1a20-4837-822e-87ebb464f2ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"smart_card_number","value":"**********","type":"text"},{"key":"network_name","value":"dstv","type":"text"},{"key":"plan","value":"dstv-padi","type":"text"},{"key":"registered_number","value":"070**********","type":"text"},{"key":"network_id","value":"15","type":"text"},{"key":"amount","value":"2150","type":"text"}]},"url":"https://fcubedigital.com/api/cable/pay","description":"

Get bouquets for multichoice.

\n

Parameters:

\n
    \n
  • network_name(required): dstv
    • \n
  • network_id: 15
    • \n
  • smart_card_number(required): your IUC number or smart card number.
    • \n
  • plan(required): dstv_padi
    • \n
  • registered_number(required): The number used to buy the decoder.
    • \n
  • amount(required): 2150
    • \n
\n

These will be gotten from consuming Verify Cable Details API

\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"message\": \"Payment successful...\",
\"content\": {
\"network_name\": \"gotv\",
\"smart_or_iuc_number\": \"3333333333\",
\"package\": \"gotv-jinja\",
\"amount\": \"2150\",
\"phone\": \"07061309922\",
\"subscription_type\": \"renew\",
\"qty\": 1,
\"description\": \"TV Subscription Bill: gotv subscription at N2150 - gotv-jinja, processed successfully for smart card number: 3333333333 N10.75 commission given.\",
\"reference\": \"20221215150228_3\",
\"date_initiated\": \"2022-12-15 14:02:33\"
}
}
\n
","urlObject":{"protocol":"https","path":["api","cable","pay"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d429d71-1a20-4837-822e-87ebb464f2ad"}],"id":"87432a78-d9b6-45fc-ad7b-b1c15493e33d","description":"

Multichoice - GOTV & DSTV Subscription

\n

Startimes

\n","_postman_id":"87432a78-d9b6-45fc-ad7b-b1c15493e33d"},{"name":"Electricity Bill","item":[{"name":"GET Electricity Distributors","id":"a120d147-f1e3-4693-aa68-2792a350aa90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://fcubedigital.com/api/electricity","description":"

Here you get the appropriate distributor_id which you will use when validating your meter number against the distributor.

\n","urlObject":{"protocol":"https","path":["api","electricity"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a120d147-f1e3-4693-aa68-2792a350aa90"},{"name":"Verify Meter Number","id":"b3417fb8-c351-4e21-823f-b4ab5dd98b05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"distributor_id","value":"21","type":"text"},{"key":"meter_number","value":"**********","type":"text"},{"key":"meter_type","value":"prepaid","type":"text"},{"key":"amount","value":"500","type":"text"},{"key":"meter_number","value":"1111111111111","type":"text","disabled":true}]},"url":"https://fcubedigital.com/api/electricity","description":"

Verifying meter number

\n

Parameters

\n
    \n
  • distributor_id(required): You will get this when you consume GET Electricity Distributor API
    • \n
  • meter_number(required): The meter number you want to validate
    • \n
  • meter_type(required): postpaid or prepaid
    • \n
  • amount(required): The amount you are purchasing minimum of N500
    • \n
\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"message\": \"Meter number validation successful.\",
\"customer_name\": \"FCUBE DIGITAL\",
\"validation_result\": true,
\"meter_number\": \"33333333333\",
\"amount\": \"500\",
\"meter_type\": \"prepaid\",
\"address\": \"Lagos State \",
\"channel\": \"EEDC\"
}
\n
","urlObject":{"protocol":"https","path":["api","electricity"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b3417fb8-c351-4e21-823f-b4ab5dd98b05"},{"name":"Generate Electricity Token","id":"5b8140f1-24da-4f3a-a167-dfae8169d493","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"distributor_id","value":"21","type":"text"},{"key":"meter_number","value":"************","type":"text"},{"key":"meter_type","value":"prepaid","type":"text"},{"key":"amount","value":"500","type":"text"},{"key":"phone_number","value":"070*********","type":"text"},{"key":"meter_number","value":"1111111111111","type":"text","disabled":true}]},"url":"https://fcubedigital.com/api/electricity/pay","description":"

To pay for electricity bill and generate token

\n

Parameters

\n
    \n
  • distributor_id(required): You will get this when you consume GET Electricity Distributor API
    • \n
  • meter_number(required): The meter number you want to validate
    • \n
  • meter_type(required): postpaid or prepaid
    • \n
  • amount(required): The amount you are purchasing minimum of N500
    • \n
  • phone_number(required): This is where your generated token will be sent to.
    • \n
\n
\n\n\n\n\n\n\n\n\n\n\n
SAMPLE RESPONSE
{
\"status\": \"success\",
\"body\": {
\"name\": \"T & L DANKU LTD\",
\"amount\": \"500\",
\"meter_number\": \"1111111111111\",
\"meter_type\": \"prepaid\",
\"unit\": \"15.8\",
\"token\": \"57880316552890870667\",
\"vat\": \"23.81\",
\"address\": \"25 RAKABU STREET DIOBU \",
\"reference\": \"20221215150720_\"
}
}
\n
","urlObject":{"protocol":"https","path":["api","electricity","pay"],"host":["fcubedigital","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b8140f1-24da-4f3a-a167-dfae8169d493"}],"id":"8c438bdb-4df3-4660-9a9a-c96158e7ce09","description":"

Our API covers the following electricity distribution in Nigeria.
Ikeja, Eko, Ibadan, Abuja, Porthacourt, Kaduna, Enugu, etc.

\n

These you can get by consuming the GET Electricity Distributor API

\n","_postman_id":"8c438bdb-4df3-4660-9a9a-c96158e7ce09"}]}