{"info":{"_postman_id":"63de15ea-6975-4703-bad8-d2bd982b6fad","name":"SMS Delivery","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"19359621","collectionId":"63de15ea-6975-4703-bad8-d2bd982b6fad","publishedId":"2s93XsY6B5","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2023-04-09T09:33:50.000Z"},"item":[{"name":"WhatsApp Services","item":[{"name":"Send PDF","id":"62b40528-697c-476b-b615-014e3b3a6987","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": \"recipient\",\r\n \"file\": \"base64_encoded_file_content\",\r\n \"caption\": \"Your caption here\",\r\n \"name\": \"PDF_File.pdf\",\r\n \"password\":\"Ask_for_the_password\"\r\n}","options":{"raw":{"language":"json"}}},"url":"host:port/base64/pdf","urlObject":{"port":"port","path":["base64","pdf"],"host":["host"],"query":[],"variable":[]}},"response":[],"_postman_id":"62b40528-697c-476b-b615-014e3b3a6987"},{"name":"Send Image","id":"8c492a02-fff8-45c9-8511-48867b7b2bf7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": \"recipient\",\r\n \"file\": \"base64_encoded_file_content\",\r\n \"caption\": \"Your caption here\",\r\n \"name\": \"Image_File.png\",\r\n \"password\":\"Ask_for_the_password\",\r\n \"isDocument\":\"true/false\"\r\n}","options":{"raw":{"language":"json"}}},"url":"host:port/base64/image","urlObject":{"port":"port","path":["base64","image"],"host":["host"],"query":[],"variable":[]}},"response":[],"_postman_id":"8c492a02-fff8-45c9-8511-48867b7b2bf7"},{"name":"Send Word","id":"10edf1ee-b34c-41f7-ac6b-c63081a1eeeb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": \"recipient\",\r\n \"file\": \"base64_encoded_file_content\",\r\n \"caption\": \"Your caption here\",\r\n \"name\": \"PDF_File.pdf\",\r\n \"password\":\"Ask_for_the_password\"\r\n}","options":{"raw":{"language":"json"}}},"url":"host:port/base64/word","urlObject":{"port":"port","path":["base64","word"],"host":["host"],"query":[],"variable":[]}},"response":[],"_postman_id":"10edf1ee-b34c-41f7-ac6b-c63081a1eeeb"},{"name":"Send Audio","id":"a01bb1b8-eef2-4fce-b270-73a0820e4735","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": \"recipient\",\r\n \"file\": \"base64_encoded_file_content\",\r\n \"name\": \"Audio_File.pdf\",\r\n \"password\":\"Ask_for_the_password\"\r\n}","options":{"raw":{"language":"json"}}},"url":"host:port/base64/audio","urlObject":{"port":"port","path":["base64","audio"],"host":["host"],"query":[],"variable":[]}},"response":[],"_postman_id":"a01bb1b8-eef2-4fce-b270-73a0820e4735"},{"name":"Send Text","id":"6551651a-c406-4a3c-b236-733cd39f4098","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://whatsapp.telcomw.com/send?recipient=265992026866&message= message&password=.....","urlObject":{"protocol":"https","path":["send"],"host":["whatsapp","telcomw","com"],"query":[{"key":"recipient","value":"265992026866"},{"key":"message","value":" message"},{"key":"password","value":"....."}],"variable":[]}},"response":[{"id":"72912810-6628-46d2-863a-93fead96b8ac","name":"Send Text","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"},{"key":"x-app-id","value":"","type":"text"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"recipient\": \"265992026866\",\r\n \"message\": \"message\"\r\n },\r\n {\r\n \"recipient\": \"265992026866\",\r\n \"message\": \"message 2\"\r\n },\r\n {\r\n \"recipient\": \"265884113450\",\r\n \"message\": \"message\"\r\n }\r\n]","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/whatsapp/text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 23 Oct 2024 14:27:16 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=QKmbEnP7Lf%2FU1QBOtuQjcYZEh4o99WABr3aYqU5YTIhP7R8dfwSogKpk9DTpIeOyBknCXurvXBk0OBR1Dx57q3edm4LsOCk4lpCR1R008Z%2Flh%2BbvE4t8qmy8bTAQwQ%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d72682b7deb95f5-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=109422&sent=105&recv=99&lost=0&retrans=0&sent_bytes=7603&recv_bytes=3010&delivery_rate=47872&cwnd=257&unsent_bytes=0&cid=3fe8db8e586eb8e7&ts=102043&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Request to send messages was successful\",\n \"status\": 200,\n \"success\": true,\n \"data\": [\n {\n \"success\": true,\n \"message\": \"Message sent\",\n \"data\": {\n \"recipient\": \"265992026866\",\n \"message\": \"message\"\n }\n },\n {\n \"success\": true,\n \"message\": \"Message sent\",\n \"data\": {\n \"recipient\": \"265992026866\",\n \"message\": \"message 2\"\n }\n },\n {\n \"success\": true,\n \"message\": \"Message sent\",\n \"data\": {\n \"recipient\": \"265884113450\",\n \"message\": \"message\"\n }\n }\n ]\n}"}],"_postman_id":"6551651a-c406-4a3c-b236-733cd39f4098"},{"name":"Send Polls","id":"4d4f75ec-71fd-4c71-9ef2-37cd7f950c85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": [\r\n \"265884113450\",\r\n \"265992026866\"\r\n ],\r\n \"question\": \"Question which you wanted ask\",\r\n \"options\": [\"Option 1\",\"Option 2\"],\r\n \"password\": \"...\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:9205/poll","urlObject":{"protocol":"http","port":"9205","path":["poll"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"9d64c1ed-c046-48e4-b958-69b127dfce07","name":"Send Polls","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": [\r\n \"265884113450\",\r\n \"265992026866\"\r\n ],\r\n \"question\": \"message\",\r\n \"options\": [\"Option 1\",\"Option 2\"],\r\n \"password\": \"Owen\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:9205/poll"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"179"},{"key":"ETag","value":"W/\"b3-w1VM4UrQ3xazPzpMAQDSQIDaDLY\""},{"key":"Date","value":"Tue, 30 Dec 2025 12:47:14 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Poll sending completed\",\n \"sent\": 2,\n \"failed\": 0,\n \"results\": [\n {\n \"recipient\": \"265884113450\",\n \"status\": \"success\"\n },\n {\n \"recipient\": \"265992026866\",\n \"status\": \"success\"\n }\n ]\n}"}],"_postman_id":"4d4f75ec-71fd-4c71-9ef2-37cd7f950c85"},{"name":"Send Buttons","id":"e70509e2-0beb-4056-98bb-9ae15ef70f63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": \"+265992026866\",\r\n \"bodyText\": \"How can we help you today?\",\r\n \"buttonText\": \"Select Service\",\r\n \"sections\": [\r\n {\r\n \"title\": \"Customer Service\",\r\n \"rows\": [\r\n {\"id\": \"1\", \"title\": \"Support\", \"description\": \"Get technical support\"},\r\n {\"id\": \"2\", \"title\": \"Sales\", \"description\": \"Talk to sales team\"}\r\n ]\r\n }\r\n ],\r\n \"footerText\": \"We're here to help\",\r\n \"password\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:9205/list","urlObject":{"protocol":"http","port":"9205","path":["list"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"e5bfe965-83b5-426f-8bd5-93bdb0f73bb4","name":"Send Buttons","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"recipient\": [\r\n \"265884113450\",\r\n \"265992026866\"\r\n ],\r\n \"question\": \"message\",\r\n \"options\": [\"Option 1\",\"Option 2\"],\r\n \"password\": \"Owen\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:9205/poll"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"179"},{"key":"ETag","value":"W/\"b3-w1VM4UrQ3xazPzpMAQDSQIDaDLY\""},{"key":"Date","value":"Tue, 30 Dec 2025 12:47:14 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Poll sending completed\",\n \"sent\": 2,\n \"failed\": 0,\n \"results\": [\n {\n \"recipient\": \"265884113450\",\n \"status\": \"success\"\n },\n {\n \"recipient\": \"265992026866\",\n \"status\": \"success\"\n }\n ]\n}"}],"_postman_id":"e70509e2-0beb-4056-98bb-9ae15ef70f63"}],"id":"6746b394-211e-4bff-94b9-977c6bf1eb4b","description":"

API's for WhatsApp Conversation

\n","_postman_id":"6746b394-211e-4bff-94b9-977c6bf1eb4b"},{"name":"OTP Services","item":[{"name":"Request OTP","id":"f0961376-ab47-4479-9bc5-6c89d15ef522","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://otp_api.telcomw.com/request?id=123456&client=265992026866&channels=[wa.audio,wa.text,phone.call,phone.text]","urlObject":{"protocol":"https","path":["request"],"host":["otp_api","telcomw","com"],"query":[{"key":"id","value":"123456"},{"key":"client","value":"265992026866"},{"key":"channels","value":"[wa.audio,wa.text,phone.call,phone.text]"}],"variable":[]}},"response":[{"id":"81facea5-4b64-4750-a996-1b84196fdea0","name":"Request OTP","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://otp_api.telcomw.com/request?id=123456&client=265992026866&channels=[wa.audio,wa.text,phone.call,phone.text]","protocol":"https","host":["otp_api","telcomw","com"],"path":["request"],"query":[{"key":"id","value":"123456"},{"key":"client","value":"265992026866"},{"key":"channels","value":"[wa.audio,wa.text,phone.call,phone.text]"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 24 May 2024 21:28:02 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=d%2B1xvkitifiUulifid7Bxm69lReedootnn72glMIq%2By4eAxAE%2BlbJlTBEQAlAsjVRdNrq2brdnGyTT%2BkbX4wfIvnFonxvJlqeIGbsNZf8YbtnAXmehbosio2MraAz476Pa4eptwA\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"88905f7a4fe363cc-LHR"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"The OTP has been sent successfully\",\n \"route\": \"request\",\n \"ref\": \"99CF5784EFF0A32F508ABDD446723C46\",\n \"cost\": 50,\n \"channelsUsed\": {\n \"wa.audio\": \"successful\",\n \"wa.text\": \"successful\",\n \"phone.call\": \"successful\",\n \"phone.text\": \"successful\"\n }\n}"}],"_postman_id":"f0961376-ab47-4479-9bc5-6c89d15ef522"},{"name":"Verify OTP","id":"41b8dd0c-effa-4184-9b52-a772e1cb62b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://otp_api.telcomw.com/verify?id=123456&ref=D3F66B481CA89BD9C5F6E47F4645EEDC&otp=2337","urlObject":{"protocol":"https","path":["verify"],"host":["otp_api","telcomw","com"],"query":[{"key":"id","value":"123456"},{"key":"ref","value":"D3F66B481CA89BD9C5F6E47F4645EEDC"},{"key":"otp","value":"2337"}],"variable":[]}},"response":[{"id":"57d4c0eb-5ddc-4fc0-8a6d-42d7a99e6b56","name":"Verify OTP Verified","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://otp_api.telcomw.com/verify?id=123456&ref=D3F66B481CA89BD9C5F6E47F4645EEDC&otp=2337","protocol":"https","host":["otp_api","telcomw","com"],"path":["verify"],"query":[{"key":"id","value":"123456"},{"key":"ref","value":"D3F66B481CA89BD9C5F6E47F4645EEDC"},{"key":"otp","value":"2337"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 23 May 2024 14:24:28 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=XT3pH5OtGwosvQobFbJO1aiRWi8dYwsq5xNPaBQHhm8ABd8ULbKjIh%2B066xghUuNt5XGP7GH2XVoqiQvxyQN09ePaRzz2pW7U11FUDw1Z0CcVySx7YZwRmKnLy4gjSLaHX%2FTxBr%2B\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8885b5b208fe95ec-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"The OTP has been verified successfully\",\n \"route\": \"verify\"\n}"},{"id":"98d128ca-968c-4540-87de-e664227ed332","name":"Verify OTP Error","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://otp_api.telcomw.com/verify?id=123456&ref=D3F66B481CA89BD9C5F6E47F4645EEDC&otp=2335","protocol":"https","host":["otp_api","telcomw","com"],"path":["verify"],"query":[{"key":"id","value":"123456"},{"key":"ref","value":"D3F66B481CA89BD9C5F6E47F4645EEDC"},{"key":"otp","value":"2335"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 23 May 2024 14:23:59 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=17fTyht6rKkUrxvF3mX08UNnsiST6ppJUMCogiyBmyLgfv96deROZteF9PS%2BusTCLzn%2FJARMknqgU80LYcIp2FRip0E67P7HjKeM4z202VnzHHjgK%2F08Fm4iUwdGYIurGEACrfkn\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8885b4fc6ce395ec-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"The OTP submitted is invalid, please double check\",\n \"route\": \"verify\"\n}"}],"_postman_id":"41b8dd0c-effa-4184-9b52-a772e1cb62b7"},{"name":"Get Secure Form","id":"2ccad0ee-7226-4d7c-a95b-59cafbe39e9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://otp_api.telcomw.com/form?channels=[wa.audio,wa.text,phone.call,phone.text]&loginURL=https://telcomw.com/login2.php","urlObject":{"protocol":"https","path":["form"],"host":["otp_api","telcomw","com"],"query":[{"key":"channels","value":"[wa.audio,wa.text,phone.call,phone.text]"},{"key":"loginURL","value":"https://telcomw.com/login2.php"}],"variable":[]}},"response":[{"id":"89654530-afc7-46a8-9457-595ac7f012c4","name":"Get Secure Form Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://otp_api.telcomw.com/form?channels=[wa.audio,wa.text,phone.call,phone.text]&loginURL=https://telcomw.com/login2.php","protocol":"https","host":["otp_api","telcomw","com"],"path":["form"],"query":[{"key":"channels","value":"[wa.audio,wa.text,phone.call,phone.text]"},{"key":"loginURL","value":"https://telcomw.com/login2.php"}]}},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Date","value":"Sat, 25 May 2024 13:12:08 GMT"},{"key":"Content-Type","value":"text/html; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=Q7Uq48b%2BYPx6gKSCemvZYp89spYmDdpGx5ron1vOY4RDTNFDkYFxC3b%2BStoGHFs7ROnUThC0xWn7RztwP%2Fk2%2B2NPuZJPj8vbN%2F7z%2Bx8tEA4WdoaagY2kEQ8Q4gAN8B%2B6P9A0IOt6\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8895c67868c495f3-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"\n\n \n \n \n Login\n \n \n
\n \"TelcoMW\n
\n
\n \n \r\n \n
\n
\n \n
\n \n \n
\n
\n \n \n
\n
\n \n \n
\n
\n \n \n
\n
\n \n \n
\n \n
\n \n \n"}],"_postman_id":"2ccad0ee-7226-4d7c-a95b-59cafbe39e9f"}],"id":"8d335a81-b4f8-4a55-9da4-eaba04e44ff1","_postman_id":"8d335a81-b4f8-4a55-9da4-eaba04e44ff1","description":""},{"name":"SMS Services","item":[{"name":"Send SMS","id":"a0adfc16-a9ce-431f-8f90-e782b815fe7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"Text message","type":"text"},{"key":"numbers","value":"0992026866","type":"text"},{"key":"from","value":"WGIT","type":"text"}]},"url":"https://telcomw.com/api-v2/send","urlObject":{"protocol":"https","path":["api-v2","send"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"064dd314-e65e-423e-8111-963aeb94fb21","name":"Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"Text message","type":"text"},{"key":"numbers","value":"0884113450","type":"text"},{"key":"from","value":"WGIT","type":"text"}]},"url":"https://telcomw.com/api-v2/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 09 Apr 2023 09:24:18 GMT"},{"key":"Server","value":"Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.1.12"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Content-Length","value":"144"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"success\",\n \"msg\": \"send\",\n \"code\": \"200\",\n \"feedback\": [\n {\n \"status\": 2,\n \"cost\": 18,\n \"msdn\": \"265884113450\",\n \"chars\": 12,\n \"code\": 200,\n \"id\": \"ke4wz6fydbtj\"\n }\n ]\n}"}],"_postman_id":"a0adfc16-a9ce-431f-8f90-e782b815fe7a"},{"name":"Bulk SMS","id":"f19e8877-3135-4f94-a06a-1eaf387c8a71","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"{\"099xxxxxxx\":\"Hello message 1\",\"088xxxxxxx\":\"Hello message 2\"}\n","type":"text"},{"key":"numbers","value":"true/null","type":"text"},{"key":"from","value":"WGIT","type":"text"},{"key":"advance","value":"true","type":"text"}]},"url":"https://telcomw.com/api-v2/send","urlObject":{"protocol":"https","path":["api-v2","send"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"3c54b008-63c7-4b08-af59-bb6aae154731","name":"Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"Text message","type":"text"},{"key":"numbers","value":"0884113450","type":"text"},{"key":"from","value":"WGIT","type":"text"}]},"url":"https://telcomw.com/api-v2/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 09 Apr 2023 09:24:18 GMT"},{"key":"Server","value":"Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.1.12"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Content-Length","value":"144"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"success\",\n \"msg\": \"send\",\n \"code\": \"200\",\n \"feedback\": [\n {\n \"status\": 2,\n \"cost\": 18,\n \"msdn\": \"265884113450\",\n \"chars\": 12,\n \"code\": 200,\n \"id\": \"ke4wz6fydbtj\"\n }\n ]\n}"}],"_postman_id":"f19e8877-3135-4f94-a06a-1eaf387c8a71"},{"name":"Bulk SMS 2","id":"e9baf271-9781-42af-b687-6d4c7b442d30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"{\"099xxxxxxx\":\"Hello message 1\",\"088xxxxxxx\":\"Hello message 2\"}\n","type":"text"},{"key":"numbers","value":"true/null","type":"text"},{"key":"from","value":"WGIT","type":"text"},{"key":"advance","value":"true","type":"text"}]},"url":"https://telcomw.com/api-v2/send","urlObject":{"protocol":"https","path":["api-v2","send"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"ca431848-2b26-460a-991c-675ca28fea41","name":"Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"Text message","type":"text"},{"key":"numbers","value":"0884113450","type":"text"},{"key":"from","value":"WGIT","type":"text"}]},"url":"https://telcomw.com/api-v2/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 09 Apr 2023 09:24:18 GMT"},{"key":"Server","value":"Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.1.12"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Content-Length","value":"144"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"success\",\n \"msg\": \"send\",\n \"code\": \"200\",\n \"feedback\": [\n {\n \"status\": 2,\n \"cost\": 18,\n \"msdn\": \"265884113450\",\n \"chars\": 12,\n \"code\": 200,\n \"id\": \"ke4wz6fydbtj\"\n }\n ]\n}"}],"_postman_id":"e9baf271-9781-42af-b687-6d4c7b442d30"},{"name":"Batch Delivery Report","id":"ce23dede-5934-4ce4-9f7a-a7690d49df1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://telcomw.com/api-v2/delivery/batch","urlObject":{"protocol":"https","path":["api-v2","delivery","batch"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"c696d574-62b2-4b97-9840-5b5e122c0f1d","name":"Batch Delivery Report","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"{\"099xxxxxxx\":\"Hello message 1\",\"088xxxxxxx\":\"Hello message 2\"}\n","type":"text"},{"key":"numbers","value":"true/null","type":"text"},{"key":"from","value":"WGIT","type":"text"},{"key":"advance","value":"true","type":"text"}]},"url":{"raw":"https://telcomw.com/api-v2/delivery/batch?id=&api_key=","protocol":"https","host":["telcomw","com"],"path":["api-v2","delivery","batch"],"query":[{"key":"id","value":""},{"key":"api_key","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Thu, 19 Feb 2026 11:54:47 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Set-Cookie","value":"THE_SMS_DELIVERY_APP=1uji3vr2h4alljggoeafra33ug; path=/"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=b%2B7tyR5Fu6JMajo03IcgK97Kst2%2BEAm7S0KefpqGHZwUMPOTIvlYs0Qat1uvsx4b2sdzH0A6q32ZaB3Lp85aLekVusjw0N%2B0uw%3D%3D\"}]}"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9d05924d897c4895-LIS"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"msg\": \"Batch details retrieved successfully\",\n \"type\": \"success\",\n \"code\": \"200\",\n \"data\": [\n {\n \"to\": \"265992026866\",\n \"from\": \"WGIT\",\n \"text\": \"Dzalani chinangwa ndi mvula yokwanira mizera yotalikana 90cm kuchoka pa nzera ndi nzera wina; ndipo 90cm kuchoka pa phando kukafika pa phando lina munda wa chakudya; pamene munda wochulukitsa mbeu 90cm kuchoka pa nzera ndi nzera wina ndipo 45cm phando ku phando lina; 90cm x 60cm kuchoka pa nzera ndi nzera chogulitsa pa msika\",\n \"status\": \"Delivered\",\n \"sent_at\": \"2024-11-12 12:07:54\",\n \"delivered_at\": \"2024-11-12 10:13:07\"\n },\n {\n \"to\": \"265884113450\",\n \"from\": \"WGIT\",\n \"text\": \"Dzalani chinangwa ndi mvula yokwanira mizera yotalikana 90cm kuchoka pa nzera ndi nzera wina; ndipo 90cm kuchoka pa phando kukafika pa phando lina munda wa chakudya; pamene munda wochulukitsa mbeu 90cm kuchoka pa nzera ndi nzera wina ndipo 45cm phando ku phando lina; 90cm x 60cm kuchoka pa nzera ndi nzera chogulitsa pa msika\",\n \"status\": \"Delivered\",\n \"sent_at\": \"2024-11-12 12:07:54\",\n \"delivered_at\": null\n }\n ]\n}"}],"_postman_id":"ce23dede-5934-4ce4-9f7a-a7690d49df1a"},{"name":"Reference Delivery Report","id":"4e5d1f1d-a9e8-4165-85b4-31911c1d4df1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://telcomw.com/api-v2/delivery/reference?id=reference_id&api_key=your_api_key","urlObject":{"protocol":"https","path":["api-v2","delivery","reference"],"host":["telcomw","com"],"query":[{"key":"id","value":"reference_id"},{"key":"api_key","value":"your_api_key"}],"variable":[]}},"response":[{"id":"8a8ee31e-611c-46d4-bced-604dc2e492d0","name":"Reference Delivery Report","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"{\"099xxxxxxx\":\"Hello message 1\",\"088xxxxxxx\":\"Hello message 2\"}\n","type":"text"},{"key":"numbers","value":"true/null","type":"text"},{"key":"from","value":"WGIT","type":"text"},{"key":"advance","value":"true","type":"text"}]},"url":{"raw":"https://telcomw.com/api-v2/delivery/reference?id=&api_key=","protocol":"https","host":["telcomw","com"],"path":["api-v2","delivery","reference"],"query":[{"key":"id","value":""},{"key":"api_key","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Date","value":"Thu, 19 Feb 2026 11:59:05 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=%2FqpJeIfOUnsbDKrhwS9l0FGc5jzFIjGY3IoV1DPz41Z10P4wGZ4lFxr9lvOF4IBm6W8OoVQevVKoHp33YVrIHgzjTBnn%2FlYUxQ%3D%3D\"}]}"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9d05989c48536914-LIS"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"msg\": \"Message details retrieved successfully\",\n \"type\": \"success\",\n \"code\": \"200\",\n \"data\": {\n \"to\": \"265992026866\",\n \"from\": \"WGIT\",\n \"text\": \"Dzalani chinangwa ndi mvula yokwanira mizera yotalikana 90cm kuchoka pa nzera ndi nzera wina; ndipo 90cm kuchoka pa phando kukafika pa phando lina munda wa chakudya; pamene munda wochulukitsa mbeu 90cm kuchoka pa nzera ndi nzera wina ndipo 45cm phando ku phando lina; 90cm x 60cm kuchoka pa nzera ndi nzera chogulitsa pa msika\",\n \"status\": \"Delivered\",\n \"sent_at\": \"2024-11-12 12:07:54\",\n \"delivered_at\": \"2024-11-12 10:13:07\",\n \"message_batch\": \"mrj6tfmtzguk\"\n }\n}"}],"_postman_id":"4e5d1f1d-a9e8-4165-85b4-31911c1d4df1"},{"name":"Send SMS - GET","id":"acdb79c0-bbcb-4d59-a1f1-b646ede1f27b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://telcomw.com/api-v2/text?message=&phone=&api_key=&password=&from=","description":"

Send Text Message

\n

Overview

\n

This endpoint allows users to send a text message to a specified phone number. It requires authentication via an API key and password, and it provides feedback on the status of the message delivery.

\n

Request

\n

Method

\n

GET

\n

URL

\n

https://telcomw.com/api-v2/text

\n

Query Parameters

\n\n

Example Request

\n
GET https://telcomw.com/api-v2/text?message=Hello&phone=1234567890&api_key=your_api_key&password=your_password&from=YourName\n\n

Response

\n

Structure

\n

The response will be in JSON format and will include the following fields:

\n\n

Example Response

\n
{\n  \"type\": \"\",\n  \"msg\": \"\",\n  \"code\": \"\",\n  \"feedback\": [\n    {\n      \"status\": 0,\n      \"cost\": 0,\n      \"msdn\": \"\",\n      \"chars\": 0,\n      \"code\": 0,\n      \"id\": \"\"\n    }\n  ]\n}\n\n
\n

Response Fields

\n\n

Notes

\n\n","urlObject":{"protocol":"https","path":["api-v2","text"],"host":["telcomw","com"],"query":[{"key":"message","value":""},{"key":"phone","value":""},{"key":"api_key","value":""},{"key":"password","value":""},{"key":"from","value":""}],"variable":[]}},"response":[{"id":"f97650f4-e48b-448f-93be-6a4940038248","name":"Response","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"text","value":"Text message","type":"text"},{"key":"numbers","value":"0884113450","type":"text"},{"key":"from","value":"WGIT","type":"text"}]},"url":{"raw":"https://telcomw.com/api-v2/text?message=&phone=&api_key=&password=&from=","protocol":"https","host":["telcomw","com"],"path":["api-v2","text"],"query":[{"key":"message","value":""},{"key":"phone","value":""},{"key":"api_key","value":""},{"key":"password","value":""},{"key":"from","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 09 Apr 2023 09:24:18 GMT"},{"key":"Server","value":"Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.1.12"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"Content-Length","value":"144"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"success\",\n \"msg\": \"send\",\n \"code\": \"200\",\n \"feedback\": [\n {\n \"status\": 2,\n \"cost\": 18,\n \"msdn\": \"265884113450\",\n \"chars\": 12,\n \"code\": 200,\n \"id\": \"ke4wz6fydbtj\"\n }\n ]\n}"}],"_postman_id":"acdb79c0-bbcb-4d59-a1f1-b646ede1f27b"},{"name":"SMS Balance","id":"7b8eeee4-6683-4171-af74-f6b7bcd2bbfb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"api_key","value":"","type":"text"},{"key":"password","value":"","type":"text"}]},"url":"https://telcomw.com/api-v2/balance","description":"

Check Balance

\n

Method

\n

POST

\n

Endpoint

\n

https://telcomw.com/api-v2/balance

\n

Description

\n

This endpoint allows users to check their account balance by providing their API key and password.

\n

Request Parameters

\n

The request body must be sent as form-data and includes the following parameters:

\n\n","urlObject":{"protocol":"https","path":["api-v2","balance"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7b8eeee4-6683-4171-af74-f6b7bcd2bbfb"},{"name":"Extended SMS","id":"c68d8adf-dc19-4846-a664-27bb27006ebb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"from","value":"WGIT","type":"text"},{"key":"api_key","value":"api_key","type":"text"},{"key":"password","value":"password","type":"text"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"message\": \"Hello\",\r\n \"phone\": \"265992026866\"\r\n },\r\n {\r\n \"message\": \"Hello 2\",\r\n \"phone\": \"265884113450\"\r\n }\r\n]","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/extended/send","description":"

Send Message

\n

Method: POST
URL: https://telcomw.com/api-v2/extended/send

\n

Description

\n

This endpoint is used to send a message to a specified phone number. The request requires a JSON payload containing the message content and the recipient's phone number.

\n

Request Parameters

\n

The request body should be a JSON array containing an object with the following parameters:

\n\n

Example Request Body

\n
[{\"message\":\"Hello\",\"phone\":\"265992026866\"}]\n\n
\n

Response Structure

\n

Upon a successful request, the API will return a JSON object containing the following fields:

\n\n

Example Response

\n
{\n  \"type\": \"success\",\n  \"msg\": \"\",\n  \"code\": \"\",\n  \"advance\": \"\",\n  \"feedback\": [\n    {\n      \"status\": 2,\n      \"cost\": 0,\n      \"msdn\": \"\",\n      \"chars\": 0,\n      \"code\": 0,\n      \"id\": \"\"\n    }\n  ]\n}\n\n
\n

Notes

\n\n","urlObject":{"protocol":"https","path":["api-v2","extended","send"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"b71fc112-0fca-4060-9e81-95a158d119d1","name":"Success Sample","originalRequest":{"method":"POST","header":[{"key":"from","value":"WGIT","type":"text"},{"key":"api_key","value":"api_key","type":"text"},{"key":"password","value":"password","type":"text"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"message\": \"Hello\",\r\n \"phone\": \"265992026866\"\r\n },\r\n {\r\n \"message\": \"Hello 2\",\r\n \"phone\": \"265884113450\"\r\n }\r\n]","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/extended/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 14 Feb 2025 16:24:11 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=P4n9%2FeMxwHKrNM%2FccOuK3w%2B8q3xBYznmVH8XXPWr7A1O7eGRHP967l%2BLnkpY33pdlIBtPfP0RA%2BdS7ukqpSXtPadBhiOAdoXngfn0ShXKe%2F%2BgPhi%2Fc7iQwH87kqsXQ%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"911e68244bfad6b3-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=1861&min_rtt=1798&rtt_var=720&sent=3&recv=5&lost=0&retrans=0&sent_bytes=219&recv_bytes=1320&delivery_rate=805339&cwnd=250&unsent_bytes=0&cid=f73b4534cb821c65&ts=1937&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"success\",\n \"msg\": \"send\",\n \"code\": \"200\",\n \"advance\": \"1\",\n \"feedback\": [\n {\n \"status\": 2,\n \"cost\": 20,\n \"msdn\": \"265992026866\",\n \"chars\": 5,\n \"code\": 200,\n \"id\": \"nexp7hdwhmfu\"\n },\n {\n \"status\": 2,\n \"cost\": 20,\n \"msdn\": \"265884113450\",\n \"chars\": 7,\n \"code\": 200,\n \"id\": \"iqenjjepnum5\"\n }\n ]\n}"}],"_postman_id":"c68d8adf-dc19-4846-a664-27bb27006ebb"}],"id":"ea986423-cd5f-4bbc-86d7-2a5ff0ea69ee","_postman_id":"ea986423-cd5f-4bbc-86d7-2a5ff0ea69ee","description":""},{"name":"USSD/BOT Services","item":[{"name":"Ussd Request","id":"ccbd48ce-7ad7-4c64-9c9f-6eae5a154318","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"body\": \"text of the request\",\r\n \"sessionid\": \"session id\",\r\n \"msisdn\": \"phone_number_with_country_code_without_plus\",\r\n \"key\":\"security_key_known_by_our_server_and_your_server\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{your_server_end_point}}","urlObject":{"host":["{{your_server_end_point}}"],"query":[],"variable":[]}},"response":[{"id":"2c70815b-e03b-4d4b-8f94-16d7dc759372","name":"Ussd Request Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"body\": \"text of the request\",\r\n \"sessionid\": \"session id\",\r\n \"msisdn\": \"phone_number_with_country_code_without_pus\",\r\n \"key\":\"security_key_known_our_server_and_your_server\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{your_server_end_point}}"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"msisdn\": \"phone_number_in_session\",\r\n \"sessionid\": \"session_id_in_session\",\r\n \"type\": \"1_or_2\",\r\n \"body\": \"Message to be \\ndisplayed on user\\n screen\",\r\n}\r\n"}],"_postman_id":"ccbd48ce-7ad7-4c64-9c9f-6eae5a154318"},{"name":"Send Wa Text","id":"4b62c740-00b6-4397-a05c-da190a8d6513","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"appid","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"phone\":\"+265992026866\",\r\n \"message\":\"Boss?\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/v1.wa.text","urlObject":{"protocol":"https","path":["api-v2","v1.wa.text"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"8297acca-2e53-4133-8789-3ca63bab4ff6","name":"Send Wa Text","originalRequest":{"method":"POST","header":[{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"appid","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"phone\":\"+265992026866\",\r\n \"message\":\"Boss?\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/v1.wa.text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 26 May 2023 07:54:04 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=kPAcTBPd0FtUJlQNspD0pDiTO4e%2F86O2uQDBWVykDNEMvnkvtIv4n5L%2BIYt4KER7%2F%2BMtb3ajtdInZMdilDq%2BnXPexB6nGpM74SqtFcX%2FUDnU%2F97RKBvV0DXt0e5hqA%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7cd472a7fbcf0562-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 200,\n \"message\": \"Your message was sent successfully!\",\n \"ref\": null\n}"}],"_postman_id":"4b62c740-00b6-4397-a05c-da190a8d6513"}],"id":"1e52be79-0ebc-4003-8912-5ad32bb5d860","_postman_id":"1e52be79-0ebc-4003-8912-5ad32bb5d860","description":""},{"name":"OTP General","item":[{"name":"Generate OTP","id":"b759db50-b70b-4c5e-aa8b-e88b8fbb1b0b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"length","value":"5","type":"text"},{"key":"expire","value":"4","type":"text"},{"key":"for","value":"+265992026866","type":"text"},{"key":"name","value":"SMS DELIVERY API","type":"text"}],"body":{"mode":"raw","raw":""},"url":"https://telcomw.com/api-v2/v1.generate_otp","urlObject":{"protocol":"https","path":["api-v2","v1.generate_otp"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"a5d8c0f0-cd2f-4184-91d1-0294b5cd5cfa","name":"Generate OTP","originalRequest":{"method":"POST","header":[{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"},{"key":"length","value":"5","type":"text"},{"key":"expire","value":"4","type":"text"},{"key":"for","value":"+265992026866","type":"text"},{"key":"name","value":"SMS DELIVERY API","type":"text"},{"key":"alphameric","value":"true","type":"text","disabled":true}],"body":{"mode":"raw","raw":""},"url":"https://telcomw.com/api-v2/v1.generate_otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 24 May 2023 12:33:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=yQUEAevAmgq1qVWNb%2B4zGij3AHra4DEmxPpGkrBNA8gifpj3xDpNt7De7sg6T1dlbkQJ%2B3ng%2F5lCF39EGlyVKSOg%2FE0USS1ky4OkDwlOuVXULiaHjebjVJEjADJZJQ%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7cc591b15cba9d09-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 200,\n \"message\": \"Your OTP was generated and sent successfully!\",\n \"ref\": 230955,\n \"expire\": \"4-mins\",\n \"org\": \"SMS DELIVERY API\"\n}"}],"_postman_id":"b759db50-b70b-4c5e-aa8b-e88b8fbb1b0b"},{"name":"Verify Generated OTP","id":"c3d0ab26-8f3a-4c3d-826c-b174f0ea45eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"code","value":"20698","type":"text"},{"key":"ref","value":"103495","type":"text"},{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://telcomw.com/api-v2/v1.verify_otp","urlObject":{"protocol":"https","path":["api-v2","v1.verify_otp"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"4ff8d882-0699-4bb6-91a7-ce045f413211","name":"Verify Generated OTP","originalRequest":{"method":"POST","header":[{"key":"code","value":"92187","type":"text"},{"key":"ref","value":"460940","type":"text"},{"key":"key","value":"","type":"text"},{"key":"password","value":"","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://telcomw.com/api-v2/v1.verify_otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 24 May 2023 13:27:05 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/8.1.12"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=j%2BkXq3O35CcmwHgFyz9Q7nOZFhD3Nn1pqYe3D57qdSF%2BTir6IHON74AnRGrVA9foWz8bjcdRwtHVIPZcQYTiJdYsECWeaFAD0Tgd%2Bb7OvOfPM2MFFX4jvv%2FS3P5aXw%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7cc5dfc30f519e86-JNB"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 200,\n \"message\": \"OTP successfully verified\",\n \"feedback\": {\n \"otp_code\": \"92187\",\n \"otp_ref\": \"460940\",\n \"otp_status\": true,\n \"otp_msisdn\": \"+265992026866\",\n \"otp_elapse\": 4\n }\n}"}],"_postman_id":"c3d0ab26-8f3a-4c3d-826c-b174f0ea45eb"}],"id":"d5d8e857-a61c-4994-8dfd-363dc20b6355","_postman_id":"d5d8e857-a61c-4994-8dfd-363dc20b6355","description":""},{"name":"Payments - v1.1","item":[{"name":"Request USSD Push","id":"f3a5a3e7-2a82-4b6f-b0d1-16904ac4a458","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\":35,\r\n \"ipn\":\"https://telcomw.com/test.php\",\r\n \"phone\":\"0992026866\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/payments/request","urlObject":{"protocol":"https","path":["api-v2","payments","request"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"f68bc3f7-fa88-4087-bf0f-1253f4817e03","name":"Request Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\":35,\r\n \"ipn\":\"https://telcomw.com/test.php\",\r\n \"phone\":\"0992026866\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/payments/request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 28 Sep 2024 12:36:03 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=dVj4rpvw2YPB4jZitxU8%2B%2FEftFy4ip9d6Bhb4LzogPX6yUWmZ2fUG4qOX6cuHEujl3BN1wvKDYEZmzHUDRBQ1LiB70wyoLgnF7N1SguwlO%2BM5cRksuR6MsQbpHBzbw%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8ca3c6081f1595ff-JNB"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 200,\n \"message\": \"Request Accepted\",\n \"feedback\": {\n \"status\": 1,\n \"reference\": \"TELC90042O\",\n \"amount\": 35,\n \"formatted\": \"MWK35.00\",\n \"provider\": \"airtel Money\",\n \"phone\": \"0992026866\"\n }\n}"}],"_postman_id":"f3a5a3e7-2a82-4b6f-b0d1-16904ac4a458"},{"name":"Check charge","id":"2f6131ba-e8ef-49be-8ae3-abc00b2e1add","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\":35\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/payments/charges","urlObject":{"protocol":"https","path":["api-v2","payments","charges"],"host":["telcomw","com"],"query":[],"variable":[]}},"response":[{"id":"6da42f7e-e768-4c5a-8266-fc6e5fb263a7","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\":35\r\n}","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/payments/charges"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 29 Sep 2024 11:15:55 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=SaBDLeRpadeb%2FrMglvOm55VMmsryCffow95kXINRN6X8RfCHA8V5BlJ%2BLRAX0NjMeszvwQZXqTBeyOFS61O8dYYUPKhtqPEHF%2Fi34AjwxBge5SRHQL2TBxppsDfX2w%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8cab8edcec8db575-WDH"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 200,\n \"message\": \"Request Accepted\",\n \"feedback\": {\n \"amount\": 35,\n \"amount_formatted\": \"MWK35\",\n \"charge\": 0.35,\n \"charge_formatted\": \"MWK0.35\",\n \"payable\": 34.65,\n \"commission\": 1,\n \"withdraw\": {\n \"fee\": 100,\n \"payment\": 135,\n \"auth\": \"F2607DCD8D32F5AC717F5BBA2689FF75\"\n }\n }\n}"}],"_postman_id":"2f6131ba-e8ef-49be-8ae3-abc00b2e1add"},{"name":"Payment Status","id":"ac0c258d-00ad-4051-9489-d415dcedba42","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://telcomw.com/api-v2/payments/status?ref=1234567","urlObject":{"protocol":"https","path":["api-v2","payments","status"],"host":["telcomw","com"],"query":[{"key":"ref","value":"1234567"}],"variable":[]}},"response":[],"_postman_id":"ac0c258d-00ad-4051-9489-d415dcedba42"},{"name":"Callback","id":"4d00370a-9ab7-41d3-8e76-dcfd7f7cb4ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{your_server_end_point}}","description":"

StartFragment

\n

Payment API Documentation

\n

Overview

\n

This API provides payment processing services supporting both mobile wallet payments and Visa card payments. The API handles payment requests, status checks, updates, and account management operations.

\n

Base URL

\n

The API base URL is available in https://telcomw.com under your transactions

\n

Authentication

\n

All endpoints require authentication via AUTHORIZATION Bearer Token which is your TelcoMW API key

\n

headers:

\n
    \n
  • Authorization Bearer: User identifier
    • \n
\n

Supported Operations

\n
\n

1. Payment Processing

\n

Endpoint: POST /payments/receive

\n

Initiates a payment request for either mobile wallet or Visa card transactions.

\n

Required Fields:

\n
    \n

  • reference - Unique transaction reference (7-20 characters)

    \n
    • \n

  • description - Payment description

    \n
    • \n

  • amount - Payment amount (minimum MWK 50, maximum MWK 750,000)

    \n
    • \n

  • channel - Payment method (\"wallet\" for mobile payments, other values for Visa)

    \n
    • \n

  • ipn - Callback URL for payment notifications (max 100 characters, must be valid URL)

    \n
    • \n
\n

Additional Requirements for Mobile Wallet (channel: \"wallet\"):

\n
    \n
  • subscriber - Phone number (9-13 digits, numbers only)
    • \n
\n

Response:

\n
    \n

  • Success: Payment request accepted with operator information

    \n
    • \n

  • Error: Validation errors or service failures

    \n
    • \n
\n

Special Cases:

\n
    \n

  • Duplicate transaction references are rejected

    \n
    • \n

  • Invalid phone numbers for wallet payments are rejected

    \n
    • \n

  • IPN URL must be accessible for payment notifications

    \n
    • \n
\n
\n

2. Payment Status Check

\n

Endpoint: GET /payments/receive/{reference}

\n

Retrieves the current status of a payment transaction.

\n

URL Parameters:

\n
    \n
  • reference - The transaction reference to check
    • \n
\n

Response:

\n
    \n

  • Success: Current payment status and transaction details

    \n
    • \n

  • Error: Invalid reference or service unavailable

    \n
    • \n
\n

Use Case: Check if a payment has been completed, failed, or is still pending.

\n
\n

3. Payment Update

\n

Endpoint: GET /payments/update/{reference}

\n

Forces an update/refresh of payment status from the payment provider.

\n

URL Parameters:

\n
    \n
  • reference - The transaction reference to update
    • \n
\n

Response:

\n
    \n

  • Success: Updated payment status and transaction details

    \n
    • \n

  • Error: Invalid reference or service unavailable

    \n
    • \n
\n

Use Case: Manually trigger a status refresh when automatic updates may be delayed.

\n
\n

Response Format

\n

All API responses follow a consistent structure:

\n
    \n

  • message - Human-readable status message

    \n
    • \n

  • feedback - Object containing relevant data/details

    \n
    • \n

  • status - Response status (\"success\", \"error\", \"info\")

    \n
    • \n
\n

Error Handling

\n

HTTP Status Codes:

\n
    \n

  • 200 - Success

    \n
    • \n

  • 400 - Bad Request (validation errors)

    \n
    • \n

  • 404 - Endpoint not found

    \n
    • \n

  • 500 - Internal server error

    \n
    • \n
\n

Common Validation Errors:

\n
    \n

  • Missing required fields

    \n
    • \n

  • Invalid amount ranges

    \n
    • \n

  • Invalid phone number formats

    \n
    • \n

  • Invalid URL formats for IPN

    \n
    • \n

  • Reference length restrictions

    \n
    • \n

  • Duplicate transaction references

    \n
    • \n
\n

Payment Channels

\n

Mobile Wallet (channel: \"wallet\"):

\n
    \n

  • Requires valid subscriber phone number

    \n
    • \n

  • Supports local mobile money providers

    \n
    • \n

  • Real-time payment processing

    \n
    • \n
\n

Visa Payments (other channel values):

\n
    \n

  • Credit/debit card processing

    \n
    • \n

  • International payment support

    \n
    • \n

  • Secure card data handling

    \n
    • \n
\n

Important Notes

\n
    \n

  • All amounts are in Malawian Kwacha (MWK)

    \n
    • \n

  • Transaction references must be unique across all payments

    \n
    • \n

  • IPN URLs must be publicly accessible for payment notifications

    \n
    • \n

  • Phone numbers for wallet payments must be valid local numbers

    \n
    • \n

  • Payment status may take time to reflect due to provider processing delays

    \n
    • \n
\n

Rate Limits

\n

Standard rate limiting applies to prevent abuse. Contact support for specific limits and enterprise options.

\n

Support

\n

For technical support, integration assistance, or account issues, contact the API support team.

\n

EndFragment

\n","urlObject":{"host":["{{your_server_end_point}}"],"query":[],"variable":[]}},"response":[{"id":"799d9cf6-cf83-41d6-9540-814b72273099","name":"Callback","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"bank_reference\": \"MP240122.2126.H12832\",\r\n \"status\": \"success\",\r\n \"when\": 1695925608,\r\n \"telco_reference\": \"C978577HG53757DGDHS85TE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{your_server_end_point}}"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"bank_reference\": \"MP240122.2126.H12832\",\r\n \"status\": \"success\",\r\n \"when\": 1695925608,\r\n \"telco_reference\": \"C978577HG53757DGDHS85TE\"\r\n}"}],"_postman_id":"4d00370a-9ab7-41d3-8e76-dcfd7f7cb4ae"}],"id":"7d24ed03-7027-437b-a840-4d161ee1fdd6","_postman_id":"7d24ed03-7027-437b-a840-4d161ee1fdd6","description":""},{"name":"Payments - v1.2","item":[{"name":"Receive","id":"88b83f9f-6dda-45aa-ac7c-787d4a165166","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"RE920369746454\",\r\n \"description\": \"Some Items\",\r\n \"amount\": 50,\r\n \"subscriber\": \"0992026866\",\r\n \"channel\": \"wallet\",\r\n \"ipn\":\"https://yourdomain.com/notifications\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{domain}}/payments/receive","urlObject":{"path":["payments","receive"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"f08ba655-22ec-4b76-b83b-278de951bbdb","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"RE320369746450\",\r\n \"description\": \"Some Items\",\r\n \"amount\": 50,\r\n \"subscriber\": \"0992026866\",\r\n \"channel\": \"wallet\",\r\n \"ipn\": \"https://yourdomain.com/notifications\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{domain}}/payments/receive"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"etag","value":"W/\"9d-QEjKUKlbqIRdhlf2MWEULMJ4a+4\""},{"key":"content-length","value":"157"},{"key":"date","value":"Mon, 21 Apr 2025 05:46:17 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Service request accepted\",\n \"feedback\": {\n \"subscriber\": \"0992026866\",\n \"reference\": \"RE320369746450\",\n \"amount\": 50,\n \"operator\": \"airtel\"\n },\n \"status\": \"success\"\n}"}],"_postman_id":"88b83f9f-6dda-45aa-ac7c-787d4a165166"},{"name":"Callback Request","id":"4488f706-fe4d-4856-8914-72754c1aecff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"third_party_ref\": \"MP250421.0805.I11741\",\r\n \"payment_our_ref\": \"RE920359756404\",\r\n \"payment_status\": \"PD\",\r\n \"payment_comment\": \"SUCCESSFUL\",\r\n \"payment_ipn\": \"https://telcomw.com/notifications.php\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{your-domain-com/ipn}}","description":"

API Endpoint Documentation

\n

Endpoint

\n

GET {{your-domain-com/ipn}}

\n

Method

\n

GET

\n

Description

\n

This endpoint is used to send payment notification to your server after payment has been made. It provides information regarding the status of the payment, including references and comments related to the transaction.

\n

Request Parameters

\n

The request body for this endpoint includes the following parameters:

\n
    \n

  • third_party_ref (string): A reference identifier provided by the third-party payment processor for tracking the transaction.

    \n
    • \n

  • payment_our_ref (string): Your internal reference for the payment, allowing you to correlate the payment with your records.

    \n
    • \n

  • payment_status (string): The status of the payment (e.g., \"PD\" for paid).

    \n
    • \n

  • payment_comment (string): A comment regarding the payment status, typically indicating success or failure.

    \n
    • \n

  • payment_ipn (string): A URL that provides additional information or a callback related to the payment notification.

    \n
    • \n
\n

Expected Response Structure

\n

The expected response for a successful request is typically a confirmation message indicating that the payment processed either successfuly or not. The exact structure of the response may vary based on the implementation but generally includes:

\n
    \n

  • status (string): Indicates whether the processing of the notification was successful.

    \n
    • \n

  • message (string): Provides additional details or confirmation regarding the processing of the payment notification.

    \n
    • \n
\n

This endpoint is crucial for ensuring that your system is updated with the latest payment statuses.

\n

The Endpoint does not expect any response or process anything back to our server

\n","urlObject":{"host":["{{your-domain-com/ipn}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4488f706-fe4d-4856-8914-72754c1aecff"},{"name":"Receiving Status","id":"eeb55c30-e9fe-4e85-825b-af9718ccdb95","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{domain}}/payments/receive/RE17482494250458921","description":"

GET /payments/receive/{reference}

\n

This endpoint is used to retrieve the payment status for a specific transaction identified by the reference parameter.

\n

Request Method

\n
    \n
  • GET
    • \n
\n

Endpoint

\n
    \n
  • {{domain}}/payments/receive/{reference}
    • \n
\n

Path Parameters

\n
    \n
  • reference (string): A unique identifier for the payment transaction. In this case, it is represented as RE17482494250458921.
    • \n
\n

Expected Response Format

\n

The response will be in JSON format and will include the following structure:

\n
{\n  \"message\": \"\",\n  \"feedback\": {\n    \"reference\": \"\",\n    \"status\": true,\n    \"message\": \"\",\n    \"operator\": \"\",\n    \"third_party_reference\": null,\n    \"payment_status\": \"\",\n    \"payment_comment\": \"\",\n    \"payment_ipn\": \"\"\n  },\n  \"status\": \"\"\n}\n\n
\n

Response Fields

\n
    \n

  • message: A string that may contain additional information about the request.

    \n
    • \n

  • feedback: An object containing details about the payment:

    \n
      \n

    • reference: The reference ID of the payment transaction.

      \n
      • \n

    • status: A boolean indicating the success of the request.

      \n
      • \n

    • message: A string that may contain a message related to the payment.

      \n
      • \n

    • operator: A string indicating the payment operator.

      \n
      • \n

    • third_party_reference: A nullable field for any third-party reference associated with the payment.

      \n
      • \n

    • payment_status: A string indicating the status of the payment.

      \n
      • \n

    • payment_comment: A string for any comments related to the payment.

      \n
      • \n

    • payment_ipn: A string that may contain information related to the payment's IPN (Instant Payment Notification).

      \n
      • \n
    \n
    • \n

  • status: A string indicating the overall status of the request.

    \n
    • \n
\n

This endpoint allows users to efficiently check the status of their payments using the unique transaction reference.

\n","urlObject":{"path":["payments","receive","RE17482494250458921"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"25cec076-e9c2-4719-ae21-714deea82f0e","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{domain}}/payments/receive/RE17482494250458921"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"etag","value":"W/\"13a-KcQ85mokqSD3M6ELelCfwH/hSik\""},{"key":"content-length","value":"314"},{"key":"date","value":"Thu, 29 May 2025 11:19:46 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Service request accepted\",\n \"feedback\": {\n \"reference\": \"RE17482494250458921\",\n \"status\": true,\n \"message\": \"Payment status Accessed\",\n \"operator\": \"airtel\",\n \"third_party_reference\": null,\n \"payment_status\": \"RQD\",\n \"payment_comment\": \"WAITING_ACTION\",\n \"payment_ipn\": \"https://yourdomain.com/notifications\"\n },\n \"status\": \"success\"\n}"}],"_postman_id":"eeb55c30-e9fe-4e85-825b-af9718ccdb95"},{"name":"Receive Update Status","id":"4552c3e9-6d98-4bcd-b0c9-15930e47dec4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{domain}}/payments/update/RE1748204068886599","description":"

Endpoint Description

\n

This endpoint is used to request our systems to refresh the transaction status for a specific payment. The transaction status is sent back to the user via the IPN (Instant Payment Notification) that was supplied during the initial payment request. This functionality is particularly useful in scenarios where the systems may have missed the initial payment callback.

\n

Request

\n
    \n

  • Method: GET

    \n
    • \n

  • URL: {{domain}}/payments/update/{transaction_id}

    \n
      \n

    • Path Parameter:

      \n
        \n
      • transaction_id: The unique identifier for the transaction that needs to be updated.
        • \n
      \n
      • \n
    \n
    • \n
\n

Response

\n

The response will contain the following fields:

\n
    \n

  • message: A string that may contain additional information about the request.

    \n
    • \n

  • feedback: An object that includes:

    \n
      \n

    • reference: A reference identifier related to the transaction.

      \n
      • \n

    • message: A string that may provide further details.

      \n
      • \n

    • operator: Information about the payment operator.

      \n
      • \n

    • narration: A narrative description of the transaction.

      \n
      • \n

    • payment_ipn: The IPN related to the payment.

      \n
      • \n
    \n
    • \n

  • status: A string indicating the acceptance of the request, this is not payment status but request status.

    \n
    • \n
\n

This endpoint is essential for ensuring that users receive the most up-to-date information regarding their payment transactions.

\n","urlObject":{"path":["payments","update","RE1748204068886599"],"host":["{{domain}}"],"query":[],"variable":[]}},"response":[{"id":"ce0371f3-68b3-45cb-937d-4d0e6db3223a","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"RE920369746454\",\r\n \"description\": \"Some Items\",\r\n \"amount\": 50,\r\n \"subscriber\": \"0992026866\",\r\n \"channel\": \"wallet\",\r\n \"ipn\":\"https://yourdomain.com/notifications\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{domain}payments/update/RE17481522190173324"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"keep-alive","value":"timeout=5, max=100"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"etag","value":"W/\"141-M5GXbAxHXlVM2dxv8EpOgWrg+vw\""},{"key":"content-length","value":"321"},{"key":"date","value":"Thu, 29 May 2025 12:20:55 GMT"},{"key":"server","value":"LiteSpeed"},{"key":"x-turbo-charged-by","value":"LiteSpeed"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Service request accepted\",\n \"feedback\": {\n \"reference\": \"RE17481522190173324\",\n \"message\": \"A request to check transaction status has been sent\",\n \"operator\": \"airtel\",\n \"narration\": \"You'll receive a callback notification through your call back url\",\n \"payment_ipn\": \"https://yourdomain.com/notifications\"\n },\n \"status\": \"success\"\n}"}],"_postman_id":"4552c3e9-6d98-4bcd-b0c9-15930e47dec4"}],"id":"cf557ff3-7868-418c-b390-09bb4fa01973","_postman_id":"cf557ff3-7868-418c-b390-09bb4fa01973","description":""}]}