{"info":{"_postman_id":"ce6254d4-b65a-4a6a-aead-b58004e0dcd3","name":"Zyntego API","description":"<html><head></head><body><p>Welcome to Zyntego Merchant API Integration Guide where you’ll learn how to make integration of your website or application with the REST API of our payment gateway quick and easy. Our gateway will allow you to use different deposit and withdrawal payment methods, as well as other services and features to successfully collect payments from your customers, disburse payments to them, and manage your payment transparently and easily.</p>\n<h1 id=\"prerequisites\"><strong>⚙️ Prerequisites</strong></h1>\n<p>To complete successful integration, and testing and go live aside from the current Merchant API Integration Guide you would need:</p>\n<ol>\n<li><p>Test* merchant account integration credentials and setup details:</p>\n<ol>\n<li><p>Test merchant back office login and password</p>\n</li>\n<li><p>Information about available methods, currencies, base URL, and transaction limits<br> All of the above are indicated in the setup sheet, provided by our tech team.</p>\n</li>\n<li><p>Test API and Webhook keys for authentication of requests<br> These should be generated by the merchant in their back office.</p>\n</li>\n</ol>\n</li>\n<li><p>Integration group chat with our technical team<br> Will be created by our account management team.</p>\n</li>\n<li><p>Get your IPs whitelisted on our server<br> This is done by our tech team through the tech group chat.</p>\n</li>\n<li><p>Setup your server’s webhooks and redirect URL(s) for your merchant account:</p>\n<ol>\n<li><p>Status URL, where we send you webhooks about order statuses</p>\n</li>\n<li><p>Return URL, where your customer is redirected to after payment</p>\n</li>\n</ol>\n</li>\n</ol>\n<blockquote>\n<p>*A test merchant account allows you to test most of the features including receiving failed and success responses from the gateway without involving real money. They are meant for emulating transactions and responses by software and quality assurance engineers. To perform live transactions in a production mode for test purposes you may need to find a local wallet and/or account and perform these tests with a live merchant account. </p>\n</blockquote>\n<h1 id=\"integration-steps\"><strong>⚙️ Integration steps</strong></h1>\n<p>It is recommended to complete integration in the following steps:</p>\n<ol>\n<li><p>Get all the details mentioned in the <a href=\"#prerequisites\">Prerequisites</a> section</p>\n</li>\n<li><p>Complete integration with a test merchant account</p>\n</li>\n<li><p>Test integration with simulated transactions</p>\n</li>\n<li><p>Get live account credentials and connect them to your production server</p>\n</li>\n<li><p>Test integration to your live account</p>\n</li>\n<li><p>Have your live account fully switched to live mode*</p>\n</li>\n<li><p><a href=\"#a8b6df9a-9335-4d92-aa28-482c0c4de4f4\">Go live</a></p>\n</li>\n</ol>\n<p>Our account management, customer support, and technical teams will gladly assist you on every step of your integration and going live processes.</p>\n<h1 id=\"authentication\"><strong>🔐 Authentication</strong></h1>\n<p>Each API request that you make to our gateway must be authenticated. Authenticate them by including your API key in the Authorization header.</p>\n<p>You can generate your API key as well as the webhook key for validating webhooks directly from the back office.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Header param</strong></th>\n<th><strong>Value</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Authorization</td>\n<td>YOUR_API_KEY</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>Secure your API keys - do not commit your API keys to git, do not store in Jira or other project management software, or use them in client-side JavaScript code. It can perform any action on your account without restriction. It should be kept confidential and only stored on your servers, preferably as an environment variable. </p>\n</blockquote>\n<p>API requests made without authentication will fail with the status code 401: Unauthorized. All API requests must be made over HTTPS. Do not set VERIFY_PEER to FALSE.</p>\n<h1 id=\"integrating-multiple-markets\"><strong>🌍 Integrating multiple markets</strong></h1>\n<p>If you plan to go live on more than one market (e.g. India and Argentina), integrate and test each market separately — request/response fields and the payment flow differ slightly between markets, and you should confirm your webhook handling works correctly for each one.</p>\n<p>You can use the <strong>same API key</strong> across all markets you're integrated with — there's no need for a separate key per market. To route a request to the correct market, simply pass the appropriate <code>currency</code> for that market (e.g. <code>INR</code> for India, <code>ARS</code> for Argentina) — it will automatically be processed by the correct region.</p>\n<p>If you'd prefer a fully separate account per market instead (for example for reporting or access-separation reasons), we can set that up on request — just let your account manager know.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"⚙️ Prerequisites","slug":"prerequisites"},{"content":"⚙️ Integration steps","slug":"integration-steps"},{"content":"🔐 Authentication","slug":"authentication"},{"content":"🌍 Integrating multiple markets","slug":"integrating-multiple-markets"}],"owner":"47990315","collectionId":"ce6254d4-b65a-4a6a-aead-b58004e0dcd3","publishedId":"2sBYHVuypE","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-10-27T15:50:40.000Z"},"item":[{"name":"🇮🇳 India","item":[{"name":"📥 Deposit (Hosted page)","item":[{"name":"Create Deposit Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"9fb89c45-bf86-45c8-9e68-dfb6cf4f78c6"}}],"id":"230cd804-0e6d-4e70-8f87-e83d14da08af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"upi\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"edc776bf-54f9-406a-977e-69a57f7161de\",\n    \"merchant_customer_id\": \"e6fe6f19-80bf-417e-9b8b-e4e7b03cc02f\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/deposit/new","urlObject":{"path":["deposit","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"52144292-22b5-4f46-96d7-278182e07ea4","name":"201 UPI Created successfuly","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"upi\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"95329e3b-d6c7-4666-b9d7-4623cf64379d\",\n    \"merchant_customer_id\": \"b19f2e38-b9bb-49a9-be5c-7eb5afebfee0\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/deposit/new"},"status":"Created","code":201,"_postman_previewlanguage":"Text","header":[{"key":"Date","value":"Mon, 01 Sep 2025 09:18:56 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"vary","value":"Origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"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=9bHXb6FIttaKIOYxQknZzTdqESDKs8fjh46fMpYYJs56Vn8X%2BPMNdqglauc1n2OIibzxsom7AnxrxJurhHU4Eln9LB8qesxtFTxurvXcFg%3D%3D\"}]}"},{"key":"CF-RAY","value":"9783aee08ebd41d6-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"form_url\": \"https://linestrack.com/wire?hash=f16f937b-dbac-48dc-b2b2-a7630e98e903\",\n    \"order_id\": \"e7d414e6-81b6-4dd9-a785-d19cb315c118\",\n    \"status\": \"new\"\n}"},{"id":"72847863-9ae0-48c5-91d5-c7b5b3838e19","name":"401 Wrong API Key","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"upi\",\n    \"amount\": 200,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"6437a5b3-eef1-4660-adc6-84c3e8e68526\",\n    \"merchant_customer_id\": \"2c8e27e7-05ab-4193-944f-fc5766a5e1b0\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/deposit/new"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 22 Jan 2025 10:40:06 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"vary","value":"Origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=FsllWSedNUnPxpOdfaBPF9cVLIrfPgVVQz4Y%2BDvwH7ziL%2BhvrF1c%2FKMi0032zhoTKv6Q1G2eKdNrmwWzmbuHnSXun3tJxU6Ckc2nNgpQgYcTujMwH3VIyZDozFhapKdl%2B6%2B3A6cd\"}],\"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":"905eec8528ef3607-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=19958&min_rtt=16855&rtt_var=10899&sent=46&recv=45&lost=0&retrans=1&sent_bytes=4307&recv_bytes=2273&delivery_rate=164181&cwnd=253&unsent_bytes=0&cid=447e84a3da709309&ts=41315&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\"\n}"}],"_postman_id":"230cd804-0e6d-4e70-8f87-e83d14da08af"}],"id":"4497952d-06d2-40f2-9d4c-16c282f28991","description":"<p>A deposit process facilitates transferring funds securely and efficiently. This requires creating an order, showing a payment form, and updating order status in your system. Each step ensures accurate processing and status tracking, safeguarding the integrity of the deposit transaction.</p>\n<h3 id=\"steps-to-make-a-deposit\">Steps to Make a Deposit</h3>\n<h4 id=\"step-1-create-an-order\"><strong>Step 1: Create an Order</strong></h4>\n<ul>\n<li><p><strong>Description</strong>: Initiate the deposit by running <strong>Create Deposit Order</strong> endpoint using the API. To use UPI (Unified Payments Interface) as the payment method, specify <code>upi</code>. For bank transfers, specify <code>bank_transfer</code>.</p>\n<ul>\n<li><p><strong>UPI</strong> (Unified Payments Interface): A real-time payment system that enables instant money transfers between banks using a mobile number or a virtual payment address (VPA).</p>\n</li>\n<li><p><strong>Bank Transfers</strong>: A method of transferring funds directly between bank accounts. Supported methods may include IMPS (Immediate Payment Service), which enables instant, 24/7 bank-to-bank transfers within supported networks.</p>\n</li>\n</ul>\n</li>\n<li><p><strong>Action</strong>: Submit a request with the required details, ensuring the use of the correct API key for authorization.</p>\n</li>\n<li><p><strong>Response</strong>: A successful response includes an <code>order_id</code>, <code>form_url</code>, and the transaction <code>status</code>.</p>\n</li>\n<li><p><strong>Important</strong>: Store the <code>order_id</code> , <code>amount</code> and <code>status</code> securely for further processing.</p>\n</li>\n</ul>\n<p>Example of request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"upi\",\n    \"amount\": 200,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"e8a5c596-ff82-4529-9b56-ecac6a061c91\",\n    \"merchant_customer_id\": \"995e2bae-dbcc-4549-88d0-73e8a7f74fc3\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}\n\n</code></pre>\n<p>Request parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Name</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Required</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>method</code></td>\n<td>string</td>\n<td>yes</td>\n<td>One of the available payment methods, set up for your merchant account.</td>\n<td>UPI</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>float</td>\n<td>yes</td>\n<td>Order amount in two decimal places, 500.00 implies 500 rupees and 00 paisa. For INR - only .00 paisa are accepted. Min and max amounts are indicated in the setup sheet.</td>\n<td>500.00</td>\n</tr>\n<tr>\n<td><code>currency</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Order currency in alpha code in ISO 4217 format setup for your merchant account.</td>\n<td>INR</td>\n</tr>\n<tr>\n<td><code>traffic</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Type of traffic. Only a set number of values are available - ftd, std. Please refer to your setup sheet.</td>\n<td>std</td>\n</tr>\n<tr>\n<td><code>customer_email</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer email of the standard format. Max length 100 characters.</td>\n<td><a href=\"https://mailto:name@mail.com\">name@mail.com</a></td>\n</tr>\n<tr>\n<td><code>customer_phone</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer local mobile number with country code starting from “+”. For India, it is +91 country code then 10 digits starting from 6, 7, 8, or 9.</td>\n<td>+919876543210</td>\n</tr>\n<tr>\n<td><code>customer_name</code></td>\n<td>string</td>\n<td>no</td>\n<td>Customer full name. A string of max length of 300 characters.</td>\n<td>Raj Singh</td>\n</tr>\n<tr>\n<td><code>merchant_order_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique order or transaction ID in the merchant’s database. Duplicates are not accepted. Max length 100 characters.</td>\n<td>8ba06261-f034-47d0-bf05-8caa4b4da6d4</td>\n</tr>\n<tr>\n<td><code>merchant_customer_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique customer ID in the merchant’s database. Max length 100 characters.</td>\n<td>27b69064-1be3-4974-8bfe-a9974875ff8a</td>\n</tr>\n<tr>\n<td><code>status_url</code></td>\n<td>string</td>\n<td>yes</td>\n<td>URL hosted by a merchant where we will send all transaction status callbacks. Max length 255 characters.</td>\n<td><a href=\"https://your-domain.com/status\">https://your-domain.com/status</a></td>\n</tr>\n<tr>\n<td><code>redirect_url</code></td>\n<td>string</td>\n<td>yes</td>\n<td>URL hosted by a merchant where the end customer is redirected after the completion of the deposit. This can be both dynamic payment success, fail, pending page, or a static home screen as well. Max length 255 characters.</td>\n<td><a href=\"https://your-domain.com/return\">https://your-domain.com/return</a></td>\n</tr>\n</tbody>\n</table>\n</div><p>Example of succesful response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"form_url\": \"https://base_url.com/deposit?hash=v7f0f71f-f896h-kk898f-ff6b0f34cbd0\",\n    \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe1\",\n    \"status\": \"new\"\n}\n\n</code></pre>\n<blockquote>\n<p>For security reasons, please keep <code>order_id</code> private and do not make it available neither to the public nor to end customers. </p>\n</blockquote>\n<p>Response parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Name</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>form_url</code></td>\n<td>string</td>\n<td>VPA (UPI ID)</td>\n<td>username@bankname</td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>string</td>\n<td>The ID that identifies the order in our system.</td>\n<td>c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe1</td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Status of the order.</td>\n<td>new</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Step 2: Show Payment Form</strong></p>\n<ul>\n<li><p><strong>Description</strong>: Redirect the customer to the payment form containing the transaction details.</p>\n</li>\n<li><p><strong>Action</strong>: All you need to do that is redirect your customer to the link returned in <code>form_url</code>, and we'll display our hosted payment page for them to complete the payment. You can show form by redirecting on our form page or you can show this form using <strong>iframe</strong>.</p>\n</li>\n<li><p><strong>Example</strong>: Use the <code>form_url</code> to open deposit form:<br />  <strong><code>https://base_url.com/deposit?hash=v7f0f71f-f896h-kk898f-ff6b0f34cbd0</code></strong></p>\n</li>\n</ul>\n<p><strong>Iframe integration</strong></p>\n<p>To integrate our desktop and mobile-friendly hosted payment page directly into your website using an iframe, simply include the following tag on the relevant webpage:</p>\n<p>insert <code>iframe</code> tag with folowing params</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code> :src=\"&lt;form_url&gt;\"\n allow=\"clipboard-write\"\n height=\"800\"\n width=\"100%\"\n frameborder=\"0\"\n\n</code></pre><p>The iframe triggers a close event when the close or return button is pressed. You can handle this event to close the iframe using the following approach:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-javascript\">const listener = event =&gt; {\n  if (event.data === 'close') {\n    Implement here logic to close the iframe.\n  }\n}\n if (window.addEventListener) {\n    window.addEventListener(\"message\", listener);\n  } else {\n    window.attachEvent(\"onmessage\", listener);\n  }\n\n</code></pre>\n<h4 id=\"step-3-monitor-and-handle-order-status-changes\"><strong>Step 3: Monitor and Handle Order Status Changes</strong></h4>\n<ul>\n<li><p><strong>Description</strong>: Throughout the deposit process, an order transitions through multiple statuses such as <code>new</code>, <code>pending</code>, <code>success</code>, <code>failed</code>, <code>cancelled</code>, <code>refunded</code> or <code>expired</code>. Each status indicates the current state of the order.</p>\n</li>\n<li><p><strong>Action</strong>: Use <a href=\"#a8b6df9a-9335-4d92-aa28-482c0c4de4f4\">webhooks</a> or <a href=\"#481bd153-ca88-4d74-a554-eff886ec8b08\">periodic API calls</a> to monitor order status updates. Handle each status appropriately in your system:</p>\n<ul>\n<li><p><strong>Success</strong>: Mark the order as successful and proceed with delivering goods or services.</p>\n</li>\n<li><p><strong>Failed</strong>: Mark the order as unsuccessful and inform the customer.</p>\n</li>\n<li><p><strong>Cancelled or Expired</strong>: Wait for possible transitions to <code>failed</code> or <code>success</code> before finalizing the order status.</p>\n</li>\n<li><p>Note that <code>success</code> status is final for deposit order and transition from <code>failed</code> to <code>success</code> is allowed.</p>\n</li>\n</ul>\n</li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Status</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>new</code></td>\n<td>This status is assigned to any new order initially</td>\n</tr>\n<tr>\n<td><code>cancelled</code></td>\n<td>Order gets this status in case the customer explicitly cancels the order by clicking the respective button on a hosted payment page</td>\n</tr>\n<tr>\n<td><code>expired</code></td>\n<td>Order gets this status in case we cannot confirm the order within the expiration time applicable to this particular flow and/or method</td>\n</tr>\n<tr>\n<td><code>pending</code></td>\n<td>Order gets this status in certain cases, for example when the customer confirms payment on the hosted payment page by clicking/tapping the respective button</td>\n</tr>\n<tr>\n<td><code>success</code></td>\n<td>This is the <strong>Final</strong> status of the successful deposit order. Once received you can mark the respective order/transaction as successful in your system and proceed to delivery of goods, services, or digital credit</td>\n</tr>\n<tr>\n<td><code>failed</code></td>\n<td>Once received you can mark the respective order/transaction as unsuccessful in your system.</td>\n</tr>\n<tr>\n<td><code>refunded</code></td>\n<td>This is the <strong>Final</strong> status of an order that was successfully refunded to the customer in case of deposits, and money was not sent in case of withdrawals. It indicates that the payment amount has been returned to the original payment method. Once received, you can mark the respective order/transaction as refunded in your system. Once an order reaches this status, no further payment actions can be performed on it.</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p><strong>Final</strong> status normally means that it cannot be changed anymore. However, in certain rare cases depending on the payment method and flow, we can change the order status from failed to success, which will be clearly communicated to you each time. </p>\n</blockquote>\n<p>Each change of the order status will trigger a webhook to your designated status_url with the respective order_id and status. Please refer to the <a href=\"#fcf995e0-ae08-41f7-a3a6-21d628092802\">Webhooks</a> and <a href=\"#c7c99060-a145-4e42-abc5-1ec6b2e3f54b\">Order statuses transitions</a> parts for more information.</p>\n<p>Make sure to respond to status updates dynamically and adapt your flow according to the allowed status transitions.</p>\n<blockquote>\n<p>Please do not fail orders on your side in cases of <code>cancelled</code> or <code>expired</code> status webhooks, unless you can accept further transition to <code>success</code> status.</p>\n</blockquote>\n","_postman_id":"4497952d-06d2-40f2-9d4c-16c282f28991"},{"name":"📥 Deposit (host-to-host)","item":[{"name":"Create Deposit Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"a39c8793-da0d-4b56-baf7-a3e74f20a870"}}],"id":"a81b516c-960f-4b18-9bcb-3debc1973d84","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"upi\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"18e3efe4-32ac-40a3-b792-4ede5746e169\",\n    \"merchant_customer_id\": \"04cb5186-cc41-421c-baca-dc71baaf1097\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new","urlObject":{"path":["s2s","deposit","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"94946542-4e53-4173-89ea-84ace7c7d221","name":"201 UPI Success","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"upi\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"108dfa7d-36dc-49b6-8af1-5730e07d3fac\",\n    \"merchant_customer_id\": \"2c379970-30f7-4208-9a47-e7f2db1e56a2\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:17:24 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=e4HVmC4nDjkFx8pb%2FyAK8DGUACZQJjFaWSRMC2uVd3vzjl9BeXP%2FYh2abD8woqypAkts0Nb6cBBkRuGlU81HK6745tJzlaEiXbPrJQsrNWfvt9cFVbcDvmU%3D\"}]}"},{"key":"CF-RAY","value":"9555168c38550ab7-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"wallet_address\": \"test@test\",\n    \"wallet_name\": \"[TEST] - TEST - TEST-OSTIN - FTD\",\n    \"transaction_note\": \"KCVxn\",\n    \"order_expiration_seconds\": \"600\",\n    \"order_id\": \"ee48e283-8542-46ad-9721-e8f6c46a9d22\",\n    \"status\": \"new\",\n    \"qr\": \"iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAIAAACx0UUtAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAFkUlEQVR4nO3d225kJxAF0DjK//y5B1FjEhVwe7ptV7tc7F7C3UJKH5+/fr1FwT7+/ULwG/IKOlklHQySjoZJZ2Mkk5GSSejpJNR0sko6WSUdDJKOhklnYySTkZJJ6Okk1HSySjpZJR0/1Qu/vn56XqPvWXT1f65+x1ay7VHv1x50N7RrrL9n3D0zq8+wSPGUdLJKOlklHQySrpSzbRobCcxVxU1FkmVqmi5tvFWlU/h2id4xDhKOhklnYySTkZJ11kzLeYmWvYPaiwarv0Jja/R6NWfvzCOkk5GSSejpJNR0g3WTHMqNcTRwrZ9HXB07bUFdY0VZAjjKOlklHQySjoZJd1H1kyLyqzMUf1R0bhjaX/n/aq/TyyhjKOkk1HSySjpZJR0gzXTq6/nlepkf6vKLx/VPYvG3U5HQgos4yjpZJR0Mko6GSVdZ830atvNYm6N3GJubV7jmsAjIZ/gwjhKOhklnYySTkZJ9xMyl3Bkbr5nzrV3Dvl7GxlHSSejpJNR0sko6TrPZ7p2yNBirkN2pZSptEsPWea313gO1p5xlHQySjoZJZ2Mkq5znilz+udVy/P9na+dPBvSxL3COEo6GSWdjJJORkl370zbuUmayoxO5bmVtzq6tvK/misZr1VUxlHSySjpZJR0Mkq6Z/NMjQ96tSaw0dw6t0r5Nbf48IhxlHQySjoZJZ2Mki5lnmnuC3jjREvlJefOtG3c3lT5P8+tvTSOkk5GSSejpJNR0nX2gNib29DzqsvcUZUwt0VpbrdT4z+nwjhKOhklnYySTkZJNzjPdO2so0WlGpub73m1RelISNOHhXGUdDJKOhklnYySbvBM25CFXvuqaK5Wm9tlNVeczVVy1ubxJ5NR0sko6WSUdKWaae5Qpbkv/q+OPrrWTL3yoZhngv9DRkkno6STUdIN7me6ts+m8bl7cx3QK9Ndc/N5r86FWhhHSSejpJNR0sko6Uq9xq8dzLpXKbCO7tzYN+/oQXNHTF07RKrCOEo6GSWdjJJORknXuZ9p0VglvNqjs5grOBoLysbaJeTwKuMo6WSUdDJKOhkl3b2+eY297+YWpx29xl5jhTFXBTbSA4LvJaOkk1HSySjpBueZGmeS5jYwzR0Ttb9V5a0aNZ7Da20e30tGSSejpJNR0pX2M/3m1rdOvD16jcZarXEB4V5Iv75XJZRxlHQySjoZJZ2Mkm7wfKaKuc4UjZ25F9f614W0AL+2ftI4SjoZJZ2Mkk5GSTfYa3xvrp/C0bVzD6pM/zQumdubO9qqsYA2jpJORkkno6STUdLd6wFRudXiVWuGuTVyjdc2Li88Ym0e30tGSSejpJNR0g3uZ1qfdGvn0Kte49d+uri26UoPCPhvMko6GSWdjJLuXs20Prhv/uPVMr9GISdO7b3a7GUcJZ2Mkk5GSSejpCvVTNfWfVXu3FiOVK6dK2UqD2o0NwtlHCWdjJJORkkno6R7Ns9UcW1V2NxKtiOfOLFUee7COEo6GSWdjJJORkn3rG/ekWvFylynhkqxMtddotI37xrjKOlklHQySjoZJV3n2rxrx6fuf3nROLMS0rdikTnPpG8eX0RGSSejpJNR0nX2Gl9c+y5/7YCixauDaCsF5bUjtexn4ovIKOlklHQySrrBmmlO5cv7/lZ7lYmlfQ0R0omjUjIevdUR4yjpZJR0Mko6GSXdR9ZMe9e+y1dW31Xeau7OjQsIrc3ji8go6WSUdDJKuj9hP1PlVh/Rp/zoVnvXzqNSM/FFZJR0Mko6GSVd5zzTtTZ6177pVx7U2Kd8r3G6q3GKzn4mvoiMkk5GSSejpPvI85n4KsZR0sko6WSUdDJKOhklnYySTkZJJ6Okk1HSySjpZJR0Mko6GSWdjJJORkkno6STUdLJKOlklHT/Ap+Mvw69wtxAAAAAAElFTkSuQmCC\",\n    \"deep_links\": {\n        \"phonepe\": \"phonepe://native?data=eyJjb250YWN0Ijp7ImNic05hbWUiOiIiLCJuaWNrTmFtZSI6IiIsInR5cGUiOiJWUEEiLCJ2cGEiOiJ0ZXN0QHRlc3QifSwicDJwUGF5bWVudENoZWNrb3V0UGFyYW1zIjp7ImlzQnlEZWZhdWx0S25vd25Db250YWN0Ijp0cnVlLCJlbmFibGVTcGVlY2hUb1RleHQiOmZhbHNlLCJhbGxvd0Ftb3VudEVkaXQiOmZhbHNlLCJzaG93UXJDb2RlT3B0aW9uIjpmYWxzZSwiZGlzYWJsZVZpZXdIaXN0b3J5Ijp0cnVlLCJzaG91bGRTaG93VW5zYXZlZENvbnRhY3RCYW5uZXIiOmZhbHNlLCJpc1JlY3VycmluZyI6ZmFsc2UsImNoZWNrb3V0VHlwZSI6IkRFRkFVTFQiLCJ0cmFuc2FjdGlvbkNvbnRleHQiOiJwMnAiLCJkaXNhYmxlTm90ZXNFZGl0Ijp0cnVlLCJzaG93S2V5Ym9hcmQiOmZhbHNlLCJjdXJyZW5jeSI6IklOUiIsInNob3VsZFNob3dNYXNrZWROdW1iZXIiOnRydWUsIm5vdGUiOiJLQ1Z4biIsImluaXRpYWxBbW91bnQiOjIyNzAwfX0%3D&id=p2ppayment\",\n        \"paytm\": \"paytmmp://cash_wallet?pa=test%40test&pn=Test%20Merchant%20STR&tn=KCVxn&am=227&cu=INR&featuretype=money_transfer\"\n    }\n}"},{"id":"f2fce64a-2fad-4d6a-91ca-69185bea4f49","name":"422 Invalid request","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"27dc911b-ea99-43b7-ad76-80c1da021f7e\",\n    \"merchant_customer_id\": \"73437151-4944-44a6-a4eb-e12d31c18e52\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:16:14 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=ABPg%2FtofZ5JAP21nfMCnjzaHzridnGa%2Fv2juFxvg8nTaKRjFF11jr6NxrRme1MMcOgbySG1dv%2F9aZTlBo0ptx0fjzcwOeivpdCsGjTCv79%2FRmlvMbLHqCcc%3D\"}]}"},{"key":"CF-RAY","value":"955514d898a5f44b-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"invalid request\",\n    \"errors\": {\n        \"account\": [\n            \"Mid is not configured for method \\\"bank_transfer\\\"\"\n        ]\n    }\n}"},{"id":"2e1a1ed4-5033-4b03-b0d3-72d1750ccfc0","name":"401 Wrong API Key","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"91aeb522-f4cd-40df-8a51-7f74f9c665a8\",\n    \"merchant_customer_id\": \"959ccffc-41a4-499c-8255-1206b4415614\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"std\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:19:23 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=YqqOuAnsCHT261qm8dA%2BLbXYbuK588alWiUTGpdJoUl4dgCDjbm4CudkUHpLb1Agji8rCUanGWi1xOAHEZ4xydSa%2B%2BFi1hoyUZfDL8AM40fhSA20vTrw0yOsvw%3D%3D\"}]}"},{"key":"CF-RAY","value":"9555197cbe4fd85e-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\"\n}"}],"_postman_id":"a81b516c-960f-4b18-9bcb-3debc1973d84"},{"name":"Confirm UTR","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"08b2787a-7abc-42a1-bde6-5f7ce3035d7c"}}],"id":"43cd2f50-658e-41a6-be6b-a937711ff255","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"e010d12b-570b-417e-a781-c8f4261dcd27\",\n    \"customer_transaction_id\": \"409876543210\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/confirm","urlObject":{"path":["s2s","deposit","confirm"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"6927709a-93cb-4654-84dc-1cf4da6dadeb","name":"200 Success - order confirmed","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"3a54ba9d-cf38-4dcb-8478-51afdb77d96e\",\n    \"customer_transaction_id\": \"110000000000\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/confirm"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Date","value":"Mon, 01 Sep 2025 10:09:38 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"vary","value":"Origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"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=v2J3x5iT4D%2FnbM%2F98jghqQHF2jh5SKjdjIAym4xWmH%2B5EVDZqMOsN9T%2F4%2F0vuqJogmlkK63%2Fu63GuhTpclSLL18jzKlmuOKyVvN3eIG6yw%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9783f9207d9fb54c-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"pending\"\n}"},{"id":"e3c21678-bf10-47cc-a83d-4c356a20535d","name":"422 Wrong UTR - already taken","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"e010d12b-570b-417e-a781-c8f4261dcd27\",\n    \"customer_transaction_id\": \"409876543210\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/confirm"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"Text","header":[{"key":"Date","value":"Mon, 01 Sep 2025 09:52:27 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"vary","value":"Origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"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=FcJ6kWaQQpkYOvpF42ByJN6jy0TYP%2BCmGpVermyDPeaPns5PFaTTAPsvPqf06ODICmvu%2BXe%2FxDYvIRaBenjIMOVOMul7eV8GzDDni9kl4A%3D%3D\"}]}"},{"key":"CF-RAY","value":"9783dffb0de0cd1c-LHR"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"The selected order id is invalid. (and 1 more error)\",\n    \"errors\": {\n        \"order_id\": [\n            \"The selected order id is invalid.\"\n        ],\n        \"customer_transaction_id\": [\n            \"The customer transaction id has already been taken.\"\n        ]\n    }\n}"}],"_postman_id":"43cd2f50-658e-41a6-be6b-a937711ff255"}],"id":"15a10240-5f31-43d1-9605-f98750c68a4d","description":"<p>The Host-to-Host Deposit endpoint allows you to create orders and confirm them by collecting UTR on your own payment page without leaving your website by the end user.</p>\n<h3 id=\"steps-to-make-a-deposit\">Steps to Make a Deposit</h3>\n<h4 id=\"step-1-create-an-order\"><strong>Step 1: Create an Order</strong></h4>\n<ul>\n<li><p><strong>Description</strong>: Initiate the deposit by running <strong>Create Deposit Order</strong> endpoint using the API. Include payment details such as wallet address, wallet name, and a transaction note. To use UPI (Unified Payments Interface) as the payment method, specify <code>upi</code>. For bank transfers, specify <code>bank_transfer</code>.</p>\n<ul>\n<li><p><strong>UPI</strong> (Unified Payments Interface): A real-time payment system that enables instant money transfers between banks using a mobile number or a virtual payment address (VPA).</p>\n</li>\n<li><p><strong>Bank Transfers</strong>: A method of transferring funds directly between bank accounts. Supported methods may include IMPS (Immediate Payment Service), which enables instant, 24/7 bank-to-bank transfers within supported networks.</p>\n</li>\n</ul>\n</li>\n<li><p><strong>Action</strong>: Submit a request with the required details, ensuring the use of the correct API key for authorization.</p>\n</li>\n<li><p><strong>Response:</strong> A successful request returns an HTTP <strong>201 Created</strong> status along with a JSON payload containing the <strong>order details</strong>.</p>\n</li>\n<li><p><strong>Important</strong>: Store the <code>order_id</code> , <code>amount</code> and <code>status</code> securely for further processing.</p>\n</li>\n</ul>\n<p>Example of request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"upi\",\n    \"amount\": 200,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"e8a5c596-ff82-4529-9b56-ecac6a061c91\",\n    \"merchant_customer_id\": \"995e2bae-dbcc-4549-88d0-73e8a7f74fc3\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\"\n}\n\n</code></pre>\n<p>Request parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Name</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Required</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>method</code></td>\n<td>string</td>\n<td>yes</td>\n<td>One of the available payment methods, set up for your merchant account.</td>\n<td>UPI</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>float</td>\n<td>yes</td>\n<td>Order amount in two decimal places, 500.00 implies 500 rupees and 00 paisa. For INR - only .00 paisa are accepted. Min and max amounts are indicated in the setup sheet.</td>\n<td>500.00</td>\n</tr>\n<tr>\n<td><code>currency</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Order currency in alpha code in ISO 4217 format setup for your merchant account.</td>\n<td>INR</td>\n</tr>\n<tr>\n<td><code>traffic</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Type of traffic. Only a set number of values are available - ftd, std. Please refer to your setup sheet.</td>\n<td>std</td>\n</tr>\n<tr>\n<td><code>customer_email</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer email of the standard format. Max length 100 characters.</td>\n<td><a href=\"https://mailto:name@mail.com\">name@mail.com</a></td>\n</tr>\n<tr>\n<td><code>customer_phone</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer local mobile number with country code starting from “+”. For India, it is +91 country code then 10 digits starting from 6, 7, 8, or 9.</td>\n<td>+919876543210</td>\n</tr>\n<tr>\n<td><code>customer_name</code></td>\n<td>string</td>\n<td>no</td>\n<td>Customer full name. A string of max length of 300 characters.</td>\n<td>Raj Singh</td>\n</tr>\n<tr>\n<td><code>merchant_order_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique order or transaction ID in the merchant’s database. Duplicates are not accepted. Max length 100 characters.</td>\n<td>8ba06261-f034-47d0-bf05-8caa4b4da6d4</td>\n</tr>\n<tr>\n<td><code>merchant_customer_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique customer ID in the merchant’s database. Max length 100 characters.</td>\n<td>27b69064-1be3-4974-8bfe-a9974875ff8a</td>\n</tr>\n<tr>\n<td><code>status_url</code></td>\n<td>string</td>\n<td>yes</td>\n<td>URL hosted by a merchant where we will send all transaction status callbacks. Max length 255 characters.</td>\n<td><a href=\"https://your-domain.com/status\">https://your-domain.com/status</a></td>\n</tr>\n<tr>\n<td><code>redirect_url</code></td>\n<td>string</td>\n<td>yes</td>\n<td>URL hosted by a merchant where the end customer is redirected after the completion of the deposit. This can be both dynamic payment success, fail, pending page, or a static home screen as well. Max length 255 characters.</td>\n<td><a href=\"https://your-domain.com/return\">https://your-domain.com/return</a></td>\n</tr>\n</tbody>\n</table>\n</div><p>Example of succesful response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"wallet_address\": \"username@bankname\",\n    \"wallet_name\": \"Company Name\",\n    \"order_expiration_seconds\": \"600\",\n    \"transaction_note\": \"A1b2c\",\n    \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe1\",\n    \"status\": \"new\",\n    \"qr\": \"&lt;base64-encoded PNG QR code&gt;\",\n    \"deep_links\": {\n        \"phonepe\": \"phonepe://native?data=...\",\n        \"paytm\": \"paytmmp://cash_wallet?pa=...&amp;pn=...&amp;tn=...&amp;am=...&amp;cu=INR&amp;featuretype=money_transfer\"\n    }\n}\n\n</code></pre>\n<blockquote>\n<p>Updated 2026-09: the response now also includes <code>qr</code> (a base64 PNG of the payment QR code) and <code>deep_links</code> (direct app-open links for supported UPI apps) alongside the existing fields.</p>\n</blockquote>\n<blockquote>\n<p>For security reasons, please keep <code>order_id</code> private and do not make it available neither to the public nor to end customers. </p>\n</blockquote>\n<p>Response parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Name</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong><code>wallet_address</code></strong></td>\n<td><strong>string</strong></td>\n<td>VPA (UPI ID)</td>\n<td>username@bankname</td>\n</tr>\n<tr>\n<td><strong><code>wallet_name</code></strong></td>\n<td><strong>string</strong></td>\n<td>Merchant of record name</td>\n<td>Company Name</td>\n</tr>\n<tr>\n<td><strong><code>order_expiration_seconds</code></strong></td>\n<td><strong>string</strong></td>\n<td>Order expiration timeout - time required to send UTR before order would transition to Expire status. Normally, 10 minutes (600 seconds).</td>\n<td>600</td>\n</tr>\n<tr>\n<td><strong><code>transaction_note</code></strong></td>\n<td><strong>string</strong></td>\n<td>Transaction note providing a  <br />short description of the  <br />transaction.</td>\n<td>A1b2c</td>\n</tr>\n<tr>\n<td><strong><code>order_id</code></strong></td>\n<td><strong>string</strong></td>\n<td>The ID that identifies the order in our system.</td>\n<td>c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe1</td>\n</tr>\n<tr>\n<td><strong><code>status</code></strong></td>\n<td><strong>string</strong></td>\n<td>Status of the order.</td>\n<td>new</td>\n</tr>\n<tr>\n<td><strong><code>qr</code></strong></td>\n<td><strong>string</strong></td>\n<td>Base64-encoded PNG of the payment QR code, ready to render/display to the customer.</td>\n<td>(base64 string)</td>\n</tr>\n<tr>\n<td><strong><code>deep_links</code></strong></td>\n<td><strong>object</strong></td>\n<td>Direct app-open links for supported UPI apps, prefilled with the payment details. Currently returns <code>phonepe</code> and <code>paytm</code>.</td>\n<td>see example above</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>We recommend that you immediately store order_id, amount, and status parameters at your end. </p>\n</blockquote>\n<h4 id=\"step-2-show-payment-form\"><strong>Step 2: Show Payment Form</strong></h4>\n<ul>\n<li><p><strong>Description:</strong> Present the customer with your <strong>own payment form</strong> that displays the <strong>Virtual Payment Address (VPA / UPI ID)</strong> and other transaction details provided in the deposit order response.</p>\n</li>\n<li><p><strong>Action:</strong> Collect the <strong>UTR (Unique Transaction Reference)</strong> from the customer once the deposit is completed. This must be done <strong>within the expiration time</strong> specified in <code>order_expiration_seconds</code>.</p>\n</li>\n</ul>\n<h4 id=\"step-3-confirm-utr\"><strong>Step 3: Confirm UTR</strong></h4>\n<ul>\n<li><p><strong>Description:</strong> Once the customer has completed the UPI payment and provided the <strong>UTR (Unique Transaction Reference)</strong>, you need to confirm the transaction by submitting the UTR to our system. This step ensures the order can be verified and moved to a final status.</p>\n</li>\n<li><p><strong>Action:</strong> Send a <strong>POST</strong> request to the confirmation endpoint using the <code>order_id</code> received in the deposit order response. Include the UTR in the <code>customer_transaction_id</code> field of the request body.</p>\n</li>\n</ul>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">POST https://api.zyntego.com/api/s2s/deposit/confirm\nContent-Type: application/json\n\n</code></pre>\n<p>Request Body Example:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"order_id\": \"abc12345\",\n  \"customer_transaction_id\": \"1234567890\"\n}\n\n</code></pre>\n<p><strong>Response:</strong><br />A <strong>HTTP 200 OK</strong> response indicates successful acceptance of the UTR. As a result, the order status will be updated to either <code>success</code> or <code>pending</code>.</p>\n<p><strong>Response example:</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": \"success\"\n}\n\n</code></pre>\n<p>It is strongly recommended to save the order status and adjust respective order/transaction status in your system to deliver goods, services, airtime, wallet top-up, or digital credit.</p>\n<p>At the same time you would receive a <strong>separate webhook</strong> with order status.</p>\n<p>In case of an expired status or other issue you would receive 422 response with respective error message.</p>\n<p><strong>Response example (422):</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"message\": \"The customer transaction id has already been taken.\",\n    \"errors\": {\n        \"customer_transaction_id\": [\n            \"The customer transaction id has already been taken.\"\n        ]\n    }\n}\n\n</code></pre>\n<p>Please refer to the <a href=\"#c7c99060-a145-4e42-abc5-1ec6b2e3f54b\">Order statuses transitions</a> parts for more information.</p>\n","_postman_id":"15a10240-5f31-43d1-9605-f98750c68a4d"},{"name":"📤 Withdraw","item":[{"name":"Create Withdraw Order","id":"719bd41d-5f9f-465a-b70b-00af629bcecf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 11.0,\n    \"currency\": \"INR\",\n    \"merchant_order_id\": \"0f8051cd-20e6-4e19-94ed-102778114b08\",\n    \"merchant_customer_id\": \"1b1fa2c6-3196-48de-9fa6-cb3f1dcae649\",\n    \"customer_bank_account\": \"05010041281109\",\n    \"bank_code\": \"HDFC0000240\",\n    \"customer_name\": \"Peter Pen\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919811000088\",\n    \"status_url\": \"https://webhook.site/96543a6e-31c6-4fc7-b8d4-21c9058ce5d5\",\n    \"traffic\": \"std\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new","urlObject":{"path":["withdraw","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"248ed60a-c8d0-49e3-8684-b8d0cfb8dce0","name":"201 Success","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 500.00,\n    \"currency\": \"INR\",\n    \"traffic\": \"std\",\n    \"customer_email\": \"name@mail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Raj Singh\",\n    \"merchant_order_id\": \"30bfbb2b-f74a-4330-b419-327d1f4d50f9\",\n    \"merchant_customer_id\": \"79c56284-e27f-4fd0-bb77-61b4a9881cc7\",\n    \"customer_bank_account\": \"065432123456789\",\n    \"bank_code\": \"HDFC0000053\",\n    \"status_url\": \"https://merchant.com/status\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:23:43 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=KKAgYz9chVOeaSL7ziOKCi1n1tCHZKLkFbFmRP%2FIFSWm6oz6M8JkYQcAy6FfFleU9JxmlQsli1yU0IR8sszU9YSmrMLjxhlb1DMzBeejlVMSr0D9EsBqK8OUEg%3D%3D\"}]}"},{"key":"CF-RAY","value":"95551fbff88e54d5-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"291fe219-af94-4512-8ea5-9efd56bf84c3\",\n    \"status\": \"new\"\n}"},{"id":"a20bff75-cc91-4ba2-bc16-22ec64c61d02","name":"422 Error Invalid request","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 11.0,\n    \"currency\": \"INR\",\n    \"merchant_order_id\": \"7ea070b8-036a-485c-b4fd-9ed90a219c75\",\n    \"merchant_customer_id\": \"65ff2a58-4f4e-411b-8729-680b5b4be259\",\n    \"customer_destination_account\": \"05010041281109\",\n    \"bank_code\": \"HDFC0000240\",\n    \"account_name\": \"Peter Pen\",\n    \"customer_name\": \"Peter Pen\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919811000088\",\n    \"status_url\": \"https://webhook.site/96543a6e-31c6-4fc7-b8d4-21c9058ce5d5\",\n    \"traffic\": \"std\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:20:14 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=4ECmfOC3gHWRzJF4qL6DOJv6mVKKleW6DI0pXBtZA2Akq4GLpAzVHZof39Wr4FPH8zYZ9xVs%2FODeLrNHkR5yOa%2F40Mjgh%2FEyxeVBcpRzE75p%2BFAwEXEgcUSysQ%3D%3D\"}]}"},{"key":"CF-RAY","value":"95551ab60e3ad85e-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"The customer bank account field is required.\",\n    \"errors\": {\n        \"customer_bank_account\": [\n            \"The customer bank account field is required.\"\n        ]\n    }\n}"},{"id":"6b76f1d0-7ab6-4ecb-a89b-00f7b61be603","name":"422 Order already taken","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 500.00,\n    \"currency\": \"INR\",\n    \"traffic\": \"std\",\n    \"customer_email\": \"name@mail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Raj Singh\",\n    \"merchant_order_id\": \"30bfbb2b-f74a-4330-b419-327d1f4d50f8\",\n    \"merchant_customer_id\": \"79c56284-e27f-4fd0-bb77-61b4a9881cc7\",\n    \"customer_bank_account\": \"065432123456789\",\n    \"bank_code\": \"HDFC0000053\",\n    \"status_url\": \"https://merchant.com/status\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:22:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=%2FUPj19ktwNCdqrX1aXR2665aYuzQRQ1nkKOw9fOrohWS3qszV1eI0ZRRMJZj9kvFkCzJyI4u%2Fw8Aql4PMCE%2BHAV7bl%2FutspgY%2FeqT2Ufrlj3sM2IQHrr%2FeU%3D\"}]}"},{"key":"CF-RAY","value":"95551dda08c0a935-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"The merchant order id has already been taken.\",\n    \"errors\": {\n        \"merchant_order_id\": [\n            \"The merchant order id has already been taken.\"\n        ]\n    }\n}"}],"_postman_id":"719bd41d-5f9f-465a-b70b-00af629bcecf"}],"id":"386149fa-8384-4f01-8d87-771403d97bc6","description":"<p>The <strong>Withdraw</strong> enables you to create a transaction to process payouts to your customers. Each request must be authenticated using your API key, following the same method as with deposit transactions.</p>\n<h3 id=\"steps-to-make-a-withdraw\">Steps to Make a Withdraw</h3>\n<h4 id=\"step-1-create-a-withdrawal-order\">Step 1: Create a Withdrawal Order</h4>\n<p><strong>Description:</strong> Initiate the payout by calling the Create Withdrawal Order endpoint using the API. Include payment details such as the payment method, customer information, and the bank account details of the beneficiary.<br /><strong>Action:</strong> Submit a <code>POST</code> request with the required details (e.g., <code>amount</code>, <code>currency</code>, <code>customer_bank_account</code>, etc.), ensuring the use of your API key for authorization.<br /><strong>Response:</strong> A successful response includes an <code>order_id</code> and the initial transaction status (<code>new</code>).<br /><strong>Important:</strong> Securely store the <code>order_id</code>, <code>amount</code>, and <code>status</code> for future status updates and transaction reconciliation.</p>\n<p>Example of request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"bank_transfer\",\n    \"amount\": 500.00,\n    \"currency\": \"INR\",\n    \"traffic\": \"std\",\n    \"customer_email\": \"name@mail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Raj Singh\",\n    \"merchant_order_id\": \"30bfbb2b-f74a-4330-b419-327d1f4d50f8\",\n    \"merchant_customer_id\": \"79c56284-e27f-4fd0-bb77-61b4a9881cc7\",\n    \"customer_bank_account\": \"065432123456789\",\n    \"bank_code\": \"HDFC0000053\",\n    \"status_url\": \"https://merchant.com/status\"\n}\n\n</code></pre>\n<p>Request parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>ame</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Required</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>method</code></td>\n<td>string</td>\n<td>yes</td>\n<td>One of the available payment methods, set up for your merchant account.</td>\n<td>UPI</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>float</td>\n<td>yes</td>\n<td>Order amount in two decimal places, 500.00 implies 500 rupees and 00 paisa. For INR - only .00 paisa are accepted. Min and max amounts are indicated in the setup sheet.</td>\n<td>500.00</td>\n</tr>\n<tr>\n<td><code>currency</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Order currency in alpha code in ISO 4217 format setup for your merchant account.</td>\n<td>INR</td>\n</tr>\n<tr>\n<td><code>traffic</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Type of traffic. Only a set number of values are available - ftd, std. Please refer to your setup sheet.</td>\n<td>std</td>\n</tr>\n<tr>\n<td><code>customer_email</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer email of the standard format. Max length 100 characters.</td>\n<td><a href=\"https://mailto:name@mail.com\">name@mail.com</a></td>\n</tr>\n<tr>\n<td><code>customer_phone</code></td>\n<td>string</td>\n<td>no</td>\n<td>Unique customer local mobile number with country code starting from “+”. For India, it is +91 country code then 10 digits starting from 6, 7, 8, or 9.</td>\n<td>+919876543210</td>\n</tr>\n<tr>\n<td><code>customer_name</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Customer full name. A string of max length of 300 characters.</td>\n<td>Raj Singh</td>\n</tr>\n<tr>\n<td><code>merchant_order_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique order or transaction ID in the merchant’s database. Duplicates are not accepted. Max length 100 characters.</td>\n<td>8ba06261-f034-47d0-bf05-8caa4b4da6d4</td>\n</tr>\n<tr>\n<td><code>merchant_customer_id</code></td>\n<td>string</td>\n<td>yes</td>\n<td>Unique customer ID in the merchant’s database. Max length 100 characters.</td>\n<td>27b69064-1be3-4974-8bfe-a9974875ff8a</td>\n</tr>\n<tr>\n<td><code>customer_bank_account</code></td>\n<td>integer</td>\n<td>yes</td>\n<td><strong>A valid beneficiary bank account number. Between 9 and 18 characters. Can have a leading 0, which should be passed on.</strong></td>\n<td>065432123456789</td>\n</tr>\n<tr>\n<td><code>bank_code</code></td>\n<td>string</td>\n<td>yes</td>\n<td>A valid beneficiary bank code. For bank_transfer in INR, it is IFSC code - a unique identifier of a bank branch, which has to be 11 characters.</td>\n<td>HDFC0000053</td>\n</tr>\n<tr>\n<td><code>status_url</code></td>\n<td>string</td>\n<td>yes</td>\n<td>URL hosted by a merchant where we will send all transaction status callbacks. Max length 255 characters.</td>\n<td><a href=\"https://your-domain.com/status\">https://your-domain.com/status</a></td>\n</tr>\n</tbody>\n</table>\n</div><p>Example of succesful response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe2\",\n    \"status\": \"new\"\n}\n\n</code></pre>\n<blockquote>\n<p>For security reasons, please keep <code>order_id</code> private and do not make it available neither to the public nor to end customers. </p>\n</blockquote>\n<p>Response parameters:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Name</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Example</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>order_id</code></td>\n<td>string</td>\n<td>The ID that identifies the order in our system.</td>\n<td>c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe1</td>\n</tr>\n<tr>\n<td><code>status</code></td>\n<td>string</td>\n<td>Status of the order.</td>\n<td>new</td>\n</tr>\n</tbody>\n</table>\n</div><p>In case of an error in the request data, our server will respond with a respective <a href=\"#790fd1c0-bc6e-4e05-ae5a-f366c853a996\">Response code</a> and message.</p>\n<h4 id=\"step-2-monitor-the-order-status\">Step 2: Monitor the Order Status</h4>\n<p><strong>Description:</strong> Track the withdrawal order’s progress as it transitions through statuses (<code>new</code>, <code>pending</code>, <code>success</code>, <code>failed</code>). Each status update is sent to the merchant-hosted <code>status_url</code> provided during order creation.<br /><strong>Action:</strong> Use the <code>order_id</code> to monitor the transaction status via webhook callbacks or API queries. Ensure you handle status changes appropriately in your system.<br /><strong>Response:</strong> The final status will be either <code>success</code> or <code>failed</code>. Updates will include the <code>order_id</code> and the current status.<br /><strong>Important:</strong> Handle the final status (<code>success</code> or <code>failed</code>) carefully, and consider rare cases where a <code>success</code> status may transition to <code>failed</code>.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Status</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>new</code></td>\n<td>This status is assigned to any new order initially</td>\n</tr>\n<tr>\n<td><code>pending</code></td>\n<td>Order gets this status in certain cases, for example when the customer confirms payment on the hosted payment page by clicking/tapping the respective button</td>\n</tr>\n<tr>\n<td><code>success</code></td>\n<td>This is the <strong>Final</strong> status of the successful withdrawal order. Once received you can mark the respective order/transaction as successful in your system.</td>\n</tr>\n<tr>\n<td><code>failed</code></td>\n<td>This is the <strong>Final</strong> status of the failed withdrawal order. Once received you can mark the respective order/transaction as unsuccessful in your system.</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>Final status normally means that it cannot be changed anymore. However, in certain rare cases depending on the payment method and flow, we can change the order status from success to failed, which will be clearly communicated to you each time. </p>\n</blockquote>\n<p>Each change of the order status will trigger a webhook to your designated status URL with the respective order_id and status. Please refer to the <a href=\"#fcf995e0-ae08-41f7-a3a6-21d628092802\">Webhooks</a> part for more information.</p>\n<h3 id=\"beneficiary-validation\">Beneficiary Validation</h3>\n<ul>\n<li><p>IFSC codes are validated using an open-source bank database.</p>\n</li>\n<li><p>Any invalid or non-matching IFSC will cause the payout request to fail.</p>\n</li>\n<li><p>The beneficiary name must include the customer’s actual name (surname optional but recommended).</p>\n</li>\n</ul>\n","_postman_id":"386149fa-8384-4f01-8d87-771403d97bc6"},{"name":"🪝Webhooks","item":[],"id":"478f97d5-dbaa-425b-83cb-0a6a7511f9ce","description":"<h3 id=\"webhook-status_url\">Webhook (status_url)</h3>\n<p>You should provide a webhook URL (called <code>status_url</code>) with each <strong>deposit</strong> or <strong>withdrawal</strong> request you make. This will ensure that we send a webhook with order status to the most up-to-date and correct address.</p>\n<p>Due to the specific nature of some of our payment methods and flows, each order can change its status and amount over time and may not reach the final status (<code>success</code> or <code>failed</code>) immediately. Thus, maintaining a webhook URL is vital to efficiently process payments for your customers. We recommend saving and updating your records with all the information received.</p>\n<p>A webhook URL is simply a <strong>POST endpoint</strong> that our server sends updates to.</p>\n<hr />\n<h3 id=\"webhook-statuses\">Webhook statuses</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>When you receive it</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>pending</code></td>\n<td>The order was created and is being processed, but has not reached a final state yet. Amount and status may still change before the order settles.</td>\n</tr>\n<tr>\n<td><code>success</code></td>\n<td>The order reached its final state and completed successfully.</td>\n</tr>\n<tr>\n<td><code>failed</code></td>\n<td>The order reached its final state and could not be completed.</td>\n</tr>\n<tr>\n<td><code>chargeback</code></td>\n<td>A previously successful deposit was reversed (e.g. after a user complaint). The amount is deducted from your balance. See the <strong>Chargeback</strong> section for the payload and details.</td>\n</tr>\n</tbody>\n</table>\n</div><p>The URL needs to parse a JSON request and return a <strong>200 OK</strong> in the HTTP header.</p>\n<hr />\n<h3 id=\"deposit-webhook-example\">Deposit Webhook Example</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"order_id\": \"849655cf-ceba-49bc-951a-cbfbf8d63274\",\n  \"merchant_order_id\": \"O_XVajPtgGFk173LluM5oKb\",\n  \"status\": \"success\",\n  \"reason\": \"some reason\",\n  \"amount\": \"200.00\",\n  \"utr\": \"409876543210\",\n  \"target_upi_id\": \"deposit@test\",\n  \"merchant_customer_id\": \"aaaaaaa99-1290-3e9f-a08e-c03aedc68b35\"\n  \"holder_name\": \"example_holder_name\"\n}\n\n</code></pre>\n<hr />\n<h3 id=\"withdrawal-webhook-example\">Withdrawal Webhook Example</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe2\",\n  \"merchant_order_id\": \"ABC00001\",\n  \"status\": \"failed\",\n  \"reason\": \"some reason\",\n  \"amount\": \"300\",\n  \"utr\": \"409876543210\",\n  \"error_code\": \"ERR_001\",\n  \"error_message\": \"Payout service under maintenance. Try again later.\"\n}\n\n</code></pre>\n<p>⚠️ <strong>Note:</strong></p>\n<ul>\n<li><p>Fields <code>error_code</code> and <code>error_message</code> are present <strong>only if</strong> <code>\"status\": \"failed\"</code>.</p>\n</li>\n<li><p>If <code>\"status\": \"success\"</code>, these fields will not be included.</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"additional-details\">Additional Details</h3>\n<ul>\n<li><p><strong>utr</strong> → Unique transaction reference received from the bank.</p>\n</li>\n<li><p><strong>reason</strong> → Short description of a failed order reason.</p>\n</li>\n<li><p><strong>merchant_order_id</strong> → The order/transaction reference of the merchant provided during the initial create order request.</p>\n</li>\n</ul>\n<p>The system will automatically retry sending the webhook <strong>3 times</strong>.</p>\n<p>If delivery still fails, we recommend manually resend it from the Back Office and verify that your server is able to receive it.</p>\n<p><strong>Signature validation</strong></p>\n<p>Since your webhook URL is publicly available and sensitive data about order ID and its status is transmitted, you need to keep your webhook URL confidential and verify that events originate from our server and not from a bad actor.</p>\n<blockquote>\n<p><strong>We may not accept responsibility for non-validated webhooks. If you do not perform validation you’re accepting the risks of malicious order statuses.</strong> </p>\n</blockquote>\n<p>Events sent from Zyntego carry the x-pay-signature header. The value of this header is an HMAC SHA256 signature of the event payload (JSON string) signed using your webhook key.</p>\n<blockquote>\n<p><strong>Verifying the header signature should be done before processing the event. As a reference you can use this sandbox:</strong> <a href=\"https://www.devglan.com/online-tools/hmac-sha256-online\">https://www.devglan.com/online-tools/hmac-sha256-online</a> </p>\n</blockquote>\n<p>Each change of the order status will trigger a webhook to your status URL with the respective <code>order_id</code>, <code>amount</code>, and <code>status</code>.</p>\n<p>Once we proceed to processing of an order, you will get a pending order status notification:</p>\n<p><strong>Example body (JSON string) :</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\"order_id\":\"849655cf-ceba-49bc-951a-cbfbf8d63274\",\"merchant_order_id\":\"O_XVajPtgGFk173LluM5oKb\",\"status\":\"pending\",\"reason\":\"some reason\",\"amount\":\"200.00\",\"utr\":\"409876543210\",\"target_upi_id\":  \"deposit@test\", \"merchant_customer_id\":  \"aaaaaaa99-1290-3e9f-a08e-c03aedc68b35\"}\n\n</code></pre>\n<p>Once the payment is completed and we verify it, you will get a successful order status notification.</p>\n<p>You can also manually trigger a webhook for an order by using the “Resend callback” button in the back office.</p>\n<blockquote>\n<p>Depending on the payment method and flow an order can change not only its status but also the amount. Your system should be able to receive an order amount different from the amount initially requested and adjust the scope of service or product quantity respectively. You will notice that each order has a requested amount and an actual amount in our back office, but you would receive only one most actual amount in the webhook. In case your system does not accept different requested and actual amounts, please let us know about that during the integration process. </p>\n</blockquote>\n<blockquote>\n<p>If you offer digital value like airtime, wallet top-up, digital credit, etc, always confirm that you have not already delivered value for that transaction to avoid double fulfillments, especially, if you also use webhooks. </p>\n</blockquote>\n<p>It is recommended to store <code>order_id</code> in your system for reconciliation purposes.</p>\n","_postman_id":"478f97d5-dbaa-425b-83cb-0a6a7511f9ce"}],"id":"65eeec00-0963-4574-90b9-622289111fd7","description":"<p>All deposit, withdrawal, and webhook endpoints for the <strong>India (INR)</strong> market. Shared mechanics common to every market (authentication, response codes, order status transitions, go-live process) are documented separately below, outside this folder.</p>\n","_postman_id":"65eeec00-0963-4574-90b9-622289111fd7"},{"name":"🇦🇷 Argentina","item":[{"name":"📥 Deposit (Hosted page)","item":[{"name":"Create Deposit Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"9eedaecb-7caf-4383-bba8-2aa08e603256"}}],"id":"51038c66-6ebc-4968-aba3-3b9cb14a11ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"d9b3e84d-d952-48dd-a31f-c846cadbe3ef\",\n    \"merchant_customer_id\": \"f7f224bd-e7b1-4942-ba4c-8666688a5e3a\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/deposit/new","urlObject":{"path":["deposit","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"d2ce963b-229e-4e51-b0ba-ab5d6bc88e2e","name":"201 Created","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"62bc7bda-a6b5-4ad2-99f7-32b46bb9eacd\",\n    \"merchant_customer_id\": \"9729e74d-a58f-4b92-b266-27b93712568f\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/deposit/new"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"form_url\": \"https://example.com/payment-form?hash=example-hash\",\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"status\": \"new\"\n}"}],"_postman_id":"51038c66-6ebc-4968-aba3-3b9cb14a11ac"}],"id":"e5152a89-81ce-4e0f-bf00-7242640405c9","description":"<p>A deposit process for the Argentine market (ARS) via bank transfer. This requires creating an order, showing a payment form, and updating order status in your system.</p>\n<h3 id=\"argentina-specific-constraints\">Argentina-specific constraints</h3>\n<ul>\n<li><strong>Method</strong>: <code>bank_transfer</code> — the only method available for ARS (no UPI).</li>\n<li><strong>Currency</strong>: <code>ARS</code> (Argentine Peso only).</li>\n<li><strong>Amount</strong>: min 2000 ARS, max 500000 ARS (indicative, may vary by account configuration).</li>\n<li><strong>customer_phone</strong>: Argentine mobile format, regex <code>^\\+54[\\s-]?9(?:[\\s-]?\\d){10}$</code>. Example: <code>+54 9 11 1234 5678</code>.</li>\n<li><strong>cuit_cuil</strong> (required): customer's CUIT/CUIL tax ID, 11 digits, checksum-validated. Regex <code>^\\d{11}$</code>. Example: <code>20975324681</code>.</li>\n</ul>\n<h3 id=\"steps-to-make-a-deposit\">Steps to Make a Deposit</h3>\n<h4 id=\"step-1-create-an-order\">Step 1: Create an Order</h4>\n<ul>\n<li><strong>Description</strong>: Initiate the deposit by running <strong>Create Deposit Order</strong>, with <code>method: \"bank_transfer\"</code> and <code>currency: \"ARS\"</code>.</li>\n<li><strong>Action</strong>: Submit a request with the required details, including the customer's <code>cuit_cuil</code>.</li>\n<li><strong>Response</strong>: A successful response includes <code>order_id</code>, <code>form_url</code>, and <code>status</code>.</li>\n</ul>\n<p>Example request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"8ae4fd8a-ad2c-4fba-8f79-912352d1a999\",\n    \"merchant_customer_id\": \"3a8bfaa3-21d4-48b6-8806-ec977ec7446d\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}\n</code></pre>\n<p>Example response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"form_url\": \"https://example.com/payment-form?hash=example-hash\",\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"status\": \"new\"\n}\n</code></pre>\n<blockquote>\n<p>For security reasons, please keep <code>order_id</code> private and do not make it available to the public or end customers.</p>\n</blockquote>\n<h4 id=\"step-2-show-payment-form\">Step 2: Show Payment Form</h4>\n<ul>\n<li><strong>Description</strong>: Redirect the customer to the payment form using the returned <code>form_url</code>, or embed it via <strong>iframe</strong> (same integration as other markets — see the Support/Integration guide for the iframe snippet).</li>\n</ul>\n<h4 id=\"step-3-monitor-and-handle-order-status-changes\">Step 3: Monitor and Handle Order Status Changes</h4>\n<ul>\n<li><strong>Description</strong>: The order transitions through the same status set as other markets (<code>new</code>, <code>pending</code>, <code>success</code>, <code>failed</code>, <code>cancelled</code>, <code>refunded</code>, <code>expired</code>).</li>\n<li><strong>Action</strong>: Use webhooks or periodic API calls to track status. See the shared <strong>Order status check</strong>, <strong>Order statuses transitions</strong>, and <strong>🪝Webhooks</strong> sections for the full status definitions and payload shape — these are common across all markets.</li>\n</ul>\n","_postman_id":"e5152a89-81ce-4e0f-bf00-7242640405c9"},{"name":"📥 Deposit (host-to-host)","item":[{"name":"Create Deposit Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"20b28836-6d3c-4d7d-85f6-86cf82b4b0bf"}}],"id":"83e06e05-4c31-4881-9984-f171c04a264b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"traffic\": \"ftd\",\n    \"merchant_order_id\": \"81a07cb8-6538-417a-95ce-dc378414cca3\",\n    \"merchant_customer_id\": \"92206c32-3f8e-4ca2-9841-a00fa19339ad\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new","urlObject":{"path":["s2s","deposit","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"adf26e08-a649-425d-8372-b63724e7e69d","name":"201 Created","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"traffic\": \"ftd\",\n    \"merchant_order_id\": \"6f04211a-191b-442a-a5fc-a22daea18df7\",\n    \"merchant_customer_id\": \"8f6e7616-8665-44a9-882f-f31fc7f2dd00\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/new"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"wallet_address\": \"ars-test@test\",\n    \"wallet_name\": \"ARS-TEST- FTD\",\n    \"transaction_note\": \"xXE93\",\n    \"order_expiration_seconds\": \"600\",\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"status\": \"new\"\n}"}],"_postman_id":"83e06e05-4c31-4881-9984-f171c04a264b"},{"name":"Confirm Deposit Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"5063cc30-7c62-4081-b6c1-00fe7f69baa9"}}],"id":"5db06a9e-ca64-4f89-b157-fa02fda5c37f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"customer_transaction_id\": \"ars5326321452362214252856\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/confirm","urlObject":{"path":["s2s","deposit","confirm"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"005217bf-c93e-4c4d-bfe7-46c3b779c88f","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"customer_transaction_id\": \"ars5326321452362214252856\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/s2s/deposit/confirm"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"pending\"\n}"}],"_postman_id":"5db06a9e-ca64-4f89-b157-fa02fda5c37f"}],"id":"c484bd83-cb1a-45b8-9c8d-19dd5f6d5fc1","description":"<p>The Host-to-Host Deposit endpoint for the Argentine market (ARS) allows you to create and confirm bank-transfer orders on your own payment page, without redirecting the end customer.</p>\n<h3 id=\"argentina-specific-constraints\">Argentina-specific constraints</h3>\n<p>Same as the hosted-page flow: <code>method</code> fixed to <code>bank_transfer</code>, <code>currency</code> fixed to <code>ARS</code>, <code>cuit_cuil</code> required (11-digit, checksum-validated CUIT/CUIL). See <strong>📥 Deposit (Hosted page)</strong> for the full parameter table.</p>\n<h3 id=\"steps-to-make-a-deposit\">Steps to Make a Deposit</h3>\n<h4 id=\"step-1-create-an-order\">Step 1: Create an Order</h4>\n<p><code>POST https://api.zyntego.com/api/s2s/deposit/new</code></p>\n<p>Example request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"bank_transfer\",\n    \"amount\": 2000,\n    \"currency\": \"ARS\",\n    \"traffic\": \"ftd\",\n    \"merchant_order_id\": \"8ae4fd8a-ad2c-4fba-8f79-912352d1a999\",\n    \"merchant_customer_id\": \"3a8bfaa3-21d4-48b6-8806-ec977ec7446d\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"redirect_url\": \"https://merchant-website.com\",\n    \"cuit_cuil\": \"20975324681\"\n}\n</code></pre>\n<p>Example response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"wallet_address\": \"ars-test@test\",\n    \"wallet_name\": \"ARS-TEST- FTD\",\n    \"transaction_note\": \"xXE93\",\n    \"order_expiration_seconds\": \"600\",\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"status\": \"new\"\n}\n</code></pre>\n<h4 id=\"step-2-show-payment-form\">Step 2: Show Payment Form</h4>\n<ul>\n<li><strong>Description</strong>: Present the customer with your <strong>own payment form</strong>, displaying <code>wallet_address</code>, <code>wallet_name</code>, and <code>transaction_note</code> from the order response.</li>\n<li><strong>Action</strong>: Collect the customer's bank-transfer reference within the <code>order_expiration_seconds</code> window.</li>\n</ul>\n<h4 id=\"step-3-confirm-deposit-order\">Step 3: Confirm Deposit Order</h4>\n<p><code>POST https://api.zyntego.com/api/s2s/deposit/confirm</code></p>\n<p>Submit the transaction reference in <code>customer_transaction_id</code>. For ARS bank transfers this corresponds to the <strong>COELSA ID</strong> (the same identifier the deposit webhook later returns as <code>coelsa_id</code> — not <code>utr</code>, unlike UPI-based markets).</p>\n<p>Example request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"order_id\": \"869661e1-8552-4071-b6ba-95b37f7172ag\",\n    \"customer_transaction_id\": \"ars5326321452362214252856\"\n}\n</code></pre>\n<p>Example response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"status\": \"pending\"\n}\n</code></pre>\n<blockquote>\n<p>A 422 response indicates an issue (e.g. duplicate <code>customer_transaction_id</code>) — same error shape as other markets.</p>\n</blockquote>\n<p>See the shared <strong>Order status check</strong>, <strong>Order statuses transitions</strong>, and <strong>🪝Webhooks</strong> sections for full status definitions — these are common across all markets.</p>\n","_postman_id":"c484bd83-cb1a-45b8-9c8d-19dd5f6d5fc1"},{"name":"📤 Withdraw","item":[{"name":"Create Withdrawal Order","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"b5e0a47c-a2a0-47b8-8af5-320b6e3f0e75"}}],"id":"30329555-4784-4790-a521-c1ca0e1dc53d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 3000,\n    \"currency\": \"ARS\",\n    \"merchant_order_id\": \"58071e44-498f-4176-a85f-19c59333ea20\",\n    \"merchant_customer_id\": \"b6f6cf69-0263-444d-8a41-0d0bf893e303\",\n    \"customer_bank_account\": \"0000102030405060708090\",\n    \"customer_name\": \"paponpepe\",\n    \"customer_email\": \"paponpepe3@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new","urlObject":{"path":["withdraw","new"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"ff388ccb-df86-4e83-90f2-9a4819c1b786","name":"201 Created","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"method\": \"bank_transfer\",\n    \"amount\": 3000,\n    \"currency\": \"ARS\",\n    \"merchant_order_id\": \"23b8b0d4-10ec-404d-986f-7b0f980a4c5c\",\n    \"merchant_customer_id\": \"6c2287a4-9f7d-42f9-b797-9024dd264182\",\n    \"customer_bank_account\": \"0000102030405060708090\",\n    \"customer_name\": \"paponpepe\",\n    \"customer_email\": \"paponpepe3@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.zyntego.com/api/withdraw/new"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"764111-b2e6-4111-897e-5a11114a5370\",\n    \"status\": \"new\"\n}"}],"_postman_id":"30329555-4784-4790-a521-c1ca0e1dc53d"}],"id":"acbd1ea4-0874-4ce2-9e0d-fed7779043b0","description":"<p>The <strong>Withdraw</strong> endpoint enables you to create a transaction to process payouts to your customers via ARS bank transfer. Each request must be authenticated using your API key, following the same method as with deposit transactions.</p>\n<h3 id=\"argentina-specific-constraints\">Argentina-specific constraints</h3>\n<ul>\n<li><strong>Method</strong>: <code>bank_transfer</code> — the only method available for ARS.</li>\n<li><strong>Currency</strong>: <code>ARS</code> (Argentine Peso only).</li>\n<li><strong>Amount</strong>: min 5000 ARS, max 500000 ARS (indicative, may vary by account configuration).</li>\n<li><strong>customer_phone</strong>: Argentine mobile format, regex <code>^\\+54[\\s-]?9(?:[\\s-]?\\d){10}$</code>. Example: <code>+54 9 11 1234 5678</code>.</li>\n<li><strong>customer_bank_account</strong>: valid CBU/CVU, 22 digits, leading zeros allowed. Regex <code>^\\d{22}$</code>. Example: <code>0001234567890123456789</code>.</li>\n<li><strong>cuit_cuil</strong> (required): customer's CUIT/CUIL tax ID, 11 digits, checksum-validated. Regex <code>^\\d{11}$</code>.</li>\n</ul>\n<h3 id=\"steps-to-make-a-withdraw\">Steps to Make a Withdraw</h3>\n<h4 id=\"step-1-create-a-withdrawal-order\">Step 1: Create a Withdrawal Order</h4>\n<p><strong>Description:</strong> Initiate the payout by calling the Create Withdrawal Order endpoint. Include payment details such as customer information, the beneficiary's CBU/CVU, and the customer's <code>cuit_cuil</code>.\n<strong>Action:</strong> Submit a <code>POST</code> request with the required details, ensuring the use of your API key for authorization.\n<strong>Response:</strong> A successful response includes an <code>order_id</code> and the initial transaction status (<code>new</code>).\n<strong>Important:</strong> Securely store the <code>order_id</code>, <code>amount</code>, and <code>status</code> for future status updates and transaction reconciliation.</p>\n<p>Example request body:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"bank_transfer\",\n    \"amount\": 3000,\n    \"currency\": \"ARS\",\n    \"merchant_order_id\": \"8ae4fd8a-ad2c-4fba-8f79-912352d1a888\",\n    \"merchant_customer_id\": \"3a8bfaa3-21d4-48b6-8806-ec977ec7446d\",\n    \"customer_bank_account\": \"0000102030405060708090\",\n    \"customer_name\": \"paponpepe\",\n    \"customer_email\": \"paponpepe3@gmail.com\",\n    \"customer_phone\": \"+5491234567890\",\n    \"status_url\": \"https://webhook.site/cc6a5b7c-330b-4a2f-a90e-3cdc8cdaf8df\",\n    \"traffic\": \"ftd\",\n    \"cuit_cuil\": \"20975324681\"\n}\n</code></pre>\n<p>Example response:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"order_id\": \"764111-b2e6-4111-897e-5a11114a5370\",\n    \"status\": \"new\"\n}\n</code></pre>\n<blockquote>\n<p>For security reasons, please keep <code>order_id</code> private and do not make it available to the public or end customers.</p>\n</blockquote>\n<p>In case of an error in the request data, our server will respond with a respective Response code and message.</p>\n<h4 id=\"step-2-monitor-the-order-status\">Step 2: Monitor the Order Status</h4>\n<p><strong>Description:</strong> Track the withdrawal order's progress through the same status set as other markets (<code>new</code>, <code>pending</code>, <code>success</code>, <code>failed</code>). Each update is sent to the merchant-hosted <code>status_url</code> provided during order creation, with <code>coelsa_id</code> (not <code>utr</code>) identifying the bank-transfer reference.\n<strong>Action:</strong> Use the <code>order_id</code> to monitor the transaction status via webhook callbacks or API queries.</p>\n<p>See the shared <strong>Order status check</strong>, <strong>Order statuses transitions</strong>, and <strong>🪝Webhooks</strong> sections for full status definitions — these are common across all markets.</p>\n","_postman_id":"acbd1ea4-0874-4ce2-9e0d-fed7779043b0"},{"name":"Payment & Withdrawal Parameters","item":[],"id":"43c01b1a-bcb6-470b-a844-f606135a2aa6","description":"<h3 id=\"deposit--payment-parameters\">Deposit — Payment Parameters</h3>\n<p><strong>General Constraints</strong></p>\n<ul>\n<li>Method: <code>bank_transfer</code> (only available option)</li>\n<li>Currency: <code>ARS</code> (Argentine Peso only)</li>\n</ul>\n<p><strong>Amount</strong></p>\n<ul>\n<li>Minimum: <code>2000 ARS</code></li>\n<li>Maximum: <code>500000 ARS</code></li>\n<li>⚠️ Limits are indicative and may vary depending on account configuration.</li>\n</ul>\n<p><strong>Customer Phone</strong> (<code>customer_phone</code>)</p>\n<ul>\n<li>Format: Argentine standard (mobile with country code)</li>\n<li>Regex: <code>^\\+54[\\s-]?9(?:[\\s-]?\\d){10}$</code></li>\n<li>Example: <code>+54 9 11 1234 5678</code></li>\n</ul>\n<p><strong>CUIT / CUIL</strong> (<code>cuit_cuil</code>)</p>\n<ul>\n<li>Required: Yes</li>\n<li>Format: 11 digits, includes checksum verification (mandatory)</li>\n<li>Regex: <code>^\\d{11}$</code></li>\n<li>Example: <code>20304567891</code></li>\n</ul>\n<hr />\n<h3 id=\"withdrawal--payment-parameters\">Withdrawal — Payment Parameters</h3>\n<p><strong>General Constraints</strong></p>\n<ul>\n<li>Method: <code>bank_transfer</code> (only available option)</li>\n<li>Currency: <code>ARS</code> (Argentine Peso only)</li>\n</ul>\n<p><strong>Amount</strong></p>\n<ul>\n<li>Minimum: <code>5000 ARS</code></li>\n<li>Maximum: <code>500000 ARS</code></li>\n<li>⚠️ Limits are indicative and may vary depending on account configuration.</li>\n</ul>\n<p><strong>Customer Phone</strong> (<code>customer_phone</code>) — same format as deposit, see above.</p>\n<p><strong>Customer Bank Account</strong> (<code>customer_bank_account</code>)</p>\n<ul>\n<li>Description: Valid CBU / CVU</li>\n<li>Length: 22 digits, leading zeros allowed</li>\n<li>Regex: <code>^\\d{22}$</code></li>\n<li>Example: <code>0001234567890123456789</code></li>\n</ul>\n","_postman_id":"43c01b1a-bcb6-470b-a844-f606135a2aa6"},{"name":"🪝 Webhooks","item":[],"id":"f13676a7-902a-41a6-93e7-ad6b8f19022c","description":"<p>Webhook mechanics (retries, signature validation, endpoint requirements) are the same as described in the main <strong>Webhooks</strong> section above. The field names below are specific to the ARS Bank Transfer method — note there is no <code>utr</code> or <code>target_upi_id</code> here; use <code>coelsa_id</code> instead.</p>\n<h3 id=\"deposit-webhook\">Deposit Webhook</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"order_id\": \"849655cf-ceba-49bc-951a-cbfbf8d63274\",\n  \"merchant_order_id\": \"O_XVajPtgGFk173LluM5oKb\",\n  \"status\": \"success\",\n  \"reason\": \"some reason\",\n  \"amount\": \"200.00\",\n  \"coelsa_id\": \"409876543210\",\n  \"merchant_customer_id\": \"aaaaaaa99-1290-3e9f-a08e-c03aedc68b35\"\n}\n\n</code></pre>\n<h3 id=\"withdrawal-webhook\">Withdrawal Webhook</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe2\",\n  \"merchant_order_id\": \"ABC00001\",\n  \"status\": \"failed\",\n  \"reason\": \"some reason\",\n  \"amount\": \"300\",\n  \"coelsa_id\": \"409876543210\",\n  \"error_code\": \"ERR_001\",\n  \"error_message\": \"Payout service under maintenance. Try again later.\"\n}\n\n</code></pre>\n<blockquote>\n<p><code>error_code</code> and <code>error_message</code> are present only when <code>status</code> is <code>failed</code>.</p>\n</blockquote>\n","_postman_id":"f13676a7-902a-41a6-93e7-ad6b8f19022c"}],"id":"6b85f33b-8c4a-4ff4-8981-ca120da53844","description":"<p>All deposit, withdrawal, and webhook endpoints for the <strong>Argentina (ARS) — bank transfer</strong> method. Follows the same request/webhook mechanics described for India (authentication, retries, signature validation, general error handling, go-live process) — only the endpoints, fields, and constraints specific to ARS bank transfer are listed here.</p>\n","_postman_id":"6b85f33b-8c4a-4ff4-8981-ca120da53844"},{"name":"Balance","item":[{"name":"Balance check","id":"3e52069f-a51f-4956-ba4a-0d4acff1f97b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/balance?currency=","urlObject":{"path":["balance"],"host":["https://api.zyntego.com/api"],"query":[{"key":"currency","value":""}],"variable":[]}},"response":[{"id":"494f60ca-ce54-4637-906f-5485b60355f2","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://api.zyntego.com/api/balance?currency=","host":["https://api.zyntego.com/api"],"path":["balance"],"query":[{"key":"currency","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:26:56 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=Ulhi%2F9AHv%2FQtwpUDxb6VOYwNwXL4fWYHtiDkVHbp6uK%2BKK%2FBeJT6zUbfuQXPDjqYUC6KtNj01arw4PYqX7eFs2VRKEDDKNqyaPe1kYkVal%2F5%2BMxkP7dIOGvcrA%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"955524861a7bccb2-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"account_id\": \"acc_29d774b1\",\n    \"currency\": \"INR\",\n    \"available_balance\": \"-8420.35\",\n    \"total_balance\": \"15230.10\"\n}"},{"id":"95d63543-ee01-4f9d-89bc-1b2d7ee61531","name":"401 Unauthorized","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://api.zyntego.com/api/balance?currency=","host":["https://api.zyntego.com/api"],"path":["balance"],"query":[{"key":"currency","value":""}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:27:46 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=ZO7b2gBzW0DMIOw3VeG2pZ%2B7aOg9Pn7AF%2FdDRdHwP62K1C59socmWhi%2BWzq3Mdbo6bKz%2BOkH%2FOZAdJrQ%2BgMM8iL32iTlkqRD3iatH66AMsNktnLregyze9RV8Q%3D%3D\"}]}"},{"key":"CF-RAY","value":"955525c79875ccb2-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\"\n}"}],"_postman_id":"3e52069f-a51f-4956-ba4a-0d4acff1f97b"}],"id":"69a61575-be74-41fc-8932-6244a4a790be","description":"<p>The <strong>Balance</strong> endpoint provides access to both your total and available balance. Please remember to authenticate each request with the API key in the same way as Deposits.</p>\n<blockquote>\n<p>The default balance endpoint returns INR currency if not specified. To specify currency, use the param  in the request.</p>\n</blockquote>\n","_postman_id":"69a61575-be74-41fc-8932-6244a4a790be"},{"name":"Amount mismatch handling","item":[],"id":"7222eb87-5ccb-4761-b14f-cc4618e940c8","description":"<p>The amount your customer actually pays may differ from the amount originally requested in the order. This is called an <strong>amount mismatch</strong>.</p>\n<p>Your account can be configured to handle amount mismatches in one of the following ways:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Mode</th>\n<th>Behavior</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>Accept mismatches</strong></td>\n<td>The order can still complete even if the paid amount differs from the requested one. In this case, always rely on the <code>amount</code> field in the webhook — it reflects what the customer actually paid, not the originally requested amount</td>\n</tr>\n<tr>\n<td><strong>Reject mismatches</strong></td>\n<td>The order only completes if the paid amount matches the requested amount exactly</td>\n</tr>\n<tr>\n<td><strong>Accept within tolerance</strong></td>\n<td>Mismatches are accepted only within an agreed deviation — anything beyond it is rejected</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>If your integration assumes the order amount never changes, make sure to update this assumption — always read <code>amount</code> from the webhook payload as the source of truth for what was actually paid.</p>\n</blockquote>\n<p>This is configured on the Globalit Systems side, not by the merchant. Let your Globalit Systems contact know which mode fits your business, and we'll set it up for your account.</p>\n","_postman_id":"7222eb87-5ccb-4761-b14f-cc4618e940c8"},{"name":"Order status check","item":[{"name":"Status check","id":"d0d6c1a3-fc2f-4851-8bd7-6ed2267dd5fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}","urlObject":{"path":["order","status","{{order_id}}"],"host":["https://api.zyntego.com/api"],"query":[],"variable":[]}},"response":[{"id":"1091605f-12f8-4d83-87d5-e9b3b32c7df5","name":"200 Success order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:35:11 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"58"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=OshPR%2F5%2B2ZjqnHIjil7XqTMo%2FYQusXHOxQahuNoyJ0MN0CDa0CUJDE3qJ0eJ5iB7u6uQ%2F%2F2vTZaNFbsZvdF5eEt0KUTM2vRot6HK7BsZUJhORzmKizsuFFo%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"9555309b0f9ca0a1-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"5fd7ec21-bfa1-4c12-b204-aebe13cf155f\",\n    \"merchant_order_id\": \"f1b5668a-cbdc-48e5-a858-c1b8e0cd29ea\",\n    \"status\": \"success\",\n    \"reason\": \"pending -> success\",\n    \"amount\": \"345.00\",\n    \"utr\": \"456789123457\"\n}"},{"id":"cf4b85aa-5e1e-4f68-a17f-dd910a0e9596","name":"200 Expired order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:32:32 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"59"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=YwqGHHej9HXiWmdueUAPVKGUyikHCJ9rwZIpNM%2B8ZbgE8mO0CY3s1rDkxbCeRm5IqAs5ooGvjf1eVe2pFkOMEeP3WrOGWMQRmOHBpBR9mR9GQnW62QcHgfMZXw%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"95552cbc4f66b3fe-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"75df4f3a-e1a7-4b0a-b3a8-8ce8405a7adb\",\n    \"merchant_order_id\": \"8a42590b-0390-4be4-ac8b-cbe0fa3193a8\",\n    \"status\": \"expired\",\n    \"reason\": \"new -> expired: Form expired\",\n    \"amount\": \"2000.00\",\n    \"utr\": null\n}"},{"id":"90b62847-5f22-4330-92cd-20420bbfba2d","name":"200 Failed order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:33:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"58"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=g2sVVS8CAE1P5lj610pF3eW20MjvtEsTvUmOkhn3xLkAFcLdJ8mSWl%2FiLIXBLVq0Vf1FtssaIAFxN8HlWrgeiY1DnTCtuVLD3NPkkEM5qJ1%2FVdXef4YU6EDLQA%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"95552df12f82b3fe-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"066771d5-975f-4ede-8ec2-49bdd0de0738\",\n    \"merchant_order_id\": \"e9061341-14a8-4d2f-b594-a9d518dc87ec\",\n    \"status\": \"failed\",\n    \"reason\": \"new -> cancelled: By user\",\n    \"amount\": \"555.00\",\n    \"utr\": null\n}"},{"id":"206426ef-1a60-4bd1-bbee-a5035f9ebf21","name":"200 New order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:34:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"59"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=LM7IbRmUSJt9PQQGbHITNZThCfuY9dSYcCnEn13ar4q9RZjerQRKP%2ByBKmpcQfVPCPkCV6Kkab4L3b4STWGQkvlT70ZWBIcovCiOHxszuI2zV3hDlHIcja0%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"95552f6cfe2da0a1-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"da3a460b-7f04-4bf8-8e03-fd4fe398cc1f\",\n    \"merchant_order_id\": \"6dd41604-c662-486d-bcfe-889723e5693d\",\n    \"status\": \"new\",\n    \"reason\": \"\",\n    \"amount\": \"444.00\",\n    \"utr\": null\n}"},{"id":"6364553a-902c-4040-8c67-068d8cdded0d","name":"200 Pending order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:36:06 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"59"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=9ZTF8e3s5BmicQWtZOFhFty3ZQIdoo7i5OPnBYLbgHwKwwofix5hFOhEBZM%2BdXfXzlFWO6%2Fwj%2B9tcwEVjSkplRgWnekm%2FU5Cm1sASaUOR%2F%2FYuGqM%2BhgT%2BNM%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"955531f48cc6a0a1-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"da3a460b-7f04-4bf8-8e03-fd4fe398cc1f\",\n    \"merchant_order_id\": \"6dd41604-c662-486d-bcfe-889723e5693d\",\n    \"status\": \"pending\",\n    \"reason\": \"new -> pending: Order is pending\",\n    \"amount\": \"444.00\",\n    \"utr\": null\n}"},{"id":"d18609c5-e556-4a8c-90bc-1a5a4d368503","name":"200 Chargeback order","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:38:03 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Ratelimit-Limit","value":"60"},{"key":"X-Ratelimit-Remaining","value":"59"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=BwYN5tZilD7dShTLmvvved9GeydZMGtt1DNLQtk5lPtnQFwdh%2Fpo892TO18YLI8%2F6Wih4yAwhZFGNR7glx30ewXejoqS53yPCX5%2FjWrwCJQQIQnREmNZeHYpXw%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"955534ce2f2accb4-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"order_id\": \"e2430e2c-dce6-4981-80bd-950304673226\",\n    \"merchant_order_id\": \"2cd17b79-5ea6-45c6-a1b6-4b63f0bea44e\",\n    \"status\": \"chargeback\",\n    \"reason\": \"test reason\",\n    \"amount\": \"300.00\",\n    \"utr\": null\n}"},{"id":"8fd1a09a-8aed-413c-ac6e-e4b03139d63c","name":"401 Unauthorized","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:38:42 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=ztBf9acg5%2BhFQoLjEgS5rbPnwdGvhHrdqmU9JPBs0nakZ%2FaIQzPVlqvgySN23z8YciMye3ukXt6IBpzj%2FK973pBJL8YkAhe4RzCxxsFzEWElmg5QVPUMjejYzA%3D%3D\"}]}"},{"key":"CF-RAY","value":"955535c6ea64ccb4-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\"\n}"},{"id":"c7ac3164-7711-48e1-bac3-92185f1f5cb4","name":"404 Order not found","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.zyntego.com/api/order/status/{{order_id}}"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 25 Jun 2025 14:39:36 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Vary","value":"Origin"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"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=W%2B1zz64u2CpajA9OFF4aeTHfUzTaH%2Bs7S3aVj4nTjPBdQ%2FOcvgrtUEKtHp99qRoOiCX%2FI7IQnbzpvR6pTVzEIeTjesvdhYMrh106TL%2B%2FZK3VsFvlVd%2BzdWH1ow%3D%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"955537190bd3ccb4-MAN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"The route api/order/status/e2430e2c-dce6-4981-80bd-950304673 could not be found.\",\n    \"exception\": \"Symfony\\\\Component\\\\HttpKernel\\\\Exception\\\\NotFoundHttpException\",\n    \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Routing/AbstractRouteCollection.php\",\n    \"line\": 45,\n    \"trace\": [\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Routing/CompiledRouteCollection.php\",\n            \"line\": 144,\n            \"function\": \"handleMatchedRoute\",\n            \"class\": \"Illuminate\\\\Routing\\\\AbstractRouteCollection\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Routing/Router.php\",\n            \"line\": 763,\n            \"function\": \"match\",\n            \"class\": \"Illuminate\\\\Routing\\\\CompiledRouteCollection\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Routing/Router.php\",\n            \"line\": 750,\n            \"function\": \"findRoute\",\n            \"class\": \"Illuminate\\\\Routing\\\\Router\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Routing/Router.php\",\n            \"line\": 739,\n            \"function\": \"dispatchToRoute\",\n            \"class\": \"Illuminate\\\\Routing\\\\Router\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php\",\n            \"line\": 201,\n            \"function\": \"dispatch\",\n            \"class\": \"Illuminate\\\\Routing\\\\Router\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 170,\n            \"function\": \"{closure:Illuminate\\\\Foundation\\\\Http\\\\Kernel::dispatchToRouter():198}\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Kernel\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/sentry/sentry-laravel/src/Sentry/Laravel/Http/FlushEventsMiddleware.php\",\n            \"line\": 13,\n            \"function\": \"{closure:Illuminate\\\\Pipeline\\\\Pipeline::prepareDestination():168}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Sentry\\\\Laravel\\\\Http\\\\FlushEventsMiddleware\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/sentry/sentry-laravel/src/Sentry/Laravel/Http/SetRequestIpMiddleware.php\",\n            \"line\": 45,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Sentry\\\\Laravel\\\\Http\\\\SetRequestIpMiddleware\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/sentry/sentry-laravel/src/Sentry/Laravel/Http/SetRequestMiddleware.php\",\n            \"line\": 31,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Sentry\\\\Laravel\\\\Http\\\\SetRequestMiddleware\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/app/Http/Middleware/InjectJsonAcceptTypeHeader.php\",\n            \"line\": 14,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"App\\\\Http\\\\Middleware\\\\InjectJsonAcceptTypeHeader\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/app/Http/Middleware/XRequestId.php\",\n            \"line\": 17,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"App\\\\Http\\\\Middleware\\\\XRequestId\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/app/Http/Middleware/RequestHeaderXTimeZone.php\",\n            \"line\": 25,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"App\\\\Http\\\\Middleware\\\\RequestHeaderXTimeZone\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Http/Middleware/HandleCors.php\",\n            \"line\": 62,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/app/Http/Middleware/HandleCorsWithMids.php\",\n            \"line\": 22,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Http\\\\Middleware\\\\HandleCors\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"App\\\\Http\\\\Middleware\\\\HandleCorsWithMids\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/TransformsRequest.php\",\n            \"line\": 21,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/ConvertEmptyStringsToNull.php\",\n            \"line\": 31,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\TransformsRequest\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\ConvertEmptyStringsToNull\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/TransformsRequest.php\",\n            \"line\": 21,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/TrimStrings.php\",\n            \"line\": 51,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\TransformsRequest\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\TrimStrings\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Http/Middleware/ValidatePostSize.php\",\n            \"line\": 27,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Http\\\\Middleware\\\\ValidatePostSize\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/PreventRequestsDuringMaintenance.php\",\n            \"line\": 110,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\PreventRequestsDuringMaintenance\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Http/Middleware/HandleCors.php\",\n            \"line\": 62,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Http\\\\Middleware\\\\HandleCors\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Http/Middleware/TrustProxies.php\",\n            \"line\": 58,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/app/Http/Middleware/TrustProxies.php\",\n            \"line\": 36,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Http\\\\Middleware\\\\TrustProxies\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"App\\\\Http\\\\Middleware\\\\TrustProxies\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/InvokeDeferredCallbacks.php\",\n            \"line\": 22,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Middleware\\\\InvokeDeferredCallbacks\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/sentry/sentry-laravel/src/Sentry/Laravel/Tracing/Middleware.php\",\n            \"line\": 79,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 209,\n            \"function\": \"handle\",\n            \"class\": \"Sentry\\\\Laravel\\\\Tracing\\\\Middleware\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php\",\n            \"line\": 127,\n            \"function\": \"{closure:{closure:Illuminate\\\\Pipeline\\\\Pipeline::carry():184}:185}\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php\",\n            \"line\": 176,\n            \"function\": \"then\",\n            \"class\": \"Illuminate\\\\Pipeline\\\\Pipeline\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php\",\n            \"line\": 145,\n            \"function\": \"sendRequestThroughRouter\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Kernel\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/vendor/laravel/framework/src/Illuminate/Foundation/Application.php\",\n            \"line\": 1220,\n            \"function\": \"handle\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Http\\\\Kernel\",\n            \"type\": \"->\"\n        },\n        {\n            \"file\": \"/var/www/public/index.php\",\n            \"line\": 18,\n            \"function\": \"handleRequest\",\n            \"class\": \"Illuminate\\\\Foundation\\\\Application\",\n            \"type\": \"->\"\n        }\n    ]\n}"}],"_postman_id":"d0d6c1a3-fc2f-4851-8bd7-6ed2267dd5fd"}],"id":"d9cdaa43-b145-4da5-ae14-41570ae32aa6","description":"<p>To get current order status and initiate a webhook to your server you can use Order status check endpoint. Please make sure that you use the standard authentication with your API key. Keep in mind that the primary method for receiving status updates is through webhooks; this endpoint should only be used in rare cases where the webhook was not received. Please note that this endpoint is rate-limited to 60 requests per minute.</p>\n<h4 id=\"by-order-id\">By Order ID</h4>\n<p><strong>Request:</strong> <strong><code>GET</code></strong> https://api.zyntego.com/api/order/status/{{order_id}}</p>\n<p>No JSON body is required. Parameter {{order_id}} implies Zyntego order ID, not merchant’s.</p>\n<p><strong>Response</strong><br />In case of a successful result, you will receive a 200 response and JSON with order details:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"order_id\": \"c2f0f71a-6f3f-4d65-be01-aa6b0f86cbe2\",\n    \"merchant_order_id\": \"ABC00001\",\n    \"status\": \"success\",\n    \"reason\": \"some reason\",\n    \"amount\": \"300\",\n    \"utr\": \"409876543210\"\n}\n\n</code></pre>\n<p>Simultaneously a webhook with order status to your status URL will be initiated.</p>\n<p>In case of a failed result, you will receive a 4 response code and JSON with details:</p>\n<h4 id=\"by-merchant-order-id\"><strong>By Merchant Order ID</strong></h4>\n<p>Request: <strong><code>GET</code></strong> https://api.zyntego.com/api/merchantorder/status/{{merchant_order_id}}</p>\n<p>No JSON body is required. Parameter {{merchant_order_id}} implies the Merchant’s Order ID, not Zyntego’s.</p>\n","_postman_id":"d9cdaa43-b145-4da5-ae14-41570ae32aa6"},{"name":"Response codes","item":[],"id":"2a9d5caa-0011-435a-92d9-da2535114891","description":"<p>Our API is RESTful and as such, uses conventional HTTP response codes to indicate the success or failure of requests. Some of the most common response examples include:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Response code</th>\n<th>Error message</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong><code>200</code></strong></td>\n<td>n/a</td>\n<td>The request has been successful.</td>\n</tr>\n<tr>\n<td><code>201</code></td>\n<td>n/a</td>\n<td>The request has been fulfilled and a new resource has been created as a result.</td>\n</tr>\n<tr>\n<td><code>401</code></td>\n<td>Unauthorized</td>\n<td>Please use the correct API key and format to authorize your requests.</td>\n</tr>\n<tr>\n<td><code>403</code></td>\n<td>X.X.X.X is not white listed</td>\n<td>Please whitelist your IP. To accept requests the merchant’s IPs must be whitelisted through back office or tech support.</td>\n</tr>\n<tr>\n<td><code>404</code></td>\n<td>The route … could not be found</td>\n<td>The resource has not been found.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>invalid request  <br />Method \\\"...\\\" is not valid</td>\n<td>The requested method is not valid or configured.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The … field is required.</td>\n<td>Your request does not contain the required parameter (field). Please double-check the request that is being sent.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>invalid request  <br />No available wallets found for method: …</td>\n<td>The method is not fully configured for processing. Please raise an issue with the tech support.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The amount field must be an integer.</td>\n<td>Wrong amount format, please make sure that the requested amount is an integer without a decimal.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The amount field must be at least … .</td>\n<td>The minimum amount requirement for the method is not met. Please check with the setup sheet or the tech support.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The amount field must not be greater than … .</td>\n<td>The maximum amount requirement for the method is not met. Please check with the setup sheet or the tech support.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>Currency \\\"...\\\" is not valid</td>\n<td>Please check that this currency is configured for the merchant.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The … field must not be greater than … characters</td>\n<td>The indicated parameter is longer than accepted.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>The … field must be a valid … .</td>\n<td>The requested value is in the wrong format, please check API documentation for reference.</td>\n</tr>\n<tr>\n<td><code>422</code></td>\n<td>Customer transaction ID exists</td>\n<td>A duplicated customer transaction ID has been sent in the request. It must be unique for each order.</td>\n</tr>\n<tr>\n<td><code>402</code></td>\n<td>User is blocked</td>\n<td>Our system also includes a mechanism to block malicious users. For this purpose, you will have access to a dedicated group channel with our risk management team, where you will receive information about blocked users and can contact the team directly if needed.</td>\n</tr>\n<tr>\n<td><code>5xx</code></td>\n<td>Server error</td>\n<td>All 5xx response codes should be investigated through our tech support.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"2a9d5caa-0011-435a-92d9-da2535114891"},{"name":"Order statuses transitions","item":[],"id":"e1660519-5553-4e15-aa09-94552dd20a6e","description":"<img src=\"https://content.pstmn.io/25c8c781-f47f-45c4-8cec-53c4068d6fd9/U2NyZWVuc2hvdCAyMDI1LTA2LTI0IGF0IDE2LjMxLjI4LnBuZw==\" width=\"616\" height=\"352\" />\n\n<p>Zyntego gateway comes with an order status transition concept that allows a merchant to get information on the current state of a payment, i.e. if funds have been transferred or if a customer canceled the transaction etc.</p>\n<p>Based on the dedicated status that is always returned through our API, you may take appropriate actions, such as delivering the service, contacting the customer for clarification or similar.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Deposit orders</th>\n<th>Withdrawal orders</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>New:</strong>  <br />- New-&gt;Pending  <br />- New-&gt;Cancelled  <br />- New-&gt;Expired  <br />- New-&gt;Success  <br />- New-&gt;Failed  <br />  <br /><strong>Pending:</strong>  <br />- Pending-&gt;Success  <br />- Pending-&gt;Failed  <br />  <br /><strong>Expired:</strong>  <br />- Expired-&gt;Failed  <br />- Expired-&gt;Success  <br />  <br /><strong>Cancelled:</strong>  <br />- Cancelled-&gt;Failed  <br />- Cancelled-&gt;Success  <br />  <br /><strong>Failed:</strong>  <br />- Failed-&gt;Success  <br />- Success:</td>\n<td><strong>New:</strong>  <br />- New-&gt;Pending  <br />- New-&gt;Success  <br />- New-&gt;Failed  <br />  <br /><strong>Pending:</strong>  <br />- Pending-&gt;Success  <br />- Pending-&gt;Failed  <br />  <br /><strong>Success:</strong>  <br />- Success-&gt;Failed  <br />- Success-&gt;Refunded</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"e1660519-5553-4e15-aa09-94552dd20a6e"},{"name":"✅ Go-live checklist","item":[],"id":"acca81fd-1e09-4050-be32-af41d2e136a2","description":"<p>Please refer to this checklist to ensure a smooth launch of your live payment processing:</p>\n<ul>\n<li><p>Complete and test integration in live mode including edge cases:</p>\n<ul>\n<li><p>Deposit order creation</p>\n</li>\n<li><p>Withdrawal order creation</p>\n</li>\n<li><p>Incomplete data</p>\n</li>\n<li><p>Invalid data</p>\n</li>\n<li><p>Duplicate data</p>\n</li>\n</ul>\n</li>\n<li><p>Make sure your application handles all errors</p>\n</li>\n<li><p>Make sure you have proper logging of requests and responses</p>\n</li>\n<li><p>Make sure your status URL is publicly available</p>\n</li>\n<li><p>Make sure you send the status URL with each order</p>\n</li>\n<li><p>Make sure that you validate our webhook signature</p>\n</li>\n<li><p>Make sure you set respective order (transaction) status and amount on your side once new webhook is received from our server</p>\n</li>\n<li><p>Make sure that you deliver/deduct goods, services, or digital credit once receive a successful order status callback from our server</p>\n</li>\n<li><p>Make sure all your production server’s IPs are whitelisted on our side</p>\n</li>\n<li><p>Make sure all our production server’s IPs are whitelisted on your side (if required)</p>\n</li>\n<li><p>Make sure you have access to our back office and can track all orders and their statuses</p>\n</li>\n<li><p>Arrange the time and date of the start of processing with our tech team</p>\n</li>\n<li><p>Get the green light from our tech team that you can start live processing</p>\n</li>\n<li><p>Monitor first live customer transactions in both your and our system</p>\n</li>\n</ul>\n","_postman_id":"acca81fd-1e09-4050-be32-af41d2e136a2"},{"name":"Chargeback","item":[],"id":"b39cd470-cc1f-47ab-8a42-496920ff43ab","description":"<h1 id=\"technical-specification-chargebacks\">Technical Specification Chargeback's</h1>\n<h2 id=\"status-handling\">Status Handling</h2>\n<p>When a previously successful <strong>deposit transaction</strong> is identified as a <strong>chargeback</strong>, the order status is updated as follows:</p>\n<ul>\n<li><p><strong>Previous status:</strong> <code>success</code></p>\n</li>\n<li><p><strong>New status:</strong> <code>chargeback</code></p>\n</li>\n<li><p><strong>Reason value -</strong> here will be a specific reason for the chargeback</p>\n</li>\n</ul>\n<hr />\n<h2 id=\"webhook-notification\">Webhook Notification</h2>\n<p>When the transaction status changes to <code>chargeback</code>, the merchant system receives a webhook notification.</p>\n<h3 id=\"payload-example\">Payload Example</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"order_id\": \"849655cf-ceba-49bc-951a-cbfbf8d63274\",\n  \"merchant_order_id\": \"O_XVajPtgGFk173LluM5oKb\",\n  \"status\": \"chargeback\",\n  \"reason\": \"chargeback\", // ask support for proper resaon if needed\n  \"amount\": \"200.00\",\n  \"utr\": \"409876543210\",\n  \"target_upi_id\": \"deposit@test\",\n  \"merchant_customer_id\": \"aaaaaaa99-1290-3e9f-a08e-c03aedc68b35\",\n  \"claim_id\": \"&lt;cyber_complaint_id&gt;\"\n}\n\n</code></pre><hr />\n<h2 id=\"payload-fields-description\">Payload Fields Description</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>order_id</td>\n<td>string</td>\n<td>Internal order identifier</td>\n</tr>\n<tr>\n<td>merchant_order_id</td>\n<td>string</td>\n<td>Merchant order identifier</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Current order status (<code>chargeback</code>)</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>Status change reason</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>string</td>\n<td>Chargeback amount (equals original successful deposit amount)</td>\n</tr>\n<tr>\n<td>utr</td>\n<td>string</td>\n<td>Bank transaction reference (UTR)</td>\n</tr>\n<tr>\n<td>target_upi_id</td>\n<td>string</td>\n<td>Target UPI ID used for deposit</td>\n</tr>\n<tr>\n<td>merchant_customer_id</td>\n<td>string</td>\n<td>Merchant-side customer identifier</td>\n</tr>\n<tr>\n<td>claim_id</td>\n<td>string</td>\n<td>complaint reference ID</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"chargeback-processing-flow\">Chargeback Processing Flow</h2>\n<ol>\n<li><p>A complaint is detected for an account.</p>\n</li>\n<li><p>Related transaction is identified.</p>\n</li>\n<li><p>Transaction data is verified:</p>\n<ul>\n<li><p>UTR</p>\n</li>\n<li><p>Amount</p>\n</li>\n<li><p>Order ID</p>\n</li>\n<li><p>Merchant Customer ID</p>\n</li>\n</ul>\n</li>\n<li><p>Supporting documents (PDF + screenshot) are attached internally.</p>\n</li>\n<li><p>Order status is updated:</p>\n<ul>\n<li><code>success</code> → <code>chargeback</code></li>\n</ul>\n</li>\n<li><p>Webhook notification is sent to the merchant system.</p>\n</li>\n</ol>\n<hr />\n<h2 id=\"important-integration-notes\">Important Integration Notes</h2>\n<ul>\n<li><p>Chargeback events are delivered only via webhook.</p>\n</li>\n<li><p>Merchants should handle <code>chargeback</code> status as a final state.</p>\n</li>\n<li><p><code>claim_id</code> can be used for reconciliation and support communication.</p>\n</li>\n<li><p>Amount value always reflects the original credited deposit amount.</p>\n</li>\n</ul>\n","_postman_id":"b39cd470-cc1f-47ab-8a42-496920ff43ab"},{"name":"Intent","item":[],"id":"a3aeab84-ab39-4efa-8078-ea7aadd645f6","description":"<h1 id=\"intent-h2h\">Intent H2H</h1>\n<p><strong>1. Approval</strong></p>\n<ul>\n<li>Before using Intent H2H, <strong>get approval from the Operations team</strong>.</li>\n</ul>\n<p><strong>2. Request URL</strong></p>\n<ul>\n<li>Use the same URL as for regular deposits:</li>\n</ul>\n<p>https://api.zyntego.com/api/api/deposit/new</p>\n<p><strong>3. Traffic Type</strong></p>\n<ul>\n<li>Must be set to:</li>\n</ul>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">\"traffic\": \"vip\"\n\n</code></pre>\n<ul>\n<li>Applies to <strong>both FTD and STD users</strong>.</li>\n</ul>\n<p><strong>4. Request Body</strong></p>\n<ul>\n<li>Same format as regular deposits. Example:</li>\n</ul>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"method\": \"upi\",\n    \"amount\": 200,\n    \"currency\": \"INR\",\n    \"customer_email\": \"peter-pen@gmail.com\",\n    \"customer_phone\": \"+919876543210\",\n    \"customer_name\": \"Peter Pen\",\n    \"merchant_order_id\": \"unique_transaction_id\",\n    \"merchant_customer_id\": \"unique_customer_id\",\n    \"status_url\": \"your_webhook_url\",\n    \"redirect_url\": \"your_redirect_url\",\n    \"traffic\": \"vip\"\n}\n\n</code></pre>\n<p><strong>5. Important Notes</strong></p>\n<ul>\n<li><p><code>merchant_order_id</code> and <code>merchant_customer_id</code> <strong>must be unique</strong> for each transaction.</p>\n</li>\n<li><p>All other fields follow the standard deposit rules.</p>\n</li>\n</ul>\n","_postman_id":"a3aeab84-ab39-4efa-8078-ea7aadd645f6"},{"name":"🤖 Support API Integration Guide","item":[{"name":"🔐 Authentication","item":[{"name":"Get Access Token","id":"19ab1823-1186-44e0-b610-1b5fe7e2d11d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials","type":"text"},{"key":"client_id","value":"{{slipbot_client_id}}","type":"text"},{"key":"client_secret","value":"{{slipbot_client_secret}}","type":"text"},{"key":"scope","value":"bots-hub/slip:write","type":"text"}]},"url":"{{slipbot_token_endpoint}}","urlObject":{"host":["{{slipbot_token_endpoint}}"],"query":[],"variable":[]}},"response":[{"id":"a7205d4e-2546-4639-93cc-1288bce6541a","name":"200 Token issued","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials","type":"text"},{"key":"client_id","value":"{{slipbot_client_id}}","type":"text"},{"key":"client_secret","value":"{{slipbot_client_secret}}","type":"text"},{"key":"scope","value":"bots-hub/slip:write","type":"text"}]},"url":"{{slipbot_token_endpoint}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"access_token\": \"eyJhbGci...\",\n    \"expires_in\": 3600\n}"}],"_postman_id":"19ab1823-1186-44e0-b610-1b5fe7e2d11d"}],"id":"518aa1e8-4b31-4b8c-a773-8c0594a1dd78","description":"<p>SlipBot uses OAuth 2.0 Client Credentials flow. A JWT token is required for every request to the SlipBot API.</p>\n<h3 id=\"how-to-get-a-token\">How to Get a Token</h3>\n<p>Send a <code>POST</code> request to the <code>token_endpoint</code> provided by Globalit Systems during onboarding.</p>\n<p><strong>Request:</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>POST {{slipbot_token_endpoint}}\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=client_credentials\n&amp;client_id={{slipbot_client_id}}\n&amp;client_secret={{slipbot_client_secret}}\n&amp;scope=bots-hub/slip:write\n</code></pre><p><strong>Response:</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"access_token\": \"eyJhbGci...\",\n  \"expires_in\": 3600\n}\n</code></pre>\n<p><strong>Important:</strong></p>\n<ul>\n<li>Token is valid for <strong>~1 hour</strong>. Refresh it automatically when it expires.</li>\n<li>Use the token in every SlipBot API request:</li>\n</ul>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>Authorization: \n</code></pre><blockquote>\n<p>Store <code>client_id</code>, <code>client_secret</code>, and <code>token_endpoint</code> securely. These are provided by Globalit Systems during integration setup.</p>\n</blockquote>\n","_postman_id":"518aa1e8-4b31-4b8c-a773-8c0594a1dd78"},{"name":"🖼️ Slip Verification","item":[{"name":"Submit Slip","id":"923fc0d0-4bbf-44b6-bef6-8c9fd043dd0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{slipbot_access_token}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"ticket_id\":      \"TICKET-12345\",\n    \"transaction_id\": \"TXN-67890\",\n    \"amount\":         \"5000\",\n    \"utr\":            \"123456789012\",\n    \"upi_id\":         \"user@bank\",\n    \"psp\":            \"YourPSPName\",\n    \"age_days\":       \"1\",\n    \"slip\":           \"iVBORw0KGgoAAAANSUhEUgAA...\",\n    \"callback_url\":   \"https://your-domain.com/slipbot/callback\",\n    \"expires_at\":     \"2026-06-29T15:30:00Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://botshub.globalit.systems/api/public/slips/followup","urlObject":{"protocol":"https","path":["api","public","slips","followup"],"host":["botshub","globalit","systems"],"query":[],"variable":[]}},"response":[{"id":"eb756e4a-8640-4878-8677-c264a855a1c2","name":"200 Slip accepted","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{slipbot_access_token}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"ticket_id\":      \"TICKET-12345\",\n    \"transaction_id\": \"TXN-67890\",\n    \"amount\":         \"5000\",\n    \"utr\":            \"123456789012\",\n    \"upi_id\":         \"user@bank\",\n    \"psp\":            \"YourPSPName\",\n    \"age_days\":       \"1\",\n    \"slip\":           \"iVBORw0KGgoAAAANSUhEUgAA...\",\n    \"callback_url\":   \"https://your-domain.com/slipbot/callback\",\n    \"expires_at\":     \"2026-06-29T15:30:00Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://botshub.globalit.systems/api/public/slips/followup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"accepted\"\n}"},{"id":"1c963bf6-2165-409b-8a03-87a4326ea040","name":"401 Unauthorized","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://botshub.globalit.systems/api/public/slips/followup"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\"\n}"}],"_postman_id":"923fc0d0-4bbf-44b6-bef6-8c9fd043dd0c"}],"id":"bbd747fe-f27f-4849-934a-535ee8a06bd5","description":"<p>Submit a payment slip screenshot for verification.</p>\n<p><strong>Endpoint:</strong> <code>POST https://botshub.globalit.systems/api/public/slips/followup</code></p>\n<p><strong>Authentication:</strong> Bearer token — see the <a href=\"#\">Authentication</a> section.</p>\n<hr />\n<h3 id=\"request-body\">Request Body</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"ticket_id\":      \"TICKET-12345\",\n    \"transaction_id\": \"TXN-67890\",\n    \"amount\":         \"5000\",\n    \"utr\":            \"123456789012\",\n    \"upi_id\":         \"user@bank\",\n    \"psp\":            \"YourPSPName\",\n    \"age_days\":       \"1\",\n    \"slip\":           \"iVBORw0KGgoAAAANSUhEUgAA...\",\n    \"callback_url\":   \"https://your-domain.com/slipbot/callback\",\n    \"expires_at\":     \"2026-06-29T15:30:00Z\"\n}\n</code></pre>\n<h3 id=\"request-parameters\">Request Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>ticket_id</code></td>\n<td>✅</td>\n<td>Your unique case ID — returned in the callback</td>\n</tr>\n<tr>\n<td><code>transaction_id</code></td>\n<td>✅</td>\n<td>Transaction ID in your system</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>✅</td>\n<td>Deposit amount</td>\n</tr>\n<tr>\n<td><code>utr</code></td>\n<td>⚠️</td>\n<td>UTR transaction number. Either <code>utr</code> or <code>upi_id</code> (or both) is required</td>\n</tr>\n<tr>\n<td><code>upi_id</code></td>\n<td>⚠️</td>\n<td>UPI ID of the sender. Either <code>utr</code> or <code>upi_id</code> (or both) is required</td>\n</tr>\n<tr>\n<td><code>psp</code></td>\n<td>✅</td>\n<td>Your PSP name</td>\n</tr>\n<tr>\n<td><code>age_days</code></td>\n<td>✅</td>\n<td>How many days ago the deposit was made</td>\n</tr>\n<tr>\n<td><code>slip</code></td>\n<td>✅</td>\n<td>Slip screenshot in <strong>base64</strong> format</td>\n</tr>\n<tr>\n<td><code>callback_url</code></td>\n<td>✅</td>\n<td>Your endpoint to receive the verification result</td>\n</tr>\n<tr>\n<td><code>expires_at</code></td>\n<td>✅</td>\n<td>Expiry time for the verification. Recommended: current time + 30 minutes</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p><strong>Important:</strong> <code>slip</code> must be a base64-encoded string — not a URL or binary data.</p>\n</blockquote>\n<hr />\n<h3 id=\"response\">Response</h3>\n<p>A <code>200 OK</code> response means the slip has been <strong>accepted for processing</strong>. The actual verification result arrives asynchronously via a <code>POST</code> to your <code>callback_url</code>. See the <a href=\"#\">Callback</a> section for the full payload and response codes.</p>\n","_postman_id":"bbd747fe-f27f-4849-934a-535ee8a06bd5"},{"name":"📡 Callback","item":[],"id":"0fb6b676-2144-4f6a-a349-ccedf7b69f2a","description":"<p>After verifying the slip, SlipBot sends a <code>POST</code> request to your <code>callback_url</code>.</p>\n<h3 id=\"setup-requirements\">Setup Requirements</h3>\n<ol>\n<li><strong>Create a public POST endpoint</strong>, e.g. <code>https://your-domain.com/slipbot/callback</code></li>\n<li><strong>Pass us your <code>X-PSP-Secret</code></strong> — any random string. We include it in every callback header:</li>\n</ol>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>X-PSP-Secret: YOUR_PSP_SECRET\n</code></pre><p>Validate this header on your side. Reject any request that doesn't match.</p>\n<ol>\n<li><strong>Respond with <code>200 OK</code></strong> to acknowledge receipt.</li>\n</ol>\n<hr />\n<h3 id=\"callback-payload\">Callback Payload</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"ticket_id\":     \"TICKET-12345\",\n  \"response_code\": \"RECEIVED\",\n  \"notes\":         \"Payment found and confirmed\",\n  \"order_id\":      null,\n  \"platform_name\": null\n}\n</code></pre>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>ticket_id</code></td>\n<td>Your original case ID from the request</td>\n</tr>\n<tr>\n<td><code>response_code</code></td>\n<td>Verification result — see Response Codes</td>\n</tr>\n<tr>\n<td><code>notes</code></td>\n<td>Human-readable description of the result</td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>Populated only for <code>CLAIM_SAME</code> — the conflicting order ID</td>\n</tr>\n<tr>\n<td><code>platform_name</code></td>\n<td>Populated only for <code>CLAIM_OTHER</code> — the platform that owns the payment</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"sla\">SLA</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Scenario</th>\n<th>Time</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Automatic verification</td>\n<td><strong>20–30 seconds</strong></td>\n</tr>\n<tr>\n<td>Manual review (if auto-match fails)</td>\n<td><strong>up to 30 minutes</strong></td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"0fb6b676-2144-4f6a-a349-ccedf7b69f2a"},{"name":"📋 Response Codes","item":[],"id":"ea490e3e-0603-449b-9fc6-fc0355ad0614","description":"<p>SlipBot returns one of the following <code>response_code</code> values in the callback payload.</p>\n<hr />\n<h3 id=\"✅-payment-confirmed\">✅ Payment Confirmed</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Action</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>RECEIVED</code></td>\n<td>Payment confirmed. Credit the deposit to the user</td>\n</tr>\n<tr>\n<td><code>ADD_BALANCE</code></td>\n<td>Balance needs to be added manually. Payment found but requires manual action</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"🔄-action-required\">🔄 Action Required</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Action</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>REFUND</code></td>\n<td>Return the money to the user</td>\n</tr>\n<tr>\n<td><code>CLAIM_SAME</code></td>\n<td>Payment is already linked to another order in our system. Order ID is in the <code>order_id</code> field</td>\n</tr>\n<tr>\n<td><code>CLAIM_OTHER</code></td>\n<td>Payment belongs to another platform. Platform name is in the <code>platform_name</code> field</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"❌-payment-not-confirmed\">❌ Payment Not Confirmed</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Action</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>NOT_RECEIVED</code></td>\n<td>Payment not found in the system</td>\n</tr>\n<tr>\n<td><code>NOT_OUR_UPI</code></td>\n<td>UPI ID does not belong to our system</td>\n</tr>\n<tr>\n<td><code>ORDER_NOT_FOUND</code></td>\n<td>Order not found</td>\n</tr>\n<tr>\n<td><code>TAMPERED</code></td>\n<td>Slip appears to have been altered. Do not credit the deposit</td>\n</tr>\n<tr>\n<td><code>FAILED</code></td>\n<td>Technical error during processing. Retry the request</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"📸-additional-screenshot-required\">📸 Additional Screenshot Required</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Action</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>NEED_SCREENSHOT_UPI_ID</code></td>\n<td>Ask the user for a screenshot showing the UPI ID</td>\n</tr>\n<tr>\n<td><code>NEED_SCREENSHOT_UTR</code></td>\n<td>Ask the user for a screenshot showing the UTR number</td>\n</tr>\n<tr>\n<td><code>NEED_SCREENSHOT_AMOUNT</code></td>\n<td>Ask the user for a screenshot showing the amount</td>\n</tr>\n<tr>\n<td><code>NEED_SCREENSHOT_DATE_TIME</code></td>\n<td>Ask the user for a screenshot showing the date and time</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"⏳-in-progress\">⏳ In Progress</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>Action</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>PENDING</code></td>\n<td>Auto-match failed — case transferred to manual review. Response will arrive within 30 minutes. This code can be ignored if manual processing is not part of your flow</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"ea490e3e-0603-449b-9fc6-fc0355ad0614"},{"name":"✅ Go-live Checklist","item":[],"id":"7fc96235-d660-424f-86a7-517bca914001","description":"<p>Complete all items before going live with SlipBot integration.</p>\n<ul>\n<li><p> \nReceived <code>client_id</code>, <code>client_secret</code>, and <code>token_endpoint</code> from Globalit Systems</p>\n</li>\n<li><p> \nToken is requested automatically and refreshed when it expires</p>\n</li>\n<li><p> \nCallback endpoint is set up and publicly accessible</p>\n</li>\n<li><p> \n<code>X-PSP-Secret</code> has been provided to Globalit Systems and is validated on every incoming callback</p>\n</li>\n<li><p> \nSlips are converted to base64 before sending</p>\n</li>\n<li><p> \nAll response codes from the Response Codes section are handled in your application logic</p>\n</li>\n<li><p> \n<code>RECEIVED</code> → deposit is credited to the user</p>\n</li>\n<li><p> \n<code>REFUND</code> → refund is initiated</p>\n</li>\n<li><p> \n<code>TAMPERED</code> → deposit is blocked</p>\n</li>\n<li><p> \n<code>FAILED</code> → retry logic is implemented</p>\n</li>\n<li><p> \n<code>NEED_SCREENSHOT_*</code> → user is prompted for additional screenshot</p>\n</li>\n<li><p> \nTesting completed with real slips</p>\n</li>\n<li><p> \nGo-live date agreed with Globalit Systems team</p>\n</li>\n</ul>\n<hr />\n<p>For integration support contact: <strong>Ostin Turner</strong> · <a href=\"mailto:ostin@globalit.systems\">ostin@globalit.systems</a></p>\n","_postman_id":"7fc96235-d660-424f-86a7-517bca914001"}],"id":"0b786ced-1737-4286-975e-ff18ef84845d","description":"<p>This section covers the API for handling payments that were not automatically matched by the system. When a user completes a payment but the transaction was not processed, they can submit a screenshot as proof of payment. You forward this screenshot to the API, and the system attempts to recognize and process the transaction automatically. If recognition is successful, the order is resolved instantly without manual intervention. If the screenshot cannot be processed automatically, a support ticket is created and assigned to our team for manual review. Once resolved, the API returns one of the final statuses listed below.</p>\n<p><strong>Without SlipBot:</strong> your support team manually verifies every slip.<br /><strong>With SlipBot:</strong> 95% of slips are verified automatically in 20–30 seconds.</p>\n<h2 id=\"how-it-works\">How It Works</h2>\n<img src=\"https://content.pstmn.io/943b54f6-f947-4289-9cb1-7bb3c5aadd34/ZGlhZ3JhbW0ucG5n\" width=\"835\" height=\"655\" />\n\n<h2 id=\"before-you-start\">Before You Start</h2>\n<p>Exchange credentials with Globalit Systems:</p>\n<p><strong>They provide you:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>client_id</code></td>\n<td>Your application identifier</td>\n</tr>\n<tr>\n<td><code>client_secret</code></td>\n<td>Secret key for obtaining an OAuth token</td>\n</tr>\n<tr>\n<td><code>token_endpoint</code></td>\n<td>Authorization server URL</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>You provide them:</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>callback_url</code></td>\n<td>Your endpoint where SlipBot sends verification results</td>\n</tr>\n<tr>\n<td><code>X-PSP-Secret</code></td>\n<td>A secret you create. Included in every callback header for request verification</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>Store all credentials securely. Do not share them with third parties. </p>\n</blockquote>\n<h2 id=\"integration-steps\">Integration Steps</h2>\n<ol>\n<li><p>Exchange credentials with Globalit Systems</p>\n</li>\n<li><p>Implement OAuth token retrieval and auto-refresh</p>\n</li>\n<li><p>Set up your callback endpoint with <code>X-PSP-Secret</code> validation</p>\n</li>\n<li><p>Implement <code>POST /slips/followup</code> call when a user submits a slip</p>\n</li>\n<li><p>Handle all response codes in your application logic</p>\n</li>\n<li><p>Test with real slips and confirm go-live date</p>\n</li>\n</ol>\n<h2 id=\"sla\">SLA</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Scenario</th>\n<th>Time</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Automatic verification</td>\n<td><strong>20–30 seconds</strong></td>\n</tr>\n<tr>\n<td>Manual review (if auto-match fails)</td>\n<td><strong>up to 30 minutes</strong></td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"0b786ced-1737-4286-975e-ff18ef84845d"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"714003c4-19ab-4ea6-a91a-879c803d1406"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"30d1038b-6265-4d19-bf81-ecdac8d6a93e"}}],"variable":[{"key":"base_url","value":"https://api.zyntego.com/api"},{"key":"merchant_api_token","value":""},{"key":"currency","value":""}]}