{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"3cf3e722-806f-4a49-b167-112120f2e910","name":"Telneting Developer API","description":"## Getting Started\n\nTo start using our API, follow these steps:\n\n1. Create an account on our testing environment at [sandbox.telneting.com](https://sandbox.telneting.com) for testing purposes.\n2. Additionally, create an account on our production environment at [telneting.com](https://telneting.com).\n3. Request developer access from our administrator before you can utilize our developer API.\n    \n\nAfter being granted developer access, you will need the following:\n\n- **Developer Token**: Generate a developer token by navigating to the \"Manage API Tokens\" section in your account settings.\n- **Secret Key**: Retrieve your secret key from your profile, which contains developer details.\n    \n\nYou are also required to provide a webhook URL during the integration process to facilitate extra confirmation of transactions.\n\n## Authentication Details\n\n- **API Token**: Use the developer token to authenticate your requests with our platform.\n- **Secret Key**: The secret key is used to sign our webhook calls to your website, ensuring protection against malicious webhook calls.\n    \n\nKeep your API token and secret key confidential and avoid sharing them with unauthorized parties.\n\n## Response Codes\n\nResponse codes are provided as `status_code` to indicate the status of your transaction. Here are some commonly encountered response codes:\n\n- **100 - Success**: Indicates a successful transaction.\n- **101 - Insufficient Balance**: Denotes insufficient balance on your Telneting account for the requested transaction.\n- **102 - Service Unavailable**: Indicates that we are unable to process the transaction due to unavailability of our service provider.\n- **103 - Below Minimum Amount**: Denotes that the provided amount (e.g., airtime/electricity) is below the accepted minimum amount.\n- **104 - Above Maximum Amount**: Indicates that the provided amount (e.g., airtime/electricity) exceeds the accepted maximum amount.\n- **105 - Duplicate**: Denotes that a similar transaction is still being processed and has not yet been completed.\n    \n\nPlease refer to the `status_code` field for more information on the transaction status.\n\n## Status Codes\n\nThe following status codes are used in our API:\n\n- **200**: The request was received and processed successfully. Refer to the `status_code` field for more information on the transaction.\n- **422**: Indicates a malformed input with some required fields missing.\n- **500**: Something went wrong on our end.\n    \n\n## Generating Transaction Reference\n\nYour transaction reference should follow this format:\n\nToday's date and current hour in 24 hour format - YYYYMMDDHH\n\nAppend a random string with mixed case letters and numbers, with a minimum of 8 characters.\n\nHere's an example:\n\n2023061316Ya2sWS3JW\n\nMake sure to replace `YYYYMMDDHH` with the current date and hour in the specified format. The random string should be a combination of uppercase and lowercase letters along with numbers, and it should be at least 8 characters long.\n\nPlease note that the transaction reference should be unique for each transaction to ensure proper tracking and identification.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"11673494","team":7981840,"collectionId":"3cf3e722-806f-4a49-b167-112120f2e910","publishedId":"2s8YmPs21W","public":true,"publicUrl":"https://documenter-api.postman.tech/view/11673494/2s8YmPs21W","privateUrl":"https://go.postman.co/documentation/11673494-3cf3e722-806f-4a49-b167-112120f2e910","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"1D43FE"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2022-11-17T21:10:51.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"Testing","id":"2d65044d-ad5c-44c7-9693-1e9e8bc08f78","owner":"11673494","values":[{"key":"base_url","value":"https://sandbox.telneting.com","enabled":true},{"key":"token","value":"FsWeLosaabS1YxyWgFkw3UWjvbDG7ET28LMNkn7Lda3f0797","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/b1314d981128c955969b49978811eb1c58594c1efd6ce8a19a159f7eb15716ab","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Testing","value":"11673494-2d65044d-ad5c-44c7-9693-1e9e8bc08f78"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s8YmPs21W"}