To integrate with Retailcode’s APIs, you must be a registered user.
\nSign Up: Register here if you are not yet a user.
\nObtain API Keys (if required by the service):
\nLog in to your Retailcode account.
\nNavigate to the Verification menu.
\nSelect API Keys and Webhooks.
\nClick Request to Go-Live and follow the verification steps.
\nBefore going live, you must complete User Acceptance Testing (UAT).
\nContact products@retailcode.africa for assistance.
\nUse the test numbers below to simulate API responses:
\nIn the event of a PENDING transaction status, Retailcode supports two mechanisms to communicate the final status to the Client:
\nRetailcode can automatically send the final transaction status to a webhook URL configured by the Client on the Retailcode Dashboard.
\nAlternatively, the client can manually invoke Retailcode’s Requery API to retrieve the final status of a pending transaction.
\nMTN, Airtel, 9mobile and Glo
\nUSSD, WEB, MOBILE
\n","urlObject":{"path":["api","v1","vend-airtime"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"9d9c08f8-8bb2-4796-bcf5-85ba107c587b","name":"Validation Failed","originalRequest":{"method":"POST","header":[{"key":"Corporate-Client-Key","value":"a54d13552528b165dc898a9f2187c605c18de28a","type":"text","disabled":true},{"key":"Authorization","value":"Bearer 9490df1538541e1e93bbcbb0c80f27377521665b","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customerMSISDN\": \"09221585450\",\r\n \"amount\":50,\r\n \"network\": \"MTN\",\r\n \"request_id\": \"90009IP54229L003L096L382U21NPP9MJNLN9\",\r\n \"channel\" : \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/vend-airtime"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Fri, 04 Apr 2025 20:57:38 GMT"},{"key":"Date","value":"Fri, 04 Apr 2025 20:57:38 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"},{"key":"Set-Cookie","value":"XSRF-TOKEN=eyJpdiI6IjVkUktwaXRGdDVNTVJQT2dYQzFmM1E9PSIsInZhbHVlIjoic3JLaGhrNlE0TXZCY0V3ajZGVG53cWhTUTQyUVNvS1NGVXlRSjJhbUhCZVl6bEpzWlhBcU1BSkJ3THduMStHRTI2QW5GYzBkNGRTTUlOWk1ub0JZM1dhanl3MHVYUFl0VXpwT1MrRjNyV0xFeGR1cWtpeUhyUnQvelZBU25pdVEiLCJtYWMiOiI2OTA5MzgwODE4MGUwYzIyODUxZmFmODAyOWQ4ODM4ZTlmMzZkZDVhNDkzODVkOThlZmNhZWZiOTViMDY3YTdjIiwidGFnIjoiIn0%3D; expires=Fri, 04 Apr 2025 22:57:38 GMT; Max-Age=7200; path=/; samesite=lax"},{"key":"Set-Cookie","value":"retailcode_corporate_session=eyJpdiI6InAyOStUUy9lSXZhZzVzdGs4aU51cmc9PSIsInZhbHVlIjoib214Sm5seHpjYXhwYUhPQi9FeG9DMGZEZTU4VTkxelVOcEFZUjl5MDhDU0huYW8zUWFvVTRsTUNuVlo1SHkxL1hUOHBxQmlNT1pPQzQzb1QycUIrU1RpbFpxbHE5WXpCYnhIT2M0Z3RJaVY3cVQ0U2NvZXJPUDJJRUlmMlIrNisiLCJtYWMiOiJmYzU5ZWZiNmZjOTQyZjc3MjJkMGUwYzg2ZjRiMjA4NzI2ZmQwYTM4ZDJjNDQ0ZWYzZTdkZWQ1NTM2ZWZiOWExIiwidGFnIjoiIn0%3D; expires=Fri, 04 Apr 2025 22:57:38 GMT; Max-Age=7200; path=/; httponly; samesite=lax"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"The customer msisdn is not valid\",\n \"data\": {\n \"message\": \"FAILED\",\n \"status\": \"300\",\n \"trans_ref\": \"90009IP54229L003L096L382U21NPP9MJNLN9\",\n \"retailcode_trans_id\": \"512901743800258\",\n \"amount\": 50,\n \"network\": \"MTN\",\n \"product_code\": \"AIRTIME\",\n \"error_code\": 305,\n \"error_message\": \"The customer msisdn is not valid\",\n \"failure_message\": \"The customer msisdn is not valid\"\n }\n}"},{"id":"06d7592b-6d8a-4f41-8e82-07b4c5b8b9c2","name":"Airtime Purchase","originalRequest":{"method":"POST","header":[{"key":"Corporate-Client-Key","value":"a54d13552528b165dc898a9f2187c605c18de28a","type":"text","disabled":true},{"key":"Authorization","value":"Bearer 9490df1538541e1e93bbcbb0c80f27377521665b","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customerMSISDN\": \"08165940838\",\r\n \"recipientMSISDN\": \"08062692356\",\r\n \"amount\":100,\r\n \"network\": \"MTN\",\r\n \"request_id\": \"907ui009IP5fjgfhhjg429L00ghjhj3L096L382U21hhkNPP9kMJNL7fjN\",\r\n \"channel\" : \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/vend-airtime"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Mon, 30 Mar 2026 13:49:52 GMT"},{"key":"Date","value":"Mon, 30 Mar 2026 13:49:52 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"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, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your vend request is successful\",\n \"data\": {\n \"message\": \"SUCCESSFUL\",\n \"status\": \"200\",\n \"trans_ref\": \"907ui009IP5fjgfhhjg429L00ghjhj3L096L382U21hhkNPP9kMJNL7fjN\",\n \"retailcode_trans_id\": \"9778417748785916364\",\n \"amount\": 100,\n \"commission\": 0,\n \"available_balance\": 124430.95,\n \"client_type\": \"PREPAIDPLUS\",\n \"product_code\": \"AIRTIME\",\n \"network\": \"MTN\",\n \"error_code\": 200,\n \"error_message\": \"Your vend request is successful\",\n \"request_type\": \"DIRECT\"\n }\n}"}],"_postman_id":"5dd291b9-f5fb-4d88-8665-0970ea302603"},{"name":"Query Transaction","id":"3f8ec04d-49af-4f8a-b021-5eb5b5e22620","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{apiKey}}"},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"transactionRef\":\"3685561725904452\" \n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/transactions/query","urlObject":{"path":["api","v1","transactions","query"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"f92050ed-1f86-4bf5-9787-b97143be714c","name":"Successful","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"transactionRef\":\"90009IP54229L003L096L382U21NPP9MJNLN9\" \n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/transactions/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 19 Jul 2024 09:24:32 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": null,\n \"data\": {\n \"recipientMsisdn\": \"09021585450\",\n \"amount\": \"50.00\",\n \"ProductCode\": \"AIRTIME\",\n \"status\": \"SUCCESSFUL\",\n \"transactionRef\": \"3399951721380885\",\n \"createdAt\": \"2024-07-19 10:21:29\",\n \"message\": \"SUCCESSFUL\",\n \"statusId\": \"200\"\n }\n}"},{"id":"53da9bb6-d254-47e4-a753-0796d7b75b29","name":"Not Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"transactionRef\":\"90009IP54229L003L096L382U21NPP9MJNLN9\" \n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{BASE_URL}}/api/v1/transactions/query","host":["{{BASE_URL}}"],"path":["api","v1","transactions","query"],"query":[{"key":"query","value":"SALES","description":"Optional | Filter String","disabled":true},{"key":"startDate","value":"2023-02-18","description":"Optional | Date to start from","disabled":true},{"key":"endDate","value":"2023-02-23","description":"Optional | Date to end at","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Thu, 13 Feb 2025 16:13:00 GMT"},{"key":"Date","value":"Thu, 13 Feb 2025 16:13:00 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successful Query\",\n \"data\": {\n \"recipientMsisdn\": \"2348165940838\",\n \"amount\": 100,\n \"ProductCode\": \"AIRTIME\",\n \"status\": \"NOT FOUND\",\n \"transactionRef\": \"90009IP54229L003L096L382U21NPP9MJNLN9\",\n \"createdAt\": \"2025-02-13 17:13:00\",\n \"message\": \"NOT FOUND\",\n \"statusId\": \"300\"\n }\n}"},{"id":"2b6bd770-ad08-4b6c-a14a-7a06bfb970b0","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"transactionRef\":\"3685561725904453\" \n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/transactions/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Thu, 13 Feb 2025 16:18:00 GMT"},{"key":"Date","value":"Thu, 13 Feb 2025 16:18:00 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5998"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Successful Query\",\n \"data\": {\n \"recipientMsisdn\": \"08165940838\",\n \"amount\": \"10.00\",\n \"ProductCode\": \"AIRTIME\",\n \"status\": \"FAILED\",\n \"transactionRef\": \"3685561725904453\",\n \"createdAt\": \"2025-01-21 21:49:40\",\n \"message\": \"FAILED\",\n \"statusId\": \"300\"\n }\n}"}],"_postman_id":"3f8ec04d-49af-4f8a-b021-5eb5b5e22620"},{"name":"Get Airtime Purchases","id":"cec3b4ac-56a5-4f8e-a76a-3da923e8d6d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{apiKey}}"},"isInherited":false},"method":"GET","header":[],"url":"{{BASE_URL}}/api/v1/vend-transactions?vendType=VTU","urlObject":{"path":["api","v1","vend-transactions"],"host":["{{BASE_URL}}"],"query":[{"key":"vendType","value":"VTU"},{"disabled":true,"key":"startDate","value":"2023-02-23"},{"disabled":true,"key":"endDate","value":"2023-02-29"},{"disabled":true,"key":"query","value":""}],"variable":[]}},"response":[{"id":"8ae01e38-b654-479a-9726-b93100d692db","name":"Get Airtime Purchases","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{BASE_URL}}/api/v1/vend-transactions?vendType=VTU&startDate=2023-02-23&endDate=2023-02-29&query=1721283239356","host":["{{BASE_URL}}"],"path":["api","v1","vend-transactions"],"query":[{"key":"vendType","value":"VTU"},{"key":"startDate","value":"2023-02-23"},{"key":"endDate","value":"2023-02-29"},{"key":"query","value":"1721283239356"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 19 Jul 2024 09:25:33 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"\",\n \"currentPage\": 1,\n \"hasMorePages\": true,\n \"lastPage\": 101,\n \"nextPageUrl\": \"http://corporateprodapi.retailcode.com.ng/api/v1/vend-transactions?page=2\",\n \"perPage\": 40,\n \"previousPageUrl\": null,\n \"total\": 4004,\n \"url\": \"http://corporateprodapi.retailcode.com.ng/api/v1/vend-transactions\",\n \"data\": [\n {\n \"id\": 11607068,\n \"requestId\": \"90009IP54229L003L096L382U21NPP9MJNLN9\",\n \"transactionReference\": \"1721380889258\",\n \"sequence\": \"3399951721380885\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09021585450\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-07-19T09:21:29.000000Z\"\n },\n {\n \"id\": 9839248,\n \"requestId\": \"IP02OPMMMMKLPHHBPPOU0KL2N0MK\",\n \"transactionReference\": \"2024060509141400505027422\",\n \"sequence\": \"2130491717575250\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-06-05T08:14:12.000000Z\"\n },\n {\n \"id\": 6892535,\n \"requestId\": \"IP02OPMMMMKLPHHBPPU0KL2N0MKN\",\n \"transactionReference\": \"2024031813591736703282705\",\n \"sequence\": \"3701531710766754\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-18T12:59:16.000000Z\"\n },\n {\n \"id\": 6890511,\n \"requestId\": \"IP02OPMMMMKLPHHBPPU0KL2N00MKN\",\n \"transactionReference\": \"2024031812595768802139463\",\n \"sequence\": \"3135831710763194\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-18T11:59:56.000000Z\"\n },\n {\n \"id\": 6826652,\n \"requestId\": \"IP02OPMMMMKLPPKHHBPPU0KL2N00MKK\",\n \"transactionReference\": \"2024031510461406208335087\",\n \"sequence\": \"5346161710495972\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"5.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-15T09:46:12.000000Z\"\n },\n {\n \"id\": 6238374,\n \"requestId\": \"IP02OPMMMMKLPPKHHBPPU0KL2N00M\",\n \"transactionReference\": \"2024030110132824902229027\",\n \"sequence\": \"2103231709284407\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T09:13:27.000000Z\"\n },\n {\n \"id\": 6238267,\n \"requestId\": \"IP02OPMMMMKLPPLKHHBPPU0KL2N00M\",\n \"transactionReference\": \"R240301.1011.22004a\",\n \"sequence\": \"9506471709284264\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T09:11:04.000000Z\"\n },\n {\n \"id\": 6236918,\n \"requestId\": \"IP02OPMMMMKKNNKLLPPLKHHBPPU0KL2NPL0000M\",\n \"transactionReference\": \"2024030109433380008286439\",\n \"sequence\": \"3660521709282613\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:43:33.000000Z\"\n },\n {\n \"id\": 6236178,\n \"requestId\": \"IP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000M\",\n \"transactionReference\": \"\",\n \"sequence\": \"4239571709281712\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:28:32.000000Z\"\n },\n {\n \"id\": 6236069,\n \"requestId\": \"IP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000ML\",\n \"transactionReference\": \"\",\n \"sequence\": \"1012021709281556\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:25:56.000000Z\"\n },\n {\n \"id\": 6235245,\n \"requestId\": \"9NIP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000ML\",\n \"transactionReference\": \"\",\n \"sequence\": \"3024851709280596\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"100.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:09:56.000000Z\"\n },\n {\n \"id\": 6207930,\n \"requestId\": \"547a10b0-fc78-45ee-8913-f0fbe2d6f3c0\",\n \"transactionReference\": \"1709178135506\",\n \"sequence\": \"5183261709178133\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:13.000000Z\"\n },\n {\n \"id\": 6207905,\n \"requestId\": \"4e4dd597-f4f3-4389-8738-b596db755262\",\n \"transactionReference\": \"1709178135946\",\n \"sequence\": \"3855911709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207906,\n \"requestId\": \"e0bc041e-7400-406d-8892-551a7628967a\",\n \"transactionReference\": \"1709178132375\",\n \"sequence\": \"7297471709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207907,\n \"requestId\": \"005ad8b8-af08-446f-9e2c-65ce39f96b74\",\n \"transactionReference\": \"1709178132393\",\n \"sequence\": \"6950981709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207908,\n \"requestId\": \"644f5e41-cbfa-4a8a-b8bd-10efa39eb3f3\",\n \"transactionReference\": \"170917813444\",\n \"sequence\": \"3909541709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207909,\n \"requestId\": \"4255ceab-d04f-48fc-8bb4-4d786556ee31\",\n \"transactionReference\": \"1709178135211\",\n \"sequence\": \"4577421709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207910,\n \"requestId\": \"4c83b13d-74a6-4e5e-bb31-21be8d3e04ea\",\n \"transactionReference\": \"1709178132772\",\n \"sequence\": \"2344071709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207911,\n \"requestId\": \"656782c1-f292-40d2-8b0c-39378d4082fb\",\n \"transactionReference\": \"1709178135341\",\n \"sequence\": \"1150361709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207912,\n \"requestId\": \"fd8a1ab9-ccfd-4796-b063-d0f00dbd0ff2\",\n \"transactionReference\": \"1709178135929\",\n \"sequence\": \"7932481709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207913,\n \"requestId\": \"2bcc971e-23f9-4b9e-a5b2-1b683e9486b2\",\n \"transactionReference\": \"1709178132701\",\n \"sequence\": \"5325021709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207914,\n \"requestId\": \"ce4914ff-a418-465f-ad88-ad2aa4456c56\",\n \"transactionReference\": \"1709178135165\",\n \"sequence\": \"3372831709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207915,\n \"requestId\": \"9d3e15ce-c7a7-41ba-86cc-ab4fae4e1784\",\n \"transactionReference\": \"1709178135757\",\n \"sequence\": \"9884891709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207916,\n \"requestId\": \"d3c3a6b9-c108-410f-8120-867a977ac7c9\",\n \"transactionReference\": \"1709178135319\",\n \"sequence\": \"4144081709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207917,\n \"requestId\": \"9546b798-3a29-484e-b8d0-34f64d486f05\",\n \"transactionReference\": \"1709178135709\",\n \"sequence\": \"6740041709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207918,\n \"requestId\": \"86600e90-0232-4564-952d-245f299769a5\",\n \"transactionReference\": \"1709178134275\",\n \"sequence\": \"9161661709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207919,\n \"requestId\": \"c6529028-a052-4640-9c22-41ad8ec433e6\",\n \"transactionReference\": \"1709178135900\",\n \"sequence\": \"4098101709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207920,\n \"requestId\": \"49ce6a17-4345-4920-9cdc-da3264b62695\",\n \"transactionReference\": \"1709178135803\",\n \"sequence\": \"4412181709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207921,\n \"requestId\": \"2627fdca-5aa7-4e92-b424-4f2756b8a1d3\",\n \"transactionReference\": \"1709178134939\",\n \"sequence\": \"5448481709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207922,\n \"requestId\": \"b5441abc-6eca-489c-8ae3-00706d328479\",\n \"transactionReference\": \"1709178135392\",\n \"sequence\": \"5660511709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207923,\n \"requestId\": \"9113db54-ad5c-4994-b89f-efb72eea7ac5\",\n \"transactionReference\": \"1709178135199\",\n \"sequence\": \"4131491709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207924,\n \"requestId\": \"0f38152a-8095-4fd3-842a-2c9de745e186\",\n \"transactionReference\": \"1709178135319\",\n \"sequence\": \"6486081709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207925,\n \"requestId\": \"967a6d75-49f0-432e-bba9-45517d872b32\",\n \"transactionReference\": \"1709178135691\",\n \"sequence\": \"7616561709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207926,\n \"requestId\": \"6ce2fcc9-623b-4952-b72d-b3649291ab66\",\n \"transactionReference\": \"1709178135705\",\n \"sequence\": \"6380471709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207927,\n \"requestId\": \"caf84f1d-9504-44a0-bb00-747a25cc4b06\",\n \"transactionReference\": \"1709178135990\",\n \"sequence\": \"2001241709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207928,\n \"requestId\": \"c4645e7d-ff2c-466d-b659-b6813af02ef9\",\n \"transactionReference\": \"1709178135159\",\n \"sequence\": \"7996681709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207929,\n \"requestId\": \"3cb8a16a-dbe3-484c-9ad3-70044bb5403d\",\n \"transactionReference\": \"1709178135975\",\n \"sequence\": \"3770021709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207874,\n \"requestId\": \"ada97476-e4e0-4e41-a8d2-22c0b151d88a\",\n \"transactionReference\": \"1709178132330\",\n \"sequence\": \"5597281709178130\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:11.000000Z\"\n },\n {\n \"id\": 6207875,\n \"requestId\": \"963ed3b4-251e-4394-a9c6-d2f2692570c2\",\n \"transactionReference\": \"1709178131639\",\n \"sequence\": \"1311561709178131\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:11.000000Z\"\n },\n {\n \"id\": 6207876,\n \"requestId\": \"6191b059-8183-482e-9174-c917d19b6ffa\",\n \"transactionReference\": \"1709178132757\",\n \"sequence\": \"2384331709178131\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:11.000000Z\"\n }\n ]\n}"}],"_postman_id":"cec3b4ac-56a5-4f8e-a76a-3da923e8d6d2"}],"id":"25ccd4e6-71d9-48bd-a4f1-6b250cb3033f","_postman_id":"25ccd4e6-71d9-48bd-a4f1-6b250cb3033f","description":""},{"name":"Data Purchase","item":[{"name":"Data Purchase","id":"ab2e4112-d502-468d-bcc3-e2ec61846ee7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{apiKey}}"},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer 9490df1538541e1e93bbcbb0c80f27377521665b","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customerMSISDN\": \"08165940838\",\r\n \"recipientMSISDN\": \"08062692356\",\r\n \"productId\": \"MTND4\",\r\n \"network\": \"MTN\",\r\n \"amount\": \"350\",\r\n \"request_id\": \"MTNTEL2111903262820930I22Z1XOZKINO\",\r\n \"channel\" : \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/vend-data","description":"MTN, Airtel, 9mobile and Glo
\nUSSD, WEB, MOBILE
\n","urlObject":{"path":["api","v1","vend-data"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"287b9e5d-52ce-496b-b910-470ce095ff8f","name":"Data Purchase","originalRequest":{"method":"POST","header":[{"key":"Corporate-Client-Key","value":"fb9b05b13b3fcf908c199300d6e2ec9e4d8d10bc","type":"text","disabled":true},{"key":"Authorization","value":"Bearer 9490df1538541e1e93bbcbb0c80f27377521665b","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customerMSISDN\": \"08165940838\",\r\n \"recipientMSISDN\": \"08062692356\",\r\n \"productId\": \"MTND4\",\r\n \"network\": \"MTN\",\r\n \"amount\": \"350\",\r\n \"request_id\": \"MTNTEL2111903262820930I22Z1XOZKINO\",\r\n \"channel\" : \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/vend-data"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Mon, 30 Mar 2026 13:55:20 GMT"},{"key":"Date","value":"Mon, 30 Mar 2026 13:55:20 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"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, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your vend request is successful\",\n \"data\": {\n \"message\": \"SUCCESSFUL\",\n \"status\": \"200\",\n \"trans_ref\": \"MTNTEL2111903262820930I22Z1XOZKINO\",\n \"retailcode_trans_id\": \"7731017748789184805\",\n \"amount\": 350,\n \"commission\": 0,\n \"available_balance\": 124080.95,\n \"client_type\": \"PREPAIDPLUS\",\n \"product_code\": \"DATA\",\n \"network\": \"MTN\",\n \"error_code\": 200,\n \"error_message\": \"Your vend request is successful\",\n \"request_type\": \"DIRECT\"\n }\n}"}],"_postman_id":"ab2e4112-d502-468d-bcc3-e2ec61846ee7"},{"name":"Data Purchase V2","id":"340a123c-202f-46b0-875f-15ea4c70b533","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"MTN, Airtel, 9mobile and Glo
\nUSSD, WEB, MOBILE
\n","urlObject":{"path":["api","v2","vend-data"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"feeb9261-448e-4361-b79b-31aabe1433d7","name":"Data Purchase V2","originalRequest":{"method":"POST","header":[{"key":"Corporate-Client-Key","value":"fb9b05b13b3fcf908c199300d6e2ec9e4d8d10bc","type":"text","disabled":true},{"key":"Authorization","value":"Bearer 9490df1538541e1e93bbcbb0c80f27377521665b","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customerMSISDN\": \"08165940832\",\r\n \"productId\": 368,\r\n \"network\": \"MTN\",\r\n \"amount\": \"50\",\r\n \"request_id\": \"EL21119628209390I22Z1XOZKINO\",\r\n \"channel\" : \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v2/vend-data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Sat, 05 Jul 2025 10:21:13 GMT"},{"key":"Date","value":"Sat, 05 Jul 2025 10:21:13 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"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, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5995"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Your vend request is successful\",\n \"data\": {\n \"message\": \"SUCCESSFUL\",\n \"status\": \"200\",\n \"trans_ref\": \"EL21119628209390I22Z1XOZKINO\",\n \"retailcode_trans_id\": \"658241751710873\",\n \"amount\": 750,\n \"commission\": 1.75,\n \"available_balance\": 0,\n \"client_type\": \"POSTPAID\",\n \"product_code\": \"DATA\",\n \"network\": \"MTN\",\n \"error_code\": 200,\n \"error_message\": \"Your vend request is successful\",\n \"request_type\": \"DIRECT\"\n }\n}"}],"_postman_id":"340a123c-202f-46b0-875f-15ea4c70b533"},{"name":"Data Bundle Categories","id":"0dbce583-7c81-41ad-8d6c-4459f37d2e09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"The Network Provider e.g MTN, AIRTEL, GLO or 9MOBILE
\n","type":"text/plain"},"key":"network","value":"MTN"},{"description":{"content":"Response from Data Bundle Categories
\n","type":"text/plain"},"key":"categoryId","value":"Monthly"}],"variable":[]}},"response":[{"id":"17824d20-0931-44c3-8263-73f11e576ad8","name":"Data Bundles","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"{{BASE_URL}}/api/v1/get-data-bundles?network=MTN&categoryId=Monthly","host":["{{BASE_URL}}"],"path":["api","v1","get-data-bundles"],"query":[{"key":"network","value":"MTN","description":"The Network Provider e.g MTN, AIRTEL, GLO or 9MOBILE"},{"key":"categoryId","value":"Monthly","description":"Response from Data Bundle Categories"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Feb 2025 08:39:14 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Data Plans\",\n \"data\": [\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"1500\",\n \"allowance\": \"1.8GB + 10 mins\",\n \"productId\": \"MTNM1\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"11000\",\n \"allowance\": \"32GB + 70 mins\",\n \"productId\": \"MTNM2\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"2000\",\n \"allowance\": \"2.7GB + 5mins\",\n \"productId\": \"MTNM3\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"35000\",\n \"allowance\": \"150GB\",\n \"productId\": \"MTNM4\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"36\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"4500\",\n \"allowance\": \"8GB + 25mins\",\n \"productId\": \"MTNM5\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"1500\",\n \"allowance\": \"1.8GB + 5mins\",\n \"productId\": \"MTNM6\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"39\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"3500\",\n \"allowance\": \"5.5GB\",\n \"productId\": \"MTNM7\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"7500\",\n \"allowance\": \"20GB\",\n \"productId\": \"MTNM8\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"11000\",\n \"allowance\": \"32GB\",\n \"productId\": \"MTNM9\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"40000\",\n \"allowance\": \"150GB\",\n \"productId\": \"MTNM10\",\n \"validity\": \"2 Months\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"120000\",\n \"allowance\": \"480GB\",\n \"productId\": \"MTNM11\",\n \"validity\": \"3 Months\",\n \"tarrifId\": \"39\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"50000\",\n \"allowance\": \"200GB\",\n \"productId\": \"MTNM12\",\n \"validity\": \"2 Months\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"3000\",\n \"allowance\": \"4.25GB + 10mins\",\n \"productId\": \"MTNM13\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"36\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"9000\",\n \"allowance\": \"25GB\",\n \"productId\": \"MTNM14\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"36\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"20000\",\n \"allowance\": \"75GB\",\n \"productId\": \"MTNM15\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"5000\",\n \"allowance\": \"11GB + 25mins\",\n \"productId\": \"MTNM16\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"9\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"10000\",\n \"allowance\": \"25GB SME\",\n \"productId\": \"MTNM17\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"12\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"50000\",\n \"allowance\": \"165GB SME 2-Months\",\n \"productId\": \"MTNM18\",\n \"validity\": \"2 Months\",\n \"tarrifId\": \"12\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"100000\",\n \"allowance\": \"360GB SME 3-Months\",\n \"productId\": \"MTNM19\",\n \"validity\": \"3 Months\",\n \"tarrifId\": \"12\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"13500\",\n \"allowance\": \"35GB SME\",\n \"productId\": \"MTNM20\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"12\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"350000\",\n \"allowance\": \"1TB SME 3-Months\",\n \"productId\": \"MTNM21\",\n \"validity\": \"3 Months\",\n \"tarrifId\": \"12\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"2000\",\n \"allowance\": \"4.5GB + 2000 talktime\",\n \"productId\": \"MTNM22\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"3500\",\n \"allowance\": \"12GB+3500 talktime\",\n \"productId\": \"MTNM23\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"24\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"5000\",\n \"allowance\": \"15GB + 5000 talktime\",\n \"productId\": \"MTNM24\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"15000\",\n \"allowance\": \"50GB + 15000 talktime\",\n \"productId\": \"MTNM25\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n },\n {\n \"network\": \"MTN\",\n \"category\": \"Monthly\",\n \"price\": \"20000\",\n \"allowance\": \"70GB + 20000 talktime\",\n \"productId\": \"MTNM26\",\n \"validity\": \"30 Days\",\n \"tarrifId\": \"25\"\n }\n ]\n}"}],"_postman_id":"ea17b02d-d396-4507-9f8c-a9bac994f507"},{"name":"Data Bundles V2","id":"8629da6e-53e6-416e-bc76-222cb720b62c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"Optional Vend Type Filter either VTU or DATA
\n","type":"text/plain"},"key":"vendType","value":"DATA"},{"disabled":true,"description":{"content":"Optional Date to Start From
\n","type":"text/plain"},"key":"startDate","value":"2023-02-23"},{"disabled":true,"description":{"content":"Optional Date to End At
\n","type":"text/plain"},"key":"endDate","value":"2023-02-29"},{"disabled":true,"description":{"content":"Optional Search String e.g transactionReference
\n","type":"text/plain"},"key":"query","value":"1721283239356"}],"variable":[]}},"response":[{"id":"f9000825-9cd9-4af0-a754-8da48b6c956e","name":"Get Data Purchases","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{BASE_URL}}/api/v1/vend-transactions?vendType=DATA&startDate=2023-02-23&endDate=2023-02-29&query=1721283239356","host":["{{BASE_URL}}"],"path":["api","v1","vend-transactions"],"query":[{"key":"vendType","value":"DATA"},{"key":"startDate","value":"2023-02-23"},{"key":"endDate","value":"2023-02-29"},{"key":"query","value":"1721283239356"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 19 Jul 2024 09:33:23 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"\",\n \"currentPage\": 1,\n \"hasMorePages\": true,\n \"lastPage\": 101,\n \"nextPageUrl\": \"http://corporateprodapi.retailcode.com.ng/api/v1/vend-transactions?page=2\",\n \"perPage\": 40,\n \"previousPageUrl\": null,\n \"total\": 4005,\n \"url\": \"http://corporateprodapi.retailcode.com.ng/api/v1/vend-transactions\",\n \"data\": [\n {\n \"id\": 11607355,\n \"requestId\": \"AIRTEL211190032628209390I220Z1XOZKINO\",\n \"transactionReference\": \"1721381290834\",\n \"sequence\": \"5129711721381286\",\n \"transactionType\": \"DATA\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09021585450\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-07-19T09:28:10.000000Z\"\n },\n {\n \"id\": 11607068,\n \"requestId\": \"90009IP54229L003L096L382U21NPP9MJNLN9\",\n \"transactionReference\": \"1721380889258\",\n \"sequence\": \"3399951721380885\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09021585450\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-07-19T09:21:29.000000Z\"\n },\n {\n \"id\": 9839248,\n \"requestId\": \"IP02OPMMMMKLPHHBPPOU0KL2N0MK\",\n \"transactionReference\": \"2024060509141400505027422\",\n \"sequence\": \"2130491717575250\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-06-05T08:14:12.000000Z\"\n },\n {\n \"id\": 6892535,\n \"requestId\": \"IP02OPMMMMKLPHHBPPU0KL2N0MKN\",\n \"transactionReference\": \"2024031813591736703282705\",\n \"sequence\": \"3701531710766754\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-18T12:59:16.000000Z\"\n },\n {\n \"id\": 6890511,\n \"requestId\": \"IP02OPMMMMKLPHHBPPU0KL2N00MKN\",\n \"transactionReference\": \"2024031812595768802139463\",\n \"sequence\": \"3135831710763194\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-18T11:59:56.000000Z\"\n },\n {\n \"id\": 6826652,\n \"requestId\": \"IP02OPMMMMKLPPKHHBPPU0KL2N00MKK\",\n \"transactionReference\": \"2024031510461406208335087\",\n \"sequence\": \"5346161710495972\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"5.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-15T09:46:12.000000Z\"\n },\n {\n \"id\": 6238374,\n \"requestId\": \"IP02OPMMMMKLPPKHHBPPU0KL2N00M\",\n \"transactionReference\": \"2024030110132824902229027\",\n \"sequence\": \"2103231709284407\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T09:13:27.000000Z\"\n },\n {\n \"id\": 6238267,\n \"requestId\": \"IP02OPMMMMKLPPLKHHBPPU0KL2N00M\",\n \"transactionReference\": \"R240301.1011.22004a\",\n \"sequence\": \"9506471709284264\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T09:11:04.000000Z\"\n },\n {\n \"id\": 6236918,\n \"requestId\": \"IP02OPMMMMKKNNKLLPPLKHHBPPU0KL2NPL0000M\",\n \"transactionReference\": \"2024030109433380008286439\",\n \"sequence\": \"3660521709282613\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"08165940838\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:43:33.000000Z\"\n },\n {\n \"id\": 6236178,\n \"requestId\": \"IP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000M\",\n \"transactionReference\": \"\",\n \"sequence\": \"4239571709281712\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:28:32.000000Z\"\n },\n {\n \"id\": 6236069,\n \"requestId\": \"IP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000ML\",\n \"transactionReference\": \"\",\n \"sequence\": \"1012021709281556\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"50.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:25:56.000000Z\"\n },\n {\n \"id\": 6235245,\n \"requestId\": \"9NIP02OPMMMMKKKLLPPLKHHBPPU0KL2NPL0000ML\",\n \"transactionReference\": \"\",\n \"sequence\": \"3024851709280596\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"100.00\",\n \"destinationNumber\": \"09016607480\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"AIRTEL\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-03-01T08:09:56.000000Z\"\n },\n {\n \"id\": 6207930,\n \"requestId\": \"547a10b0-fc78-45ee-8913-f0fbe2d6f3c0\",\n \"transactionReference\": \"1709178135506\",\n \"sequence\": \"5183261709178133\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:13.000000Z\"\n },\n {\n \"id\": 6207905,\n \"requestId\": \"4e4dd597-f4f3-4389-8738-b596db755262\",\n \"transactionReference\": \"1709178135946\",\n \"sequence\": \"3855911709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207906,\n \"requestId\": \"e0bc041e-7400-406d-8892-551a7628967a\",\n \"transactionReference\": \"1709178132375\",\n \"sequence\": \"7297471709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207907,\n \"requestId\": \"005ad8b8-af08-446f-9e2c-65ce39f96b74\",\n \"transactionReference\": \"1709178132393\",\n \"sequence\": \"6950981709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207908,\n \"requestId\": \"644f5e41-cbfa-4a8a-b8bd-10efa39eb3f3\",\n \"transactionReference\": \"170917813444\",\n \"sequence\": \"3909541709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207909,\n \"requestId\": \"4255ceab-d04f-48fc-8bb4-4d786556ee31\",\n \"transactionReference\": \"1709178135211\",\n \"sequence\": \"4577421709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207910,\n \"requestId\": \"4c83b13d-74a6-4e5e-bb31-21be8d3e04ea\",\n \"transactionReference\": \"1709178132772\",\n \"sequence\": \"2344071709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207911,\n \"requestId\": \"656782c1-f292-40d2-8b0c-39378d4082fb\",\n \"transactionReference\": \"1709178135341\",\n \"sequence\": \"1150361709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207912,\n \"requestId\": \"fd8a1ab9-ccfd-4796-b063-d0f00dbd0ff2\",\n \"transactionReference\": \"1709178135929\",\n \"sequence\": \"7932481709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207913,\n \"requestId\": \"2bcc971e-23f9-4b9e-a5b2-1b683e9486b2\",\n \"transactionReference\": \"1709178132701\",\n \"sequence\": \"5325021709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207914,\n \"requestId\": \"ce4914ff-a418-465f-ad88-ad2aa4456c56\",\n \"transactionReference\": \"1709178135165\",\n \"sequence\": \"3372831709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207915,\n \"requestId\": \"9d3e15ce-c7a7-41ba-86cc-ab4fae4e1784\",\n \"transactionReference\": \"1709178135757\",\n \"sequence\": \"9884891709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207916,\n \"requestId\": \"d3c3a6b9-c108-410f-8120-867a977ac7c9\",\n \"transactionReference\": \"1709178135319\",\n \"sequence\": \"4144081709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207917,\n \"requestId\": \"9546b798-3a29-484e-b8d0-34f64d486f05\",\n \"transactionReference\": \"1709178135709\",\n \"sequence\": \"6740041709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207918,\n \"requestId\": \"86600e90-0232-4564-952d-245f299769a5\",\n \"transactionReference\": \"1709178134275\",\n \"sequence\": \"9161661709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207919,\n \"requestId\": \"c6529028-a052-4640-9c22-41ad8ec433e6\",\n \"transactionReference\": \"1709178135900\",\n \"sequence\": \"4098101709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207920,\n \"requestId\": \"49ce6a17-4345-4920-9cdc-da3264b62695\",\n \"transactionReference\": \"1709178135803\",\n \"sequence\": \"4412181709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207921,\n \"requestId\": \"2627fdca-5aa7-4e92-b424-4f2756b8a1d3\",\n \"transactionReference\": \"1709178134939\",\n \"sequence\": \"5448481709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207922,\n \"requestId\": \"b5441abc-6eca-489c-8ae3-00706d328479\",\n \"transactionReference\": \"1709178135392\",\n \"sequence\": \"5660511709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207923,\n \"requestId\": \"9113db54-ad5c-4994-b89f-efb72eea7ac5\",\n \"transactionReference\": \"1709178135199\",\n \"sequence\": \"4131491709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207924,\n \"requestId\": \"0f38152a-8095-4fd3-842a-2c9de745e186\",\n \"transactionReference\": \"1709178135319\",\n \"sequence\": \"6486081709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207925,\n \"requestId\": \"967a6d75-49f0-432e-bba9-45517d872b32\",\n \"transactionReference\": \"1709178135691\",\n \"sequence\": \"7616561709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207926,\n \"requestId\": \"6ce2fcc9-623b-4952-b72d-b3649291ab66\",\n \"transactionReference\": \"1709178135705\",\n \"sequence\": \"6380471709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207927,\n \"requestId\": \"caf84f1d-9504-44a0-bb00-747a25cc4b06\",\n \"transactionReference\": \"1709178135990\",\n \"sequence\": \"2001241709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207928,\n \"requestId\": \"c4645e7d-ff2c-466d-b659-b6813af02ef9\",\n \"transactionReference\": \"1709178135159\",\n \"sequence\": \"7996681709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207929,\n \"requestId\": \"3cb8a16a-dbe3-484c-9ad3-70044bb5403d\",\n \"transactionReference\": \"1709178135975\",\n \"sequence\": \"3770021709178132\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:12.000000Z\"\n },\n {\n \"id\": 6207874,\n \"requestId\": \"ada97476-e4e0-4e41-a8d2-22c0b151d88a\",\n \"transactionReference\": \"1709178132330\",\n \"sequence\": \"5597281709178130\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:11.000000Z\"\n },\n {\n \"id\": 6207875,\n \"requestId\": \"963ed3b4-251e-4394-a9c6-d2f2692570c2\",\n \"transactionReference\": \"1709178131639\",\n \"sequence\": \"1311561709178131\",\n \"transactionType\": \"AIRTIME\",\n \"amount\": \"1.00\",\n \"destinationNumber\": \"09132440866\",\n \"corporateName\": \"Retopin \",\n \"clientType\": \"POSTPAID\",\n \"status\": \"SUCCESSFUL\",\n \"network\": \"MTN\",\n \"responseCode\": null,\n \"responseMessage\": null,\n \"statusId\": null,\n \"response\": null,\n \"createdAt\": \"2024-02-29T03:42:11.000000Z\"\n }\n ]\n}"}],"_postman_id":"3327ddfa-c657-44e2-9f63-b073b5dbf0c0"},{"name":"Query Transaction","id":"5fb174cb-917a-47d8-a4dc-e7334cd8075f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"The Auto Top-up API ensures uninterrupted communication for your customers by automatically topping up airtime or data when predefined thresholds are reached.
\n⚠️ Note: Auto Top-up is only available upon activation by an admin. To request activation, please contact products@retailcode.africa.
\nOnce activated, you can configure the following:
\nCallback URL – Where the result of the top-up attempt will be sent.
\nMinimum Allowed Top-up – The lowest value that can be auto-topped up.
\nMaximum Allowed Top-up – The highest value that can be auto-topped up.
\nWhen a top-up notification is received from the MNO, the system will send a callback to your configured URL with the following payload depending on the event type:
\nOnboarding
\n{\n \"event\": \"ONBOARDING\",\n \"status\": 200,\n \"message\": \"Onboarded Successfully\",\n \"type\": \"AIRTIME\",\n \"recipientMSISDN\" : \"2348012345678\",\n \"customerMSISDN\" : \"2348012345678\",\n \"network\": \"MTN\"\n}\n\n{\n \"event\": \"AIRTIME\",\n \"status\": 200,\n \"message\": \"Airtime top-up processed successfully\",\n \"topUpValue\": 500.00,\n \"recipientMSISDN\" : \"2348012345678\",\n \"customerMSISDN\" : \"2348012345678\",\n \"network\": \"MTN\",\n \"requestId\": \"ref_12345\"\n}\n\n{\n \"event\": \"DATA\",\n \"status\": 200,\n \"message\": \"Data top-up processed successfully\",\n \"topUpValue\": \"MTNM10\",\n \"recipientMSISDN\" : \"2348012345678\",\n \"customerMSISDN\" : \"2348012345678\",\n \"network\": \"MTN\",\n \"requestId\": \"ref_67890\"\n}\n\nThe Retailcode Auto Top-up SDK is a high-fidelity, client-side widget that allows subscribers to automate their airtime and data recharges. It intelligently handles user states (New, Partial, or Full Subscriber) and supports \"Dependent\" management for third-party recharges.
\nInclude the SDK script at the bottom of your HTML or inside the HTML
\n<script src=\"https://corporatedevapi.retailcode.com.ng/sdk/v1/retail-code.js\"></script>\n\nTo initialize the widget, use the RetailcodeTopup.create() method followed by .mount().
Here's the updated table with onClose added:
RetailcodeTopup.create({\n publicKey : \"public_1b2449bb66dd7063d837f6913d2305087da2c93e\",\n msisdn : \"08165940838\",\n container : \"#widget-container\",\n theme : { \n accent: \"#173C21\" \n },\n onSuccess : function (data) {\n console.log(\"Subscription Successful:\", data);\n // Handle post-success logic here\n }\n}).mount();\n\nThe SDK is designed to work seamlessly inside WebViews (React Native, Android, and iOS). Use the following logic inside onSuccess to communicate back to the native app:
The SDK sends a stringified JSON object via window.ReactNativeWebView.postMessage
const payload = JSON.stringify({ action: 'success', ...data });\nwindow.ReactNativeWebView.postMessage(payload);\n\nThe SDK communicates via the retailcode message handler.
JavaScript
\nwindow.webkit.messageHandlers.retailcode.postMessage({ action: 'success', data });\n\nThe SDK calls the onSuccess method on the registered JavaScript Interface.
window.Android.onSuccess(payload);\n\nThe SDK performs pre-render validation. If validation fails, it renders an error card inside the container instead of the modal.
\nMSISDN Validation: Checks if the number matches the Nigerian format /^(234[789][01]\\d{8}|0[789][01]\\d{8})$/.
Public Key Validation: If the API returns a 400 or 403 error, the SDK displays: \"SDK failed to initialize: Public API key is invalid or expired.\"
URL State: Upon completion or failure, the SDK appends ?status=successful or ?status=failed to the browser URL for external monitoring.
The SDK UI adapts automatically based on the msisdn provided:
New User: Shows selectors for Airtime, Data, or Both.
\nPartial User: Shows only the service the user has NOT subscribed to yet.
\nFull User / Dependent Mode: Transitions into the \"Add Dependent\" UI, allowing recharges for secondary phone numbers.
\nUse the onMessage prop of the react-native-webview component.
JavaScript
\nimport { WebView } from 'react-native-webview';\nconst RetailcodeWebView = () => {\n const handleMessage = (event) => {\n const data = JSON.parse(event.nativeEvent.data);\n if (data.action === 'success') {\n console.log('Top-up active!', data);\n // Navigate to native success screen\n }\n if (data.action === 'close') {\n // Close the modal or go back\n }\n };\n return (\n source={{ uri: 'https://corporatedevapi.retailcode.com.ng/v1/auto-topup/sdk?pk=PK&msisdn=PHONE' }}\n onMessage={handleMessage}\n />\n );\n};\n\nYou must register a JavaScript Interface named Android.
Java
\n// Native Java/Kotlin side\nwebView.addJavascriptInterface(new Object() {\n @JavascriptInterface\n public void onSuccess(String payload) {\n // Handle success (JSON string)\n }\n @JavascriptInterface\n public void close() {\n // Close the WebView activity/fragment\n }\n}, \"Android\");\n\nUse the WKScriptMessageHandler protocol and listen for the retailcode name.
Swift
\n// Swift side\nclass ViewController: UIViewController, WKScriptMessageHandler {\n func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {\n if message.name == \"retailcode\", let dict = message.body as? [String: Any] {\n let action = dict[\"action\"] as? String\n if action == \"success\" {\n // Handle Success\n } else if action == \"close\" {\n self.dismiss(animated: true)\n }\n }\n }\n}\n\nOptional Date to Start From
\n","type":"text/plain"},"key":"startDate","value":"2024-02-01"},{"description":{"content":"Optional Date to End At
\n","type":"text/plain"},"key":"endDate","value":"2024-06-01"}],"variable":[]}},"response":[],"_postman_id":"1aa64465-c967-49f5-935d-d5e4ecc87351"},{"name":"Get Assigned Services","id":"6700bcc6-5bc8-4afc-a99b-1b72fd28c376","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"Retrieves the Wallet balance assigned to a client using Api key. This endpoint is available exclusively to Prepaid & PostPaid clients.
\n","urlObject":{"path":["api","v1","wallet"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"96a38c08-b583-499d-bf88-5c8bf87825fd","name":"Get Wallet Balance","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"bearer 5212c4a6493994b1d16881fe9cfe9e68df19748d","type":"text","disabled":true}],"url":"{{BASE_URL}}/api/v1/wallet"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 19 Jul 2024 09:38:12 GMT"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5999"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Client Wallet\",\n \"data\": {\n \"availableBalance\": \"977555.00\",\n \"clientType\": \"POSTPAID\"\n }\n}"},{"id":"5b5dbfde-3380-4681-a273-9bd517304bee","name":"Get Wallet Balance Failed","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"bearer 5212c4a6493994b1d16881fe9cfe9e68df19748d","type":"text","disabled":true}],"url":"{{BASE_URL}}/api/v1/wallet"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:8093"},{"key":"Date","value":"Tue, 06 May 2025 10:01:44 GMT"},{"key":"Date","value":"Tue, 06 May 2025 10:01:44 GMT"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.6"},{"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, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5993"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"This service is only available to Prepaid & Postpaid Clients\",\n \"errors\": [\n \"This service is only available to Prepaid & Postpaid Clients\"\n ]\n}"}],"_postman_id":"a3f9186c-60d0-44d7-b607-1e66c2e5831e"},{"name":"Get VTU Balance","id":"5908b85b-5c90-4167-97ff-24cfd7f00988","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"Retrieves the VTU balance assigned to a client using Api key. This endpoint is available exclusively to Post Paid Plus clients.
\n","urlObject":{"path":["api","v1","vtu-balance"],"host":["{{BASE_URL}}"],"query":[{"description":{"content":"MTN, AIRTEL, GLO or 9MOBILE
\n","type":"text/plain"},"key":"network","value":"MTN"}],"variable":[]}},"response":[{"id":"b71e68ac-6144-4166-aa02-e66c57123055","name":"Get VTU Balance","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{BASE_URL}}/api/v1/vtu-balance?network=MTN","host":["{{BASE_URL}}"],"path":["api","v1","vtu-balance"],"query":[{"key":"network","value":"MTN","description":"MTN, AIRTEL, GLO or 9MOBILE"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.24.0"},{"key":"Content-Type","value":"application/json"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 06 May 2025 09:54:24 GMT"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Token-Auth, Authorization, Accept, Application"},{"key":"X-RateLimit-Limit","value":"6000"},{"key":"X-RateLimit-Remaining","value":"5995"},{"key":"Access-Control-Expose-Headers","value":"Accept, Authorization, Origin, Content-Type, X-Requested-With"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Available Test VTU Balance\",\n \"data\": {\n \"availableBalance\": 200000\n }\n}"}],"_postman_id":"5908b85b-5c90-4167-97ff-24cfd7f00988"},{"name":"Download Vend Transactions","id":"4745c135-6c3a-441e-9ca2-c80dde0057c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{apiKey}}"},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"date\" : \"2025-07-03\"\n}","options":{"raw":{"language":"json"}}},"url":"{{BASE_URL}}/api/v1/vend-transactions","urlObject":{"path":["api","v1","vend-transactions"],"host":["{{BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4745c135-6c3a-441e-9ca2-c80dde0057c0"}]}