{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"2a87eb16-44db-4229-8208-d8f56c867425","name":"UIC PoT Cloud Service - Integration Partner API v1.0","description":"# Overview\n\nUIC PoT Cloud Service provides cloud-based integration APIs for UIC software partners to create cloud-to-cloud transaction features along with UIC PoT Card-Present payment for a complete payment solution\n\n- **Use Case - Transaction Adjustment**\n    - **Retail Environment**\n        - **Sale** - Performed By UIC PoT Card-Present payment\n            \n        - **Void/Refund** - Performed By UIC PoT Cloud-based APIs\n            \n    - **Vending/Charging/Restaurant Environment**\n        - **AuthOnly** - Performed By UIC PoT Card-Present payment\n            \n        - **Void/AuthCapture** - Performed By UIC PoT Cloud-based APIs\n            \n\n# Workflow\n\n<img src=\"https://lh3.googleusercontent.com/6l_h2DJDXQ-b0hr7YRGH34MTyXJOyikI2-BkVzx1XjrzjchD0pTXpK5BGlUqytaoo9kT7gooZdykN_H6X9ChjYRC7cl6VOce8C9qac_-L5db_xspUlN1PdwiIctOfmodPZxBAnOR=w2400\">\n\n1. Host requests Card-Present Transaction to UIC PoT device (Please refer to UIC PoT Semi-Integration API)\n    \n2. UIC PoT device authorizes with payment processors\n    \n3. UIC PoT device responds transaction result to host\n    \n4. UIC PoT device uploads essential data to UIC PoT Cloud\n    \n5. Host uploads essential data to host cloud backend\n    \n6. Host cloud backend requests cloud-based transaction to UIC PoT Cloud\n    \n7. UIC PoT Cloud authorizes with payment processors\n    \n8. UIC PoT Cloud responds cloud-based transaction results to host cloud backend\n    \n\n# Environment\n\n- **UIC PoT Cloud Service Developer Server**\n    - **Host**: devcloud.uicusa.com\n        \n    - **Protocol**: HTTPS (Port 443)\n        \n    - **Method**: POST\n        \n    - **Authentication**:\n        - Basic Auth - Please contact UIC support for account info (Username/Password)\n            \n        - API Key Auth\n            \n        - User-Agent - \\[SwPartnerID\\]|\\[SwPartnerName\\]\n            \n    - **Data Format**: JSON\n        \n    - **Data Validation**: Message Signature\n        \n    - **Payment Processor**\n        - Global Payment/Heartland Portico\n            \n        - WorldPay Vantiv Core 610\n            \n        - Fiserv FirstData RapidConnect\n            \n\n# API Prerequisites\n\n- **HTTP Authentication Header**\n    - **Basic Auth** - Username/Password - Please contact UIC support for account info\n        \n    - **API Key Auth** - Request API Key by GetApiKey and UpdateApiKey APIs (API Key expires every 30 days)\n        \n- **UIC PoT (Card-Present payment device) Info**\n    - **UIC PoT device serial number**\n        \n    - **UIC PoT device payment processor credentials**\n        - Global Payment/Heartland Portico - License ID/Site ID/Device ID\n            \n        - WorldPay Vantiv Core 610 - Merchant ID/Terminal ID\n            \n        - Fiserv FirstData RapidConnect - Merchant ID/Terminal ID\n            \n- **Original Card-Present Transaction Info**\n    - **Transaction Adjustment APIs**\n        - Transaction ID \\[TxnId\\]\n            \n        - Transaction Amount \\[TxnAmt\\]\n            \n\n# APIs\n\n- **API Key Request**\n    - Get API Key\n        \n    - Update API Key\n        \n- **Transaction Adjustment Request**\n    - Void\n        \n    - AuthCapture\n        \n    - Refund","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"48004383","team":9796596,"collectionId":"2a87eb16-44db-4229-8208-d8f56c867425","publishedId":"2sB3HjM1gc","public":true,"publicUrl":"https://developer.uicusa.com","privateUrl":"https://go.postman.co/documentation/48004383-2a87eb16-44db-4229-8208-d8f56c867425","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"4C4CFF"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/f3f1487a-7c05-4f75-a461-1f1b4916b185/VUlDLWxvZ28ucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"4C4CFF"}},{"name":"light","logo":"https://content.pstmn.io/f3f1487a-7c05-4f75-a461-1f1b4916b185/VUlDLWxvZ28ucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"4C4CFF"}}]}},"version":"8.10.1","publishDate":"2025-09-02T23:32:38.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/f3f1487a-7c05-4f75-a461-1f1b4916b185/VUlDLWxvZ28ucG5n","logoDark":"https://content.pstmn.io/f3f1487a-7c05-4f75-a461-1f1b4916b185/VUlDLWxvZ28ucG5n"}},"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/847d00b84c6785c057026030be3f848ce143461f49629597c9ae692aaf03b57c","favicon":"https://uicusa.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://developer.uicusa.com/view/metadata/2sB3HjM1gc"}