{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"e7db0264-1938-4b00-8753-9ef626c9782c","name":"Contomobile Payment Cloud API Documentation","description":"Contomobile Payment Cloud is a solution designed for payment institutions to execute transfers of their customers.\n\n## **Getting started guide**\n\nTo start using Contomobile Payment Cloud, you need to contact support ([support@contomobile.com](https://mailto:support@contomobile.com)) to get access to the Sandbox/Production environment. You need to provide IP addresses from which API requests will be made.\n\n- You must use a valid Client ID+Secret to send requests to the API endpoints.\n    \n- The API only responds to HTTPS-secured communications.\n    \n- The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.\n    \n\n## Authentication\n\nContomobile Payment Cloud API uses `X-Client-Id` and `X-Client-Secret` HTTP headers for authentication. You must include these headers in each request to Contomobile Payment Cloud API.\n\nAccess to the API is restricted by a list of IP addresses, because of that you need to provide IP addresses from which API requests will be made.\n\n### Authentication error response\n\nIf `X-Client-Id` and/or `X-Client-Secret` HTTP headers is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.\n\n## Rate and usage limits\n\nAPI requests are not limited.\n\n## HTTP response body\n\nIf the API responds with HTTP status code `200`, it will contain the HTTP response body in JSON format. The JSON response is normalized - each response will have `data` and `status` JSON keys.\n\nThe value of `data` JSON key may be `null` if the API returns nothing, otherwise it will be an JSON Object or JSON Array (read APIs description).\n\nThe `status` JSON key is always an JSON Object of following structure:\n\n| **JSON key** | **Data type** | **Description** |\n| --- | --- | --- |\n| correlationId | String | Unique identifier of the request |\n| success | Boolean | Request status. Possible values:  <br>`true` – the request has been successfully processed and executed;  <br>`false` – execution error identified during request processing; |\n| statusCode | Number | Status code for WEB request. |\n| messages | Array | Array of error message. |\n| messages\\[\\].code | String | Error code identifying the cause of the error. |\n| messages\\[\\].priority | String | Priority of the message: `ERROR`, `WARNING` or `INFO`. |\n| messages\\[\\].title | String | Message title. |\n| messages\\[\\].description | String | Message description. |\n| messages\\[\\].field | String | Reference to the field (JSON path) if the message related to the input field. |\n\n## HTTP response (status) codes\n\n### 200\n\nAn HTTP `200` response from our servers indicates that your request was processed in our side but it does not mean that everything is OK - you need to check a value in `status.isSuccess` JSON key from the response body: if the value is `true` then everything is OK, otherwise you will get an array of errors in the `status.messages` JSON key.\n\n### 401\n\nAn HTTP `401` response from our servers indicates that `X-Client-Id` and/or `X-Client-Secret` HTTP headers is missing, malformed, or invalid in your request.\n\n### 500\n\nAn HTTP `500` response from our servers indicates that your request was not processed in our side and you should check and correct your request.\n\n### 503\n\nAn HTTP `503` response from our servers indicates there is an unexpected spike in API access traffic. The server is usually operational within the next five minutes. If the outage persists or you receive any other form of an HTTP `5XX` error, contact support ([support@contomobile.com](https://mailto:support@contomobile.com)).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"53482172","team":14540209,"collectionId":"e7db0264-1938-4b00-8753-9ef626c9782c","publishedId":"2sBXqNkdGu","public":true,"publicUrl":"https://apidoc-pmcl.contomobile.com","privateUrl":"https://go.postman.co/documentation/53482172-e7db0264-1938-4b00-8753-9ef626c9782c","customColor":{"top-bar":"7091F3","right-sidebar":"303030","highlight":"7091F3"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Official API documentation for Contomobile Payment Cloud. Integrate secure payment processing, transactions, and financial services using REST APIs."},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/f2fdf2ff-8f4a-4e64-80f3-2643975a036c/bG9nby1hbHRlcm5hdGl2ZS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"7091F3"}},{"name":"light","logo":"https://content.pstmn.io/f2fdf2ff-8f4a-4e64-80f3-2643975a036c/bG9nby1hbHRlcm5hdGl2ZS5wbmc=","colors":{"top-bar":"7091F3","right-sidebar":"303030","highlight":"7091F3"}}]}},"version":"8.10.1","publishDate":"2026-05-08T12:00:40.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"Official API documentation for Contomobile Payment Cloud. Integrate secure payment processing, transactions, and financial services using REST APIs."},"logos":{"logoLight":"https://content.pstmn.io/f2fdf2ff-8f4a-4e64-80f3-2643975a036c/bG9nby1hbHRlcm5hdGl2ZS5wbmc=","logoDark":"https://content.pstmn.io/f2fdf2ff-8f4a-4e64-80f3-2643975a036c/bG9nby1hbHRlcm5hdGl2ZS5wbmc="}},"statusCode":200},"environments":[],"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/aa097a75892099de48d2e7786282c509649670eaf4fd600c07ac01487daa53cd","favicon":"https://contomobile.com/favicon.ico"},"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"}],"canonicalUrl":"https://apidoc-pmcl.contomobile.com/view/metadata/2sBXqNkdGu"}