{"info":{"_postman_id":"d2eb2436-087d-4e9b-a45c-06ff629360d7","name":"Hnenterprise","description":"

HN Enterprise collection. Vend Airtime, data, Print Recharge card, send Bulk SMS, subscribe cable bills. etc

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 hnenterprise.com.ng to get the token.

If you will be needing technical support to integrate the API or more requests, kindly contact hnenterprise.com.ng

Please take note that for production (live) the BASE_URL is https://www.hnenterprise.com.ng/api/

Be conscious of the Token, replace it with the token you generated on your profile page

Response code and message in response body

\n\n

200 = Success
201 = Transaction Pending
400 = Bad Request, Something missing in your body request
401 = User not authenticated
402 = Insufficient Fund
403 = Forbidden request
404 = Page Not found
405 = Duplicate Transaction
406 = Missing Required Information, Please check that you have provided all mandatory information
407 = Invalid product code/token
408 = MSISDN Invalid
409 = Amount invalid To Process
434 = General Operator Side Error, Transaction Failed
435 = General Database Error, Transaction Failed
5xx = Some server-side error

Please if you have any challenge/suggestion, developers will be glad to hear from you.kindly send us a mail hello@zeronestechnology.com

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21278391","collectionId":"d2eb2436-087d-4e9b-a45c-06ff629360d7","publishedId":"Uz5FLGzK","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-06-02T12:05:24.000Z"},"item":[{"name":"Data Bundle","item":[{"name":"Data Plans","id":"e4161367-cf6f-430d-8fed-ac7bc3da47e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"network\": \"mtn\"\n}"},"url":"BASE_URL/data/fetch","description":"

You can get data plans for each network or pass the network name as network.

network: glo || airtel || 9mobile || mtn

network ( optional )

\n","urlObject":{"path":["data","fetch"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"e4161367-cf6f-430d-8fed-ac7bc3da47e5"},{"name":"Purchase Data","id":"d8c8ea3e-ae91-4673-b2dc-8c9331b39eb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"plan\": \"123\",\n \"recipent\": \"08169254598\",\n \"network\": \"mtn\"\n}\n"},"url":"BASE_URL/data/purchase","description":"

Purchase Data (Glo, Mtn, Airtel, 9mobile)

Please note its advisable that you access the BASE_URL/data/fetch to get the updated plan id and amount before vending for data

Parameters:

phone (required): The phone number you are sending the data to.
\n
network (required): The network you are sending to; mtn || glo || 9mobile || airtel
\n
id (required): the selected plan id as seen from\nBASE_URL/data/fetch
\n

\n","urlObject":{"path":["data","purchase"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"d8c8ea3e-ae91-4673-b2dc-8c9331b39eb7"}],"id":"e656df59-dabc-41b9-a830-d4a331cf2aff","description":"

To vend for data, you need to fetch data plans.

You can fetch data plans for a specific network by adding the network name ( mtn, glo, 9mobile, airtel) or accessing the data lookup endpoint and all the plans will be fetched.

network - mtn, airtel, 9mobile, glo ( optional )

\n","_postman_id":"e656df59-dabc-41b9-a830-d4a331cf2aff"},{"name":"Multichoice - GOTV, DSTV Subscription","item":[{"name":"Fetch Bouquets","id":"e8bc15af-7ef1-4ff5-9065-76ebb065d2d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"service\": \"multichoice\",\n \"type\": \"gotv\"\n}"},"url":"http://localhost/clients/hnent/api/bouquets","description":"

Get bouquets for multichoice and StarTimes.

Parameters:

service(required): multichoice or startimes
type(required): GOTV or DSTV, set as default for startimes.

\n","urlObject":{"protocol":"http","path":["clients","hnent","api","bouquets"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e8bc15af-7ef1-4ff5-9065-76ebb065d2d0"},{"name":"Validate smart card number","id":"2e38ea10-f509-483c-81aa-588537b5c8b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"type\": \"gotv\",\n \"account\": \"7032128090\"\n}"},"url":"BASE_URL/validate_multichoice","description":"

Validate smart card number to get bouquet and customer details before vending.

Parameters
\ntype(required): gotv or dstv\naccount(required): the iuc number you are validating

\n","urlObject":{"path":["validate_multichoice"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"2e38ea10-f509-483c-81aa-588537b5c8b2"},{"name":"Pay GOTV, DSTV","id":"f822499e-e1f6-4256-88c7-2d6cb57df25c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"plan\" : \"Q3Q5MHFWLzZIemxBeHl0ZGdMUDBPN0ljRWd2Z2RFQ2ZSZHdWOFk4RDdjbWo4TWJVS2hCM28vNG1YSmVVbWJENQ==\",\n\t\"productCode\" : \"8F1C45724D6942C5DDC6647AF9A9D1F254AE232B|eyJzZXJ2aWNlIjoibXVsdGljaG9pY2UiLCJjaGFubmVsIjoiV0VCIiwidHlwZSI6IkdPVFYiLCJhY2NvdW50IjoiNzAzMjEyODA5MCIsImF1dGgiOnsiaXNzIjoiaXRleHZhcyIsInN1YiI6IjkxNjE4NjM1Iiwid2FsbGV0IjoiOTE2MTg2MzUiLCJ0ZXJtaW5hbCI6IjkxNjE4NjM1IiwidXNlcm5hbWUiOiJwaGlsbzR1MmNAZ21haWwuY29tIiwiaWRlbnRpZmllciI6Inplcm9uZXMiLCJrZXkiOiJhZTQ3YWI5NGMwZTIwNjUwYjMyODk2YjRhMzcxZDU2NiIsInZlbmRUeXBlIjoiQjJCIiwibW9kZSI6ImxpdmUiLCJlbWFpbCI6InBoaWxvNHUyY0BnbWFpbC5jb20iLCJvcmdhbmlzYXRpb25Db2RlIjoiMDAxMDExNDAiLCJpYXQiOjE2MTM3MjgyMDIsImV4cCI6MTYxMzczNTQwMn0sImVudmlyb25tZW50IjoibGl2ZSIsInN0YXJ0VGltZSI6MTYxMzcyODIwMy4zMjc3NCwiZXJyb3IiOmZhbHNlLCJyZWYiOiI0Mzc4MTAzNjciLCJuYW1lIjoiQUdVTkRVQlVJU0kgSUZFT01BIiwidW5pdCI6IkRTVFYiLCJkYXRlIjoiMjAyMS0wMi0xOSAxMDo1MDoxMCIsImJvdXF1ZXRDb2RlIjoiR09UVk5KMiIsInNlcnZpY2VJZCI6IkFRQyIsImN1c3RvbWVyTnVtYmVyIjoiMTIyOTQ0MTMwIiwicmVzcG9uc2VDb2RlIjoiMDAiLCJtZXNzYWdlIjoiQ3VzdG9tZXIgVmFsaWRhdGlvbiBTdWNjZXNzZnVsIiwiZGVzY3JpcHRpb24iOiJDdXN0b21lciBWYWxpZGF0aW9uIFN1Y2Nlc3NmdWwiLCJiYXNrZXRJZCI6IjEyMjk0NDEzMCIsImJvdXF1ZXRzIjpbeyJuYW1lIjoiR090diBTbWFsbGllIC0gbW9udGhseSIsImFtb3VudCI6IjgwMCIsImNvZGUiOiJEU1RWfEdPSEFOIn0seyJuYW1lIjoiR090diBTbWFsbGllIC0gcXVhcnRlcmx5IiwiYW1vdW50IjoiMjEwMCIsImNvZGUiOiJEU1RWfEdPTElURSJ9LHsibmFtZSI6IkdPdHYgU21hbGxpZSAtIHllYXJseSIsImFtb3VudCI6IjYyMDAiLCJjb2RlIjoiRFNUVnxHT0xUQU5MIn0seyJuYW1lIjoiR090diBNYXgiLCJhbW91bnQiOiIzNjAwIiwiY29kZSI6IkRTVFZ8R09UVk1BWCJ9LHsibmFtZSI6IkdPdHYgSmluamEgQm91cXVldCIsImFtb3VudCI6IjE2NDAiLCJjb2RlIjoiRFNUVnxHT1RWTkoxIn0seyJuYW1lIjoiR090diBKb2xsaSBCb3VxdWV0IiwiYW1vdW50IjoiMjQ2MCIsImNvZGUiOiJEU1RWfEdPVFZOSjIifV19\",\n\t\"phone\" : \"08169254598\",\n\t\"productToken\" : \"Z2NKVGZBQXhQMFJiNmZZUTZLdyt0M3Q4T0lFWW9XQkV0WXA0SnpVTVR1dz0=\",\n\t\"trans_id\" : \"17hs8210\"\n}"},"url":"BASE_URL/multichoice/vend","description":"

Make payment for GOTV - DSTV

Parameters

phone(required): The buyer' phone number
productCode(required): The productCode as returned when validating the iuc number
plan(required): the plan you are buying
productToken(required): The token received when validating the iuc number
trans_id(optional): your transaction id, which you can use as a reference later on

\n","urlObject":{"path":["multichoice","vend"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"f822499e-e1f6-4256-88c7-2d6cb57df25c"}],"id":"143bf752-6e72-4173-acb6-964ac9e7155f","description":"

Multichoice - GOTV & DSTV Subscription

\n","_postman_id":"143bf752-6e72-4173-acb6-964ac9e7155f"},{"name":"Startimes Vending","item":[{"name":"Validate startimes smart card number","id":"7c871373-61b8-4fc1-981d-280aaee9a303","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"account\": \"01467247344\"\n}"},"url":"BASE_URL/validate_startimes","description":"

Validate startimes smart card number to get bouquet and customer details before vending

Parameters

type (required): default as startimes
account(required): The iuc number you are validating
amount(optional): the amount you are paying.

Please note the amount is required if you're doing a topup

\n","urlObject":{"path":["validate_startimes"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"7c871373-61b8-4fc1-981d-280aaee9a303"},{"name":"Vend Startimes","id":"13b5b1aa-3ac3-4cf0-b094-b998a72f3972","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"bouquet\" : \"CLASSIC\",\n \"cycle\" : \"weekly\",\n\t\"productCode\" : \"2413C21F36BB5D1D3074062698617852EE1BA591|eyJzZXJ2aWNlIjoic3RhcnRpbWVzIiwiY2hhbm5lbCI6IldFQiIsInR5cGUiOiJkZWZhdWx0Iiwic21hcnRDYXJkQ29kZSI6IjAxODMxMjE3MTUyIiwiYW1vdW50IjoiMTYwMCIsImF1dGgiOnsiaXNzIjoiaXRleHZhcyIsInN1YiI6IjkxNjE4NjM1Iiwid2FsbGV0IjoiOTE2MTg2MzUiLCJ0ZXJtaW5hbCI6IjkxNjE4NjM1IiwidXNlcm5hbWUiOiJwaGlsbzR1MmNAZ21haWwuY29tIiwiaWRlbnRpZmllciI6Inplcm9uZXMiLCJrZXkiOiJhZTQ3YWI5NGMwZTIwNjUwYjMyODk2YjRhMzcxZDU2NiIsInZlbmRUeXBlIjoiQjJCIiwibW9kZSI6ImxpdmUiLCJlbWFpbCI6InBoaWxvNHUyY0BnbWFpbC5jb20iLCJvcmdhbmlzYXRpb25Db2RlIjoiMDAxMDExNDAiLCJpYXQiOjE2MTM3MzExNjgsImV4cCI6MTYxMzczODM2OH0sImVudmlyb25tZW50IjoibGl2ZSIsInN0YXJ0VGltZSI6MTYxMzczMTE2OC44MzM4MjksInN0YXR1cyI6MSwiZXJyb3IiOmZhbHNlLCJiYWxhbmNlIjoiNjYuOSIsIm5hbWUiOiJQV0FORURPIEVOT0NIIiwiYm91cXVldCI6IkRUVF9CYXNpYyIsIm1lc3NhZ2UiOiJDdXN0b21lciBWYWxpZGF0aW9uIFN1Y2Nlc3NmdWwiLCJkZXNjcmlwdGlvbiI6IlN1Y2Nlc3MiLCJyZXNwb25zZUNvZGUiOiIwMCIsImJvdXF1ZXRzIjpbeyJuYW1lIjoiTk9WQSIsImN5Y2xlcyI6eyJkYWlseSI6OTAsIndlZWtseSI6MzAwLCJtb250aGx5Ijo5MDB9fSx7Im5hbWUiOiJCQVNJQyIsImN5Y2xlcyI6eyJkYWlseSI6MTYwLCJ3ZWVrbHkiOjYwMCwibW9udGhseSI6MTcwMH19LHsibmFtZSI6IlNNQVJUIiwiY3ljbGVzIjp7ImRhaWx5IjoyMDAsIndlZWtseSI6NzAwLCJtb250aGx5IjoyMjAwfX0seyJuYW1lIjoiQ0xBU1NJQyIsImN5Y2xlcyI6eyJkYWlseSI6MzIwLCJ3ZWVrbHkiOjEyMDAsIm1vbnRobHkiOjI1MDB9fSx7Im5hbWUiOiJTVVBFUiIsImN5Y2xlcyI6eyJkYWlseSI6NDAwLCJ3ZWVrbHkiOjE1MDAsIm1vbnRobHkiOjQyMDB9fV19\",\n\t\"phone\" : \"08169254598\",\n\t\"productToken\" : \"MkdGSyt2TEl5eXdnU1doVERlemhnM1VrWlM4dG1rRE96dGdmWE9BWXllMD0=\",\n\t\"trans_id\" : \"17hs8210\"\n}"},"url":"BASE_URL/startimes/vend","description":"

Make payment for startimes

Parameters

plan(required): the plan you're purchasing either NOVA, CLASSIC...
cycle(required): This is the cycle for the plan you selected either daily, weekly, or monthly
productCode(requred): as seen on the validation
phone(required): the user phone number
productToken(required): as seen on the validation endpoint
trans_id(optional): your reference id

\n","urlObject":{"path":["startimes","vend"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"13b5b1aa-3ac3-4cf0-b094-b998a72f3972"}],"id":"d5f16450-c80a-4169-bab7-5e46ab2af741","description":"

Startimes Subscription

\n","_postman_id":"d5f16450-c80a-4169-bab7-5e46ab2af741"},{"name":"Electricity","item":[{"name":"Validate Electricity","id":"a9dd62e0-d575-413b-a63d-5cf976269e07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n\t\"meter_number\": \"43012549473\",\n\t\"meter_type\" : \"prepaid\",\n\t\"amount\" : \"100\",\n\t\"service\" : \"ikedc\"\n}"},"url":"BASE_URL/validate_electricity","description":"

Validate electricity

Parameters

meter_number(required): The meter number you want to validate
meter_type(required): postpaid or prepaid
service(required): This is the available disco : ikedc, ekedc, phedc, aedc, ibedc, kedco
amount(required): The amount you are purchasing, minimum of N100

\n","urlObject":{"path":["validate_electricity"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"a9dd62e0-d575-413b-a63d-5cf976269e07"},{"name":"Pay Electricity","id":"affeb920-5fd6-4000-91a7-46a3a3a7cbc1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"productCode\": \"CE81C5016F7B26C7C43EE50E62FA54076FA5A5DF|eyJtZXRlck5vIjoiNDMwMTI1NDk0NzMiLCJhY2NvdW50VHlwZSI6InByZXBhaWQiLCJzZXJ2aWNlIjoiaWtlZGMiLCJhbW91bnQiOiIxMDAiLCJjaGFubmVsIjoiV0VCIiwiYXV0aCI6eyJpc3MiOiJpdGV4dmFzIiwic3ViIjoiOTE2MTg2MzUiLCJ3YWxsZXQiOiI5MTYxODYzNSIsInRlcm1pbmFsIjoiOTE2MTg2MzUiLCJ1c2VybmFtZSI6InBoaWxvNHUyY0BnbWFpbC5jb20iLCJpZGVudGlmaWVyIjoiemVyb25lcyIsImtleSI6ImFlNDdhYjk0YzBlMjA2NTBiMzI4OTZiNGEzNzFkNTY2IiwidmVuZFR5cGUiOiJCMkIiLCJtb2RlIjoibGl2ZSIsImVtYWlsIjoicGhpbG80dTJjQGdtYWlsLmNvbSIsIm9yZ2FuaXNhdGlvbkNvZGUiOiIwMDEwMTE0MCIsImlhdCI6MTYxMzc0MjQ4MiwiZXhwIjoxNjEzNzQ5NjgyfSwiZW52aXJvbm1lbnQiOiJsaXZlIiwic3RhcnRUaW1lIjoxNjEzNzQyNDgyLjk2MjcwMiwiZXJyb3IiOmZhbHNlLCJtaW5WZW5kRXJyIjpmYWxzZSwibmFtZSI6IldJTExJQU1TIE9NT0xBSkEgQSIsImFkZHJlc3MiOiJQaHlzaWNhbCA2IFRPV09MQVdJIFNUIElLT1JPRFUiLCJjYW5WZW5kIjoidHJ1ZSIsIm1pbmltdW1QYXlhYmxlQW1vdW50IjoiMCIsIk1heERlbWFuZCI6ZmFsc2UsInNlcnZpY2VNZXNzYWdlIjoiQ3VzdG9tZXIgRGV0YWlscyBWYWxpZGF0ZWQgU3VjY2Vzc2Z1bGx5IiwicmVzcG9uc2VDb2RlIjoiMDAifQ%3D%3D\",\n \"productToken\": \"RDBVZUZnUVFSdFJpOElpT2FaUkFUdGloRU8xS2lsdWFMViszc2Vrd0djcWxBMEt6ak5FSTk3OUM2TnRXaVJxZQ==\",\n \"phone\" : \"07038067493\"\n}"},"url":"BASE_URL/electricity/vend","description":"

Pay electricity bill

Parameters

productCode(required): The product code as seen when validating
productToken(required): The productToken as seen when validating.
phone(required): Valid customer phone number. Disco may send a token to the number.
trans_id(optional): Your transaction ID which can be used as a reference later on

\n","urlObject":{"path":["electricity","vend"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"affeb920-5fd6-4000-91a7-46a3a3a7cbc1"}],"id":"1346540e-0b3b-4bfa-a8cc-5256adffb153","description":"

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

When calling the electricity API, kindly make use of the service short name as the endpoint For example to validate for Ikeja electricity, the short name is ikedc.

Ikeja = ikedc;\nAbuja = aedc;\nEko = ekedc;\nEnugu = eedc;\nIbadan = ibedc;\nPorthacourt = phedc;\nKaduna = kedco

\n","_postman_id":"1346540e-0b3b-4bfa-a8cc-5256adffb153"},{"name":"Vend Airtime","id":"a2316313-a0c0-4d4c-ac2f-563f0190abeb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"body":{"mode":"raw","raw":"{\n \"network\": \"mtn\",\n \"amount\": \"100\",\n \"phone\": \"08169254598\",\n \"ported\": false\n}"},"url":"BASE_URL/airtime","description":"

Purchase airtime (Glo, Mtn, Airtel, 9mobile)

Parameters

network(required): The network you are vending; mtn, glo, 9mobile or airtel
amount(required): Minimum of NGN100, maximum of NGN10,000
phone(required): The phone number you are buying to.
ported(optional): set to true if the number is a ported number. Default is false

Please note you may always set the ported option as true if you are sure the phone number is a valid network set and you keep getting invalid phone number.

\n","urlObject":{"path":["airtime"],"host":["BASE_URL"],"query":[],"variable":[]}},"response":[],"_postman_id":"a2316313-a0c0-4d4c-ac2f-563f0190abeb"},{"name":"Get Transaction Report","id":"d582255e-c7c8-41c4-9e6a-f916a6f07839","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer [YOUR_KEY_HERE]"}],"url":"BASE_URL/report?trans_id=81627954","description":"

Transaction Report

Parameter\ntrans_id( required): The transaction ID you are trying to query

\n","urlObject":{"path":["report"],"host":["BASE_URL"],"query":[{"key":"trans_id","value":"81627954"}],"variable":[]}},"response":[],"_postman_id":"d582255e-c7c8-41c4-9e6a-f916a6f07839"}]}