All requests need to pass Authentication token in the headers like this.
\nMake sure you pass Content-Type : application/json , Accept : application/json , and Authorization: Bearer headers
\nIf you want to create object use POST method with JSON body.
\nIf you want to retrieve object - use GET request.
\nPlatform responds with very useful response headers, that you as a developer might wish to log
\nNote: you can get your token via Account Settings -> API Settings [available to agent user only, for now.].
\nRemember access tokens are long-lived, that expire after 15 year.
\nAPI EndPoint: https://aidapay.ng/api/v1/
\nThe Aidapay REST APIs use webhooks for transactions notification. Webhooks are HTTP callbacks that contains notification messages for transactions. When you generate an access token, you can create add a webhook url on which you will receive the transactions update notifications.
\nif (!function_exists('getallheaders')) {\nfunction getallheaders() {\n$headers = [];\nforeach ($_SERVER as $name => $value) {\nif (substr($name, 0, 5) == 'HTTP_') {\n$headers[str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($name, 5)))))] = $value;\n}\n}\nreturn $headers;\n}\n}\n$acess_token = \"your aidapay access token\";\n$payload = file_get_contents(\"php://input\");\n$local_signature = hash_hmac('sha256', $payload, $acess_token);\n//\n$headers = getallheaders();\n$remote_signature = isset($headers['Signature']) ? $headers['Signature']:$headers['signature'];\n//\nif ($local_signature === $remote_signature) {\n//verified , continue your code logic\n//\n$data = json_decode($payload, true);\n//\n$type = $data['type'];\n//\nif($type == \"transaction\") {\n//for transaction\n$transaction_hash = $data['transaction_hash'];\n$status = $data['status'];\n$ref = $data['ref'];\n$amount = $data['amount'];\n$amount_paid = $data['amount_paid'];\n$recipient = $data['recipient'];\n$package = $data['package'];\n$provider = $data['provider'];\n//meter_token and meter_unit key are null if provider IS NOT meter token\n}\nif($type == 'swap') {\n//for swapping\n$swap_hash = $data['swap_hash'];\n$network = $data['network'];\n$amount = $data['amount'];\n$amount_to_get = $data['amount_to_get'];\n$status = $data['status'];\n$phone = $data['phone'];\n}\n//continue with your code\n}\nelse {\n//invalid signature , might be an attacker\nexit(\"0\");\n}\n?>\n\nSample Webhook JSON Response
\n{\"type\":\"transaction\",\"transaction_hash\":\"xxxxxx\", \"ref\":\"xxxxxxxx\", \"status\":\"Completed\",\"amount\":1000,\"amount_paid\":1000,\"commission\":20,\"recipient\":\"081xxxxxx\",\"package\":null,\"provider\":\"MTN\",\"meter_token\":null,\"meter_unit\":null,\"serial_no\":null,\"pin\":null,\"expires\":null}
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11120811","collectionId":"06c2d0da-d6b2-4da4-9538-95bf1c310be9","publishedId":"UV5WDJEj","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2021-10-16T17:01:38.000Z"},"item":[{"name":"Airtime TopUp","item":[{"name":"Get Airtime Providers","id":"b069e52f-cea8-4fb3-b7e2-c7cd9cdc24f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/service/airtime-topup","description":"This request consist of available airtime providers. Please note the unique provider code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","service","airtime-topup"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"0122d9f7-3108-479f-83c1-a7d21e5fdac9","name":"Get Airtime Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/service/airtime-topup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"192.168.8.107:8000"},{"key":"Date","value":"Fri, 17 Jul 2020 21:15:08 GMT"},{"key":"Date","value":"Fri, 17 Jul 2020 21:15:08 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/7.4.4"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Airtime Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n },\n {\n \"provider_name\": \"Airtime Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n }\n ]\n}"}],"_postman_id":"b069e52f-cea8-4fb3-b7e2-c7cd9cdc24f5"},{"name":"Get Airtime Packages (For Airtime Providers With Packages)","id":"39414501-fff8-4fc3-9271-e49d71250302","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}","description":"This request consist of available packages for Airtime providers that have packages for example GLO AWUF. Please note the unique package code of each package, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","packages","{{provider_code}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"0c2c4d41-3fc3-446d-b41b-3207848890b5","name":"Get Airtime Packages","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}"},"code":200,"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Airtime Package 1\",\n \"package_amount\": 1640,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Airtime Package 2\",\n \"package_amount\": 2460,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]\n}"}],"_postman_id":"39414501-fff8-4fc3-9271-e49d71250302"},{"name":"Buy Airtime","id":"01bc401b-69c5-407b-bbe8-08fdd20929eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token
\n","key":"Authorization","type":"text","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"","type":"text"},{"key":"recipient","value":"","type":"text"},{"key":"amount","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/buy","description":"This request endpoint enables you to buy Airtime. \n
\nBelow are the request body arameters :\n
\nisPorted -- If recipient number is a ported line (yes or no. no is default)
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\namount -- Amount
\naccount_pin -- Your Aidapay account pin
\nref -- Your own reference number (Required)
\nBelow are the responses example :\n
\n{{transaction_hash}} -- transaction_hash
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{commission}} -- Commission value
\n{{beneficiary}} -- The Recipient
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{amount_paid}} - The total amount paid for the transaction
\n{{discount}} - Discount given. (in %)
This folder consist of airtime purchase code
\n","_postman_id":"390dda8f-288e-4e09-8d8b-e31fda397e75"},{"name":"Meter Token","item":[{"name":"Get Meter Token Providers","id":"195d00ec-f7f0-44e4-bc4e-558d888db97b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token
\n","key":"Authorization","type":"text","value":"Bearer {{access_token}}"}],"url":"https://aidapay.ng/api/v1/service/meter-token","description":"This request consist of available Meter Token providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","service","meter-token"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"8e3d3ab2-7ed4-4f7c-b0ed-1f9334507698","name":"Get Meter Token Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token","key":"Authorization","type":"text","value":"Bearer {{access_token}}"}],"url":"https://aidapay.ng/api/v1/service/meter-token"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Meter Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n },\n {\n \"provider_name\": \"Meter Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n }\n ]\n}"}],"_postman_id":"195d00ec-f7f0-44e4-bc4e-558d888db97b"},{"name":"Buy Meter Token","id":"dfe54a3b-7cdf-402c-8d93-f39983c06da5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"","type":"text"},{"key":"recipient","value":"","type":"text"},{"key":"amount","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/buy","description":"This request endpoint enables you to buy Meter Token.
\n
\nBelow are the request body arameters :\n
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\namount -- Amount
\naccount_pin -- Your Aidapay account pin
\nref -- Your own reference number (Required)
\n
\nBelow are the responses example :\n
\n{{transaction_hash}} -- transaction_hash
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{commission}} -- Commission value
\n{{beneficiary}} -- The Recipient
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{amount_paid}} - The total amount paid for the transaction
\n{{discount}} - Discount given. (in %)
This folder consists of Meter Token API endpoint
\n","event":[{"listen":"prerequest","script":{"id":"fbd2164b-1507-4fb5-b81e-f0909c62c483","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"49a5e2c1-0a90-48f2-a4cf-b567bcbaa03b","type":"text/javascript","exec":[""]}}],"_postman_id":"1f147f90-73be-4afe-a1f2-2086903255ef"},{"name":"Cable TV","item":[{"name":"Get Cable TV Providers","id":"15e15c2e-2d6b-4414-9cab-bf088cfb4b31","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/service/cable-tv-subscription","description":"This request consists of Cable TV API endpoint
\n","urlObject":{"protocol":"https","path":["api","v1","service","cable-tv-subscription"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"8444db4e-b3f9-4a15-9709-9775f9d0df69","name":"Get Cable TV Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/service/cable-tv-subscription"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Cable Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n },\n {\n \"provider_name\": \"Cable Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n }\n ]\n}"}],"_postman_id":"15e15c2e-2d6b-4414-9cab-bf088cfb4b31"},{"name":"Get Cable TV Packages","id":"f4802f8d-600f-4b56-97f0-f29fbf0dc31f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}","description":"This request consist of available packages for Cable TV. Please note the unique package code of each package, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","packages","{{provider_code}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"45ec23b9-c4e8-407f-afc6-8d396235447d","name":"Get Cable TV Packages","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"192.168.8.107:8000"},{"key":"Date","value":"Fri, 17 Jul 2020 21:31:34 GMT"},{"key":"Date","value":"Fri, 17 Jul 2020 21:31:34 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/7.4.4"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Cable TV Package 1\",\n \"package_amount\": 1640,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Cable TV Package 2\",\n \"package_amount\": 2460,\n \"package_api_code\": \"unique_package_code\",\n \"provider_api_code\": \"provider_code\"\n }\n ]\n}"}],"_postman_id":"f4802f8d-600f-4b56-97f0-f29fbf0dc31f"},{"name":"Buy Cable TV","id":"8409abf1-68d6-4266-b6c6-d0ccaf164f23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"recipient","value":"","type":"text"},{"key":"provider_code","value":"","type":"text"},{"key":"package_code","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/buy","description":"This request endpoint enables you to buy Cable TV.
\n
\nBelow are the request body arameters :\n
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\npackage_code -- Package code
\naccount_pin -- Your Aidapay account pin
\nref -- Your own reference number (Required)
Below are the responses example :\n
{{transaction_hash}} -- transaction_hash
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{beneficiary}} -- The Recipient
\n{{commission}} -- Commission value
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{amount_paid}} - The total amount paid for the transaction
\n{{discount}} - Discount given. (in %)
This folder consists of Cable TV API endpoint
\n","_postman_id":"41c362fc-1c2c-4883-951a-6f28b26f03a6"},{"name":"Data Bundle","item":[{"name":"Get Data Bundle Providers","id":"35230b29-a5bb-49c2-9f49-baaf2afea945","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/service/data-bundle-sme","description":"This request consist of available Data Bundle providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","service","data-bundle-sme"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"dbd7b655-65e2-4caf-a529-dfc65d275529","name":"Get Data Bundle Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/service/data-bundle-sme"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Data Bundle Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n },\n {\n \"provider_name\": \"Data Bundle Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n }\n ]\n}"}],"_postman_id":"35230b29-a5bb-49c2-9f49-baaf2afea945"},{"name":"Get Data Bundle Packages","id":"92f87baa-81db-43f8-985f-09d4d0358873","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}","description":"This request consist of available packages for Data Bundle. Please note the unique package code of each package, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","packages","{{provider_code}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"6c260a44-82f9-4a4a-b2fc-b4ba508421d2","name":"Get Data Bundle Packages","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}"},"code":200,"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Data Bundle TV Package 1\",\n \"package_amount\": 1640,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Data Bundle Package 2\",\n \"package_amount\": 2460,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]\n}"}],"_postman_id":"92f87baa-81db-43f8-985f-09d4d0358873"},{"name":"Buy Data Bundle","id":"09a39f73-e7d0-4938-9214-aafb02df6b5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"recipient","value":"","type":"text"},{"key":"provider_code","value":"","type":"text"},{"key":"package_code","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/buy","description":"This request endpoint enables you to buy Data Bundle. \n
\nBelow are the request body arameters :\n
\nisPorted -- If recipient number is a ported line (yes or no. no is default)
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\npackage_code -- Package code
\naccount_pin -- Your Aidapay account pin
\nref -- Your own reference number (Required)
\nBelow are the responses example :\n
{{transaction_hash}} -- transaction_hash
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{beneficiary}} -- The Recipient
\n{{commission}} -- Commission value
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{amount_paid}} - The total amount paid for the transaction
\n{{discount}} - Discount given. (in %)
This folder consists of Data Bundle API endpoint
\n","event":[{"listen":"prerequest","script":{"id":"5ad69060-9e33-4965-a5e2-52fead674168","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"95af84ab-7097-4cdf-a83e-00997e7035c5","type":"text/javascript","exec":[""]}}],"_postman_id":"ed7af59e-b407-463d-8bf7-ab555a676ae5"},{"name":"Internet Package","item":[{"name":"Get Internet Package Providers","id":"e4b7b9d7-b859-4d5d-a15c-f98a9979bc0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/service/internet","description":"This request consist of available Internet providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","service","internet"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"9f359d67-f6ba-44ea-a2fa-de3574660cb3","name":"Get Internet Package Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/service/internet"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Internet Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n },\n {\n \"provider_name\": \"Data Internet Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": 100,\n \"max_amount\": 5000,\n \"ref_commission\": 0\n }\n ]\n}"}],"_postman_id":"e4b7b9d7-b859-4d5d-a15c-f98a9979bc0d"},{"name":"Get Internet Packages","id":"304e9d41-8501-422c-a7f1-faa1044d428a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}","description":"This request consist of available packages for Internet. Please note the unique api_code of each package, you will need it to perform subsequent transactions
\n","urlObject":{"protocol":"https","path":["api","v1","packages","{{provider_code}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"838217d6-063d-4f5d-ac1d-ddc0824161af","name":"Get Internet Packages","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/packages/{{provider_code}}"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Internet Package 1\",\n \"package_amount\": 1640,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Internet Package 2\",\n \"package_amount\": 2460,\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]\n}"}],"_postman_id":"304e9d41-8501-422c-a7f1-faa1044d428a"},{"name":"Buy Internet","id":"6d2af9aa-3780-4c4f-acf9-729562146d56","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token
\n","key":"Authorization","type":"text","value":"Bearer {{access_token}}"}],"body":{"mode":"formdata","formdata":[{"key":"recipient","value":"","type":"text"},{"key":"provider_code","value":"","type":"text"},{"key":"package_code","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/buy","description":"This request endpoint enables you to buy Internet.
\n
\nBelow are the request body arameters :\n
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\npackage_code -- Package code
\naccount_pin -- Your Aidapay account pin
\nref -- Your own reference number (Required)
\nBelow are the responses example :\n
{{transaction_hash}} -- transaction_hash
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{commission}} -- Commission value
\n{{beneficiary}} -- The Recipient
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{amount_paid}} - The total amount paid for the transaction
\n{{discount}} - Discount given. (in %)
This folder consists of Internet Package API endpoint
\n","event":[{"listen":"prerequest","script":{"id":"59a24680-7f22-4a34-8c89-21496c6a55b0","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"cd77156b-2bc4-40bf-9b54-bb136440012e","type":"text/javascript","exec":[""]}}],"_postman_id":"51ef24c6-5bef-405a-a75e-4638a7d3331d"},{"name":"Validations","item":[{"name":"Provider Recipient Validation","id":"2f8b578c-31f4-48d1-bc03-be0f523d13fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token
\n","key":"Authorization","type":"text","value":"Bearer {{access-token}}"}],"url":"https://aidapay.ng/api/v1/validation/{{provider_code}}/{{recipient}}","description":"This endpoints is for validation of recipients
\n","urlObject":{"protocol":"https","path":["api","v1","validation","{{provider_code}}","{{recipient}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"40804a78-6b18-48fd-9a66-0ea18395ca61","name":"Provider Recipient Validation","originalRequest":{"method":"GET","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token","key":"Authorization","type":"text","value":"Bearer {{access_token}}"}],"url":"https://aidapay.ng/api/v1/validation/{{provider_code}}/{{recipient}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"192.168.8.107:8000"},{"key":"Date","value":"Fri, 17 Jul 2020 22:17:20 GMT"},{"key":"Date","value":"Fri, 17 Jul 2020 22:17:20 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/7.4.4"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": {\n \"success\": true,\n \"verified\": true,\n \"message\": \"Verified {{provider}}\"\n }\n}"}],"_postman_id":"2f8b578c-31f4-48d1-bc03-be0f523d13fd"}],"id":"d1376fc6-7920-4f94-8355-2eb8a2a9138d","description":"This folder consists of endpoints for validation of recipients
\n","event":[{"listen":"prerequest","script":{"id":"a8f128fb-28b7-456e-815a-a4e455a2b8b2","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"e53bf445-72c8-401c-aee7-3cd9b24625dd","type":"text/javascript","exec":[""]}}],"_postman_id":"d1376fc6-7920-4f94-8355-2eb8a2a9138d"},{"name":"Transaction","item":[{"name":"Get Transaction","id":"c5ee8e24-309b-4902-b2df-ba9ffabe9183","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"url":"https://aidapay.ng/api/v1/transaction/{{transaction_hash}}","description":"This endpoint is used to fetch a transaction.
\nBelow are the responses example :
\n{{transaction_hash}} -- transaction hash (this value can also be the ref you provided while initiating the transaction)
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{beneficiary}} -- The Recipient
{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
{{amount_paid}} - The total amount paid for the transaction
\n{{commission}} -- Commission value
\n{{package}} -- Package name
\n","urlObject":{"protocol":"https","path":["api","v1","transaction","{{transaction_hash}}"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"2a8efe70-1754-4c28-a7a4-0a1eb476f558","name":"Get Transaction","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","description":"Your Personal Access Token","type":"text"}],"url":"https://aidapay.ng/api/v1/transaction/{{transaction_hash}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"192.168.8.107:8000"},{"key":"Date","value":"Fri, 17 Jul 2020 22:31:26 GMT"},{"key":"Date","value":"Fri, 17 Jul 2020 22:31:26 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/7.4.4"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": {\n \"transaction_hash\": \"{{transaction_hash}}\",\n \"status\": \"{{status}}\",\n \"amount\": {{amount}},\n \"amount_paid\": \"{{amount_paid}}\",\n \"commission\": {{commission}},\n \"recipient\": \"{{beneficiary}}\",\n \"package\": {{package}},\n \"provider\": \"{{provider}}\",\n \"meter_token\": {{will be null if no meter token}},\n \"meter_unit\": {{will be null if no meter unit}}\n }\n}"}],"_postman_id":"c5ee8e24-309b-4902-b2df-ba9ffabe9183"},{"name":"ReQuery A Transaction","id":"c3e19296-b4e7-4826-9e8e-60e95397a651","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"transaction_hash","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/requery","description":"This endpoint is used to requery a transaction.
\nBelow are the responses example :
\n{{transaction_hash}} -- transaction hash (this value can also be the ref you provided while initiating the transaction)
\n{{amount}} -- Order Amount
\n{{provider}} -- Provider Name
\n{{beneficiary}} -- The Recipient
{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
{{amount_paid}} - The total amount paid for the transaction
\n{{commission}} -- Commission value
\n{{package}} -- Package name
\n","urlObject":{"protocol":"https","path":["api","v1","requery"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"9428e561-9489-4169-9ef3-d68a5753c8f6","name":"ReQuery A Transaction","originalRequest":{"method":"POST","header":[{"key":"Accept","type":"text","value":"application/json"},{"description":"Your Personal Access Token","key":"Authorization","type":"text","value":"Bearer {{access-token}}"}],"body":{"mode":"formdata","formdata":[{"key":"transaction_hash","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/requery"},"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": {\n \"transaction_hash\": \"{{transaction_hash}}\",\n \"status\": \"{{status}}\",\n \"amount\": {{amount}},\n \"amount_paid\": \"{{amount_paid}}\",\n \"commission\": {{commission}},\n \"recipient\": \"{{beneficiary}}\",\n \"package\": {{package}},\n \"provider\": \"{{provider}}\",\n \"meter_token\": {{will be null if no meter token}},\n \"meter_unit\": {{will be null if no meter unit}}\n }\n}"}],"_postman_id":"c3e19296-b4e7-4826-9e8e-60e95397a651"}],"id":"af8f7c5a-fc48-48ea-be95-869ccbb863a6","description":"This folder contain endpoints to requery and fetch a transaction
\n","event":[{"listen":"prerequest","script":{"id":"985e50fd-67e7-4585-b71d-e3c7cb2145b8","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"45bbb2b1-10c0-4a8f-8c53-5e8a63093535","type":"text/javascript","exec":[""]}}],"_postman_id":"af8f7c5a-fc48-48ea-be95-869ccbb863a6"},{"name":"Airtime Swap","item":[{"name":"Get Airtime Swap Providers","id":"faebf707-1eac-4f70-a288-3f8603b9e1f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"url":"https://aidapay.ng/api/v1/airtime_swap/providers","description":"This request consist of available airtime swapping providers. Please note the unique provider slug of each provider, you will need it to perform subsequent swapping request
\n","urlObject":{"protocol":"https","path":["api","v1","airtime_swap","providers"],"host":["aidapay","ng"],"query":[],"variable":[]}},"response":[{"id":"1b25f761-7052-4e71-af5a-32c8dd54de02","name":"Get Airtime Swap Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"url":"https://aidapay.ng/api/v1/airtime_swap/providers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"192.168.8.104:8000"},{"key":"Date","value":"Sun, 09 Aug 2020 00:49:26 GMT"},{"key":"Date","value":"Sun, 09 Aug 2020 00:49:26 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/7.4.8"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"slug\": \"mtn-swap\",\n \"network_name\": \"MTN\",\n \"percent\": 20,\n \"min\": 300,\n \"max\": 5000\n },\n {\n \"slug\": \"glo-swap\",\n \"network_name\": \"GLO\",\n \"percent\": 20,\n \"min\": 500,\n \"max\": 5000\n }\n ]\n}"}],"_postman_id":"faebf707-1eac-4f70-a288-3f8603b9e1f8"},{"name":"Swap Airtime","id":"de3873b4-d613-4022-b6cc-a7216ff4adda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access_token}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"network_slug","value":"","type":"text"},{"key":"sender_phone","value":"","type":"text"},{"key":"amount","value":"","type":"text"},{"key":"account_pin","value":"","type":"text"}]},"url":"https://aidapay.ng/api/v1/airtime_swap","description":"This request endpoint enables you to swap Airtime. \n
\nBelow are the request body arameters :\n
\nnetwork_slug -- Provider SLug Code
\nsender_phone -- The sender phone number
\namount -- Amount
\naccount_pin -- Your Aidapay account pin
\nBelow are the responses example :\n
\n{{swap_hash}} -- swap_hash
\n{{amount}} -- Swap Amount
\n{{amount_to_get}} -- Amount you are getting
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{send_to}} - The phone number the airtime is to be sent to
\n{{phone}} -The number you are transferring the airtime from
This endpoint is used to fetch a swapping request.\n
\nBelow are the responses example :\n
\nBelow are the responses example :\n
\n{{swap_hash}} -- swap_hash
\n{{amount}} -- Swap Amount
\n{{amount_to_get}} -- Amount you are getting
\n{{status}} -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund
\n{{send_to}} - The phone number the airtime is to be sent to
\n{{phone}} -The number you are transferring the airtime from
This folder consist of airtime swapping API requests
\n","event":[{"listen":"prerequest","script":{"id":"78c99009-ce2b-4cdb-8568-5baaeaeae495","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"16d22f40-a797-4f11-b8be-ca498bac6f23","type":"text/javascript","exec":[""]}}],"_postman_id":"40d8f59c-11b7-40f0-9cf0-664694af0c5c"},{"name":"My Account","item":[{"name":"Account Information","id":"45ba9000-9347-40b6-8440-104fec949918","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{access-token}}","description":"Your Personal Access Token
\n","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://aidapay.ng/api/v1/my_account","description":"This folder contains endpoint to get your account information. \n
\nBelow is a sample response :\n
\n{names}} -- Your full name
\n{{email}} -- Account email
\n{{phone}} -- Account Phone
\n{{balance}} -- Account Balance
\n{{commission_balance}} -- Commission Balance
This folder contains endpoint to get your account information
\n","event":[{"listen":"prerequest","script":{"id":"eea7a2b7-b20d-450d-869d-f11ab24bd6a9","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"4dfa2d5a-b646-4002-aa2e-3557f14411ec","type":"text/javascript","exec":[""]}}],"_postman_id":"3d37d360-9562-41e4-8d4c-b3cb06602852"}],"event":[{"listen":"prerequest","script":{"id":"4d1003cb-b7d7-4038-a708-20982fbfac77","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"45b0bdc5-e4bd-4cb6-ad07-ee1c9b1aa8ad","type":"text/javascript","exec":[""]}}]}