The UniPAY API V3 enables merchants to seamlessly integrate secure, flexible online payment processing into their applications. Whether handling one-off payments, subscriptions, or accepting multiple currencies the API provides clear, concise, JSON-based endpoints to launch your payments flow quickly.
\nThis document is intended to provide the partner with a comprehensive guide how to integrate UniPAY Checkout Solution for accepting payments from Visa, MasterCard and AMEX Cards, Appley Pay and Google PAY.
\n1. You need a verifyed Business Account - register here: https://business.unipay.com
\n2. Add Project into your Business Account.
\n3. Generate a Merchant ID and KEY for AUTH - to Get API keys you need to add a project into your dashboard. when business is fully verified you can get you production API keys for integration.
\nBusiness account verification is most important part. After registration please follow the verification steps into your unipay dashboard. You will be asked to provide company details and information about project
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"11978652","collectionId":"e019b1bd-695e-41d2-9553-ef9552fdca52","publishedId":"2sA35LUeco","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-04-04T13:58:05.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","event":[{"listen":"test","script":{"id":"eeba4f50-b58f-4852-901b-cb18080f11a5","exec":["pm.environment.set('access_token', pm.response.json().auth_token)"],"type":"text/javascript","packages":{}}}],"id":"748a6501-73e6-458c-b573-a38a0b9aa876","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchant_id\": \"5005003005161\",\r\n \"api_key\": \"a7bfa49e-56e6-4b48-8edb-d112370d3e45\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/auth","urlObject":{"path":["v3","auth"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[{"id":"7667c33a-7799-4e3e-a7c9-5e3a2f81a4ea","name":"Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchant_id\": \"5005003005161\",\r\n \"api_key\": \"a7bfa49e-56e6-4b48-8edb-d112370d3e45\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/auth"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 25 Aug 2025 20:17:23 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"281"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Charset","value":"utf-8"},{"key":"Server","value":"cloudflare"},{"key":"Content-Encoding","value":"br"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"key":"Vary","value":"accept-encoding"},{"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=d6Qb64riOL0yrbgrrhzyjvTaxsu3BuxxH5Rmf8fq%2BDIXFUhXybzJYEe206L49j5eJHihqfE5gvKpk98LW1lFjIMYnzCkNhsTHAoy6%2BfV5QQ%3D\"}]}"},{"key":"CF-RAY","value":"974dc5c85bde0a9b-TBS"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"auth_token\": \"SS8KHjxVQFJsvKVRdB8pJShMN4RAV68Rp8FGd8ZCXLowSPVmyo9YR6JrHlhnoSGoBjHbPWC9DAA6y5hs4YRiX5f5XPzp2QsgpyLP9vHXLHXkKQRC0dcITaiTX4j9RaJnR04uG4fAxRIkLLGqaJxDgp737gkJVqof5OCqVDU5MMnvXiugbXqH4hmq8fmO5hXFPMLTeZnl0AEDo0mKJnl7TlFWqSoJEwxxsOHRE5OLhvVoItYI\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 1800\n}"}],"_postman_id":"748a6501-73e6-458c-b573-a38a0b9aa876"},{"name":"Logout","event":[{"listen":"test","script":{"id":"60166237-43fa-47b7-9238-6e666919ce94","exec":[""],"type":"text/javascript"}}],"id":"79f0eee9-9e96-4d10-87b5-2e2e39e6e861","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/auth/logout","urlObject":{"path":["v3","auth","logout"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"79f0eee9-9e96-4d10-87b5-2e2e39e6e861"}],"id":"b0ccc0ea-2e40-490a-81e4-88fe56a1f9e9","description":"All requests to the UniPAY API must be authenticated to ensure security and prevent unauthorized access.
\n","_postman_id":"b0ccc0ea-2e40-490a-81e4-88fe56a1f9e9"},{"name":"Order","item":[{"name":"Create Order","id":"16f29789-871f-47a9-a860-b0f8772791fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"MerchantUser\": \"U7RF0G@gmail.com\",\n \"MerchantOrderID\": \"LJ6UYC4FKPI038B-29\",\n \"OrderPrice\": 0.5,\n \"OrderCurrency\": \"GEL\",\n \"OrderName\": \"ACVNJSIWPM\",\n \"OrderDescription\": \"AKXU0BJ5LEV97HN\",\n \"SuccessRedirectUrl\": \"aHR0cHM6Ly9zdWNjZXNzX3JlZGlyZWN0X3VybC51bmlwYXkuY29tLw==\",\n \"CancelRedirectUrl\": \"aHR0cHM6Ly9jYW5jZWxfcmVkaXJlY3RfdXJsLnVuaXBheS5jb20v\",\n \"CallBackUrl\": \"aHR0cDovL2luZm8udW5pcGF5LmNvbS8=\",\n \"Mlogo\": \"\",\n \"Language\": \"GE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/api/order/create","urlObject":{"protocol":"https","path":["v3","api","order","create"],"host":["apiv2","unipay","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"16f29789-871f-47a9-a860-b0f8772791fb"},{"name":"Confirm Preauth","id":"4052c15e-003a-441b-b1cc-a4136097e22d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"OrderHashID\": \"MP500500163DA29A38C395\",\n \"Amount\": 0\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/api/order/confirm","urlObject":{"path":["v3","api","order","confirm"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4052c15e-003a-441b-b1cc-a4136097e22d"},{"name":"Refund Order","id":"5aca0b33-3fda-4a05-adad-f21acc77e420","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"OrderHashID\": \"MP500510664DCAB60A05B1\",\n \"Amount\" : \"10.00\",\n \"Reason\" : \"System Reversal\",\n \"Note\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/api/order/refund","urlObject":{"path":["v3","api","order","refund"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5aca0b33-3fda-4a05-adad-f21acc77e420"},{"name":"Save Card","id":"9937292c-1961-4d23-a010-97e37634b93a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"MerchantUser\": \"U7RF0G@gmail.com\",\n \"MerchantOrderID\": \"LJ6UYC4FKPI038B-29\",\n \"OrderPrice\": 0.5,\n \"OrderCurrency\": \"GEL\",\n \"OrderName\": \"ACVNJSIWPM\",\n \"OrderDescription\": \"AKXU0BJ5LEV97HN\",\n \"SuccessRedirectUrl\": \"aHR0cHM6Ly9zdWNjZXNzX3JlZGlyZWN0X3VybC51bmlwYXkuY29tLw==\",\n \"CancelRedirectUrl\": \"aHR0cHM6Ly9jYW5jZWxfcmVkaXJlY3RfdXJsLnVuaXBheS5jb20v\",\n \"CallBackUrl\": \"aHR0cDovL2luZm8udW5pcGF5LmNvbS8=\",\n \"Mlogo\": \"\",\n \"InApp\": 1,\n \"Language\": \"GE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/api/order/create","description":"You can Save card securly for future use to charge customer or build a subscription flows. we are providing two options. Save Card ( InApp) or Pay from already Saved Card (RegularPaymentID)
\n","urlObject":{"protocol":"https","path":["v3","api","order","create"],"host":["apiv2","unipay","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9937292c-1961-4d23-a010-97e37634b93a"},{"name":"Pay With Saved Card","id":"e06b7e56-d129-415d-a39c-566aa629ea45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"MerchantUser\": \"U7RF0G@gmail.com\",\n \"MerchantOrderID\": \"LJ6UYC4FKPI038B-29\",\n \"OrderPrice\": 0.5,\n \"OrderCurrency\": \"GEL\",\n \"OrderName\": \"ACVNJSIWPM\",\n \"OrderDescription\": \"AKXU0BJ5LEV97HN\",\n \"SuccessRedirectUrl\": \"aHR0cHM6Ly9zdWNjZXNzX3JlZGlyZWN0X3VybC51bmlwYXkuY29tLw==\",\n \"CancelRedirectUrl\": \"aHR0cHM6Ly9jYW5jZWxfcmVkaXJlY3RfdXJsLnVuaXBheS5jb20v\",\n \"CallBackUrl\": \"aHR0cDovL2luZm8udW5pcGF5LmNvbS8=\",\n \"SubscriptionPlanID\": \"06H7AB8YY0C4EYADZCBJY37121\",\n \"Mlogo\": \"\",\n \"RegularpaymentID\": \"card_i7HQMtjp6SNFfJNo7MO3jMIbjcQNbXWk\",\n \"Language\": \"GE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/api/order/create","urlObject":{"path":["v3","api","order","create"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e06b7e56-d129-415d-a39c-566aa629ea45"},{"name":"Card Details","id":"809371e5-b806-4cff-94b1-d6887127da74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"RegularpaymentID\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/card/get-details","urlObject":{"path":["v3","card","get-details"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"809371e5-b806-4cff-94b1-d6887127da74"}],"id":"ee08b7b9-2673-4ea9-b985-0f34e3f97fc2","_postman_id":"ee08b7b9-2673-4ea9-b985-0f34e3f97fc2","description":""},{"name":"Subscription Crud","item":[{"name":"list","id":"f9ad0b6d-ebfb-4eca-9127-77f70075ad7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"GET","header":[],"url":"https://apiv2.unipay.com/v3/subscription/plan-editor/","urlObject":{"path":["v3","subscription","plan-editor",""],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f9ad0b6d-ebfb-4eca-9127-77f70075ad7f"},{"name":"create","id":"13e71c56-f10a-4713-8f3e-ce3b896913ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"title\": \"new title\",\r\n \"description\": \"new desc\",\r\n \"price\": \"20.00\",\r\n \"currency\": \"GEL\",\r\n \"anchor_day\": 15,\r\n \"billing_interval_value\": 1,\r\n \"billing_interval_type\": \"monthly\",\r\n \"error_interval_value\": 1,\r\n \"error_interval_type\": \"daily\",\r\n \"maximum_billing_cycles\": 5,\r\n \"callback_url\": \"callback_url\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/subscription/plan-editor","urlObject":{"path":["v3","subscription","plan-editor"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"13e71c56-f10a-4713-8f3e-ce3b896913ce"},{"name":"show","id":"147bead7-3a8d-4aa1-941d-71ae4ca3d318","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"GET","header":[],"url":"https://apiv2.unipay.com/v3/subscription/plan-editor/2","urlObject":{"path":["v3","subscription","plan-editor","2"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"147bead7-3a8d-4aa1-941d-71ae4ca3d318"},{"name":"update","id":"a23fd9dd-711a-42d6-bbff-fd40a44a2b54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"title\": \"new title updated\",\r\n \"description\": \"new desc updated\",\r\n \"price\": \"20.00\",\r\n \"currency\": \"GEL\",\r\n \"anchor_day\": 15,\r\n \"billing_interval_value\": 1,\r\n \"billing_interval_type\": \"monthly\",\r\n \"error_interval_value\": 1,\r\n \"error_interval_type\": \"daily\",\r\n \"maximum_billing_cycles\": 5,\r\n \"callback_url\": \"callback_url\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/subscription/plan-editor/3","urlObject":{"path":["v3","subscription","plan-editor","3"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a23fd9dd-711a-42d6-bbff-fd40a44a2b54"},{"name":"delete","id":"7f70e73f-a356-4158-819a-2fc233ea28dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"DELETE","header":[],"url":"https://apiv2.unipay.com/v3/subscription/plan-editor/3","urlObject":{"path":["v3","subscription","plan-editor","3"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7f70e73f-a356-4158-819a-2fc233ea28dd"}],"id":"ee2c49f4-8eda-4527-bf95-d804f1d5d4ff","_postman_id":"ee2c49f4-8eda-4527-bf95-d804f1d5d4ff","description":""},{"name":"Info","item":[{"name":"Error List","id":"1af5f203-8ba5-426b-97e9-16940885e8fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"RegularpaymentID\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/info/error-list","urlObject":{"path":["v3","info","error-list"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1af5f203-8ba5-426b-97e9-16940885e8fb"},{"name":"Status List","id":"5a7db8ea-ee51-43de-898a-9832480a3054","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{access_token}}"},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"RegularpaymentID\": \"test\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apiv2.unipay.com/v3/info/status-list","urlObject":{"path":["v3","info","status-list"],"host":["https://apiv2.unipay.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5a7db8ea-ee51-43de-898a-9832480a3054"}],"id":"315277f6-f190-44db-9dee-ff55aaae59cc","_postman_id":"315277f6-f190-44db-9dee-ff55aaae59cc","description":""}],"event":[{"listen":"prerequest","script":{"id":"8e7c9ffd-8367-4450-befe-8681b678dcba","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"f51ab2ef-55dd-4e94-8d1b-5670c69dd8b8","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"url","value":"https://apiv2.unipay.com","type":"string"}]}