Welcome to the Vouchernet API Documentation. Here are the basic requirements to get started:
\nOur API uses header authentication. You need to pass your access token in the header as Bearer {{access_token}}. Please contact support to obtain your access token.
Every transaction request requires a 4-digit transaction pin to process our products. You can change or reset this pin anytime through your portal.
\nEach of our products has a unique product ID, including Airtime, Data, Epin, Internet, Cable, Electricity, and Betting. You can retrieve all available product IDs by passing any product slug to the get products endpoint under the Ping section.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"17069052","collectionId":"12274fda-66a9-47a8-8f87-3cc6698124c5","publishedId":"2sA3Qy5pEc","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-06-04T06:25:00.000Z"},"item":[{"name":"Validation","item":[{"name":"validate cable","id":"68be9f50-1f5b-4431-b5a5-5e1b1ead5044","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"47\", \n \"customer_id\": \"7030871019\"\n}"},"url":"{{url}}validate-cable","urlObject":{"host":["{{url}}validate-cable"],"query":[],"variable":[]}},"response":[{"id":"7fc92350-2b64-4e53-aa41-c019ac0a568d","name":"validate cable","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"47\", \n \"customer_id\": \"7030871019\"\n}"},"url":"{{url}}validate-cable"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"PHP/8.1.21"},{"key":"cache-control","value":"no-cache, private"},{"key":"content-type","value":"application/json"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"59"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-length","value":"76"},{"key":"date","value":"Fri, 11 Aug 2023 22:35:08 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains; preload;"},{"key":"referrer-policy","value":"no-referrer-when-downgrade"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"amountToPay\": \"8300\",\n \"customer_name\": \"PRECIOUS ENUJEKE\"\n}"}],"_postman_id":"68be9f50-1f5b-4431-b5a5-5e1b1ead5044"},{"name":"validate bet","id":"c733dab8-6591-44a7-b220-a8db8f68fbae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456995\", \n \"customer_id\": \"8343339\"\n}"},"url":"{{url}}validate-bet","urlObject":{"host":["{{url}}validate-bet"],"query":[],"variable":[]}},"response":[{"id":"16a71da6-fd2f-49c9-a280-8078c7cec6ea","name":"validate bet","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456995\", \n \"customer_id\": \"8343339\"\n}"},"url":"{{url}}validate-bet"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"PHP/8.1.21"},{"key":"cache-control","value":"no-cache, private"},{"key":"content-type","value":"application/json"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"57"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-length","value":"53"},{"key":"date","value":"Fri, 11 Aug 2023 21:01:59 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains; preload;"},{"key":"referrer-policy","value":"no-referrer-when-downgrade"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"customer_name\": \"-2348133679237\"\n}"}],"_postman_id":"c733dab8-6591-44a7-b220-a8db8f68fbae"},{"name":"validate electricity","id":"16f982b9-8053-4f66-899a-2434d02260b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456813\", \n \"customer_id\": \"27100301723\"\n}"},"url":"{{url}}validate-electricity","urlObject":{"host":["{{url}}validate-electricity"],"query":[],"variable":[]}},"response":[{"id":"a2d62277-a43e-4430-b4ce-68b885748a6a","name":"validate electricity","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456813\", \n \"customer_id\": \"27100301723\"\n}"},"url":"{{url}}validate-electricity"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"PHP/8.1.21"},{"key":"cache-control","value":"no-cache, private"},{"key":"content-type","value":"application/json"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"59"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-length","value":"45"},{"key":"date","value":"Fri, 11 Aug 2023 22:13:06 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains; preload;"},{"key":"referrer-policy","value":"no-referrer-when-downgrade"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"customer_name\": \"ASONYE\"\n}"}],"_postman_id":"16f982b9-8053-4f66-899a-2434d02260b7"},{"name":"validate internet","id":"535ae0a8-0e25-4a43-a04e-cde4801ec195","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"237\",\n \"customer_id\": \"08060426915\"\n}"},"url":"{{url}}validate-internet","urlObject":{"host":["{{url}}validate-internet"],"query":[],"variable":[]}},"response":[],"_postman_id":"535ae0a8-0e25-4a43-a04e-cde4801ec195"}],"id":"0bd8564d-242f-4e80-94c1-39c4ba54fcba","_postman_id":"0bd8564d-242f-4e80-94c1-39c4ba54fcba","description":""},{"name":"Payment","item":[{"name":"buy airtime","id":"2c022398-244d-4a5a-9a57-a128ec3ca9a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"123456\",\n \"product_id\": \"216\", \n \"amount\" : \"100\",\n \"customer_id\": \"08060426915\", \n \"reference\": \"jwefghdfghdfh\",\n \"pin\": \"1234\"\n}"},"url":"{{url}}buy-airtime","urlObject":{"host":["{{url}}buy-airtime"],"query":[],"variable":[]}},"response":[],"_postman_id":"2c022398-244d-4a5a-9a57-a128ec3ca9a4"},{"name":"buy data","id":"16219514-4c9f-4d9d-96dd-a5938fd0167f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"123456\",\n \"product_id\": \"216\", \n \"customer_id\": \"08060426915\", \n \"reference\": \"jwefghdfghdfh\",\n \"pin\": \"1234\"\n}"},"url":"{{url}}buy-data","urlObject":{"host":["{{url}}buy-data"],"query":[],"variable":[]}},"response":[],"_postman_id":"16219514-4c9f-4d9d-96dd-a5938fd0167f"},{"name":"print epin","id":"94a202f3-3abf-4bd6-b777-eaf9fc709bce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"1234678\",\n \"product_id\": \"2\", \n \"quantity\": \"60\",\n \"pin\": \"1234\",\n \"reference\": \"080hf7uur0jrjr\"\n}"},"url":"{{url}}print-epin","urlObject":{"host":["{{url}}print-epin"],"query":[],"variable":[]}},"response":[],"_postman_id":"94a202f3-3abf-4bd6-b777-eaf9fc709bce"},{"name":"pay cable","id":"153ac295-32f9-406d-9bcb-46e8b2f93078","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"55\", \n \"customer_id\": \"7030871019\",\n \"mobile\": \"08060426915\",\n \"customer_name\": \"precious\",\n \"amount_to_pay\": \"5000\",\n \"pin\": \"1234\",\n \"reference\": \"HF84BF848493BFB14w\"\n}"},"url":"{{url}}pay-cable","urlObject":{"host":["{{url}}pay-cable"],"query":[],"variable":[]}},"response":[],"_postman_id":"153ac295-32f9-406d-9bcb-46e8b2f93078"},{"name":"pay bet","id":"b7867d5c-6c49-4eff-bc3a-867c2c509176","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456995\", \n \"customer_id\": \"8343339\",\n \"amount\": \"100\",\n \"customer_name\": \"Balogun\",\n \"mobile\": \"08060426915\",\n \"pin\": \"1234\",\n \"reference\": \"HF84BF848493BFB14w\"\n}"},"url":"{{url}}pay-bet","urlObject":{"host":["{{url}}pay-bet"],"query":[],"variable":[]}},"response":[],"_postman_id":"b7867d5c-6c49-4eff-bc3a-867c2c509176"},{"name":"pay electricity","id":"8f94e9ff-3ea3-4c2b-9374-8abd89a0e2c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123456813\", \n \"customer_id\": \"27100301723\",\n \"mobile\": \"08060426915\",\n \"customer_name\": \"precious\",\n \"amount\": \"500\",\n \"pin\": \"1234\",\n \"reference\": \"HF84BF848493BFB14w\"\n}"},"url":"{{url}}pay-electricity","urlObject":{"host":["{{url}}pay-electricity"],"query":[],"variable":[]}},"response":[],"_postman_id":"8f94e9ff-3ea3-4c2b-9374-8abd89a0e2c3"},{"name":"pay internet","id":"9f0f1798-a763-404d-b69a-4d59184c84f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"8782779\",\n \"product_id\": \"123457122\", \n \"mobile\": \"08060426915\",\n \"customer_id\": \"08060426915\",\n \"customer_name\": \"Enujeke Precious\",\n \"pin\": \"1234\",\n \"reference\": \"HDu65HDBY47483h\"\n}"},"url":"{{url}}pay-internet","urlObject":{"host":["{{url}}pay-internet"],"query":[],"variable":[]}},"response":[],"_postman_id":"9f0f1798-a763-404d-b69a-4d59184c84f9"}],"id":"8f0b22a1-5918-4764-a917-7b20bb9e5d7d","_postman_id":"8f0b22a1-5918-4764-a917-7b20bb9e5d7d","description":""},{"name":"ping","item":[{"name":"query epin","id":"02d8cd3d-a2dd-464c-a8bb-99108648d20b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{\n \"vendor_id\": \"12345678\",\n \"reference\": \"123456_1691197734\"\n}"},"url":"{{url}}query-epin","urlObject":{"host":["{{url}}query-epin"],"query":[],"variable":[]}},"response":[],"_postman_id":"02d8cd3d-a2dd-464c-a8bb-99108648d20b"},{"name":"query transaction","id":"d7591447-18e2-4bfa-b899-3808d6a9ce15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{\n \"vendor_id\": \"12345678\",\n \"reference\": \"876hh6er9734grdh7ul\"\n}"},"url":"{{url}}get-transaction","urlObject":{"host":["{{url}}get-transaction"],"query":[],"variable":[]}},"response":[],"_postman_id":"d7591447-18e2-4bfa-b899-3808d6a9ce15"},{"name":"get products","id":"6dc96571-494d-43ad-9316-9d908d61101e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{\n \"product_slug\": \"epin\"\n}"},"url":"{{url}}get-products","urlObject":{"host":["{{url}}get-products"],"query":[],"variable":[]}},"response":[{"id":"62d702c9-783b-4bfc-ba6f-4bae02c16489","name":"query products","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{\n \"product_slug\": \"epin\"\n}"},"url":"{{url}}get-products"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0 (Ubuntu)"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 04 Jun 2024 06:07:34 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"product_slug\": \"epin\",\n \"products\": [\n {\n \"product\": \"9mobile 100\",\n \"value\": 100,\n \"product_id\": 8,\n \"comm\": 3\n },\n {\n \"product\": \"9mobile 200\",\n \"value\": 200,\n \"product_id\": 9,\n \"comm\": 3\n },\n {\n \"product\": \"9mobile 500\",\n \"value\": 500,\n \"product_id\": 10,\n \"comm\": 3\n },\n {\n \"product\": \"9mobile 1000\",\n \"value\": 1000,\n \"product_id\": 11,\n \"comm\": 3\n },\n {\n \"product\": \"Airtel 100\",\n \"value\": 100,\n \"product_id\": 18,\n \"comm\": 2.5\n },\n {\n \"product\": \"Airtel 200\",\n \"value\": 200,\n \"product_id\": 19,\n \"comm\": 2.5\n },\n {\n \"product\": \"Airtel 500\",\n \"value\": 500,\n \"product_id\": 20,\n \"comm\": 2.5\n },\n {\n \"product\": \"Airtel 1000\",\n \"value\": 1000,\n \"product_id\": 21,\n \"comm\": 2.5\n },\n {\n \"product\": \"GLO 100 (Valid 7days)\",\n \"value\": 100,\n \"product_id\": 172,\n \"comm\": 3\n },\n {\n \"product\": \"GLO 200 (Valid 7days)\",\n \"value\": 200,\n \"product_id\": 173,\n \"comm\": 3\n },\n {\n \"product\": \"GLO 500 (Valid 7days)\",\n \"value\": 500,\n \"product_id\": 175,\n \"comm\": 3\n },\n {\n \"product\": \"MTN100\",\n \"value\": 100,\n \"product_id\": 217,\n \"comm\": 2\n },\n {\n \"product\": \"MTN 200\",\n \"value\": 200,\n \"product_id\": 218,\n \"comm\": 2\n },\n {\n \"product\": \"MTN 500\",\n \"value\": 500,\n \"product_id\": 220,\n \"comm\": 2\n },\n {\n \"product\": \"MTN 1000\",\n \"value\": 1000,\n \"product_id\": 222,\n \"comm\": 2\n }\n ]\n}"}],"_postman_id":"6dc96571-494d-43ad-9316-9d908d61101e"}],"id":"0a9441ab-1ded-47db-a107-6eff22785441","_postman_id":"0a9441ab-1ded-47db-a107-6eff22785441","description":""},{"name":"Card","item":[{"name":"create card","id":"ed8a2605-8761-4d09-8238-632a7a78491f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"56736\", \n \"cardholder_id\" : \"9fb4b7c6fed141f5a2b66b5d08a53f30\",\n \"pin\": \"1234\"\n}"},"url":"{{url}}create-card","urlObject":{"host":["{{url}}create-card"],"query":[],"variable":[]}},"response":[],"_postman_id":"ed8a2605-8761-4d09-8238-632a7a78491f"},{"name":"fund test","id":"48edea4e-51d2-4430-a9a8-8565bf722e32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"56736\", \n \"cardholder_id\" : \"9fb4b7c6fed141f5a2b66b5d08a53f30\",\n \"pin\": \"1234\"\n}"},"url":"{{url}}create-card","urlObject":{"host":["{{url}}create-card"],"query":[],"variable":[]}},"response":[],"_postman_id":"48edea4e-51d2-4430-a9a8-8565bf722e32"},{"name":"create card holder","id":"becfed31-7596-4f9f-b750-981e3e5c9451","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"56736\", \n \"first_name\" : \"Enujeke\",\n \"last_name\": \"Precious\", \n \"city\": \"Asaba\",\n \"state\": \"Delta\",\n \"postal_code\": \"1234\",\n \"address\": \"No 2 Ebunu lane\",\n \"house_no\": \"2\",\n \"country\": \"Nigeria\"\n}"},"url":"{{url}}create-card-holder","urlObject":{"host":["{{url}}create-card-holder"],"query":[],"variable":[]}},"response":[{"id":"52d5392c-dccb-4462-888c-aa78777a66d9","name":"create card holder","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {your_token}"}],"body":{"mode":"raw","raw":"{ \n \"vendor_id\": \"56736\", \n \"first_name\" : \"Enujeke\",\n \"last_name\": \"Precious\", \n \"city\": \"Asaba\",\n \"state\": \"Delta\",\n \"postal_code\": \"1234\",\n \"address\": \"No 2 Ebunu lane\",\n \"house_no\": \"2\",\n \"country\": \"Nigeria\"\n}"},"url":"{{url}}create-card-holder"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0 (Ubuntu)"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 10 Jul 2024 02:42:24 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5998"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"cardholder_id\": \"9fb4b7c6fed141f5a2b66b5d08a53f30\",\n \"response_message\": \"Card holder created successfully!\"\n}"}],"_postman_id":"becfed31-7596-4f9f-b750-981e3e5c9451"}],"id":"9b0f1a86-b6fb-4f01-9210-7f01be761fdb","_postman_id":"9b0f1a86-b6fb-4f01-9210-7f01be761fdb","description":""}]}