{"info":{"_postman_id":"7df311d2-daf0-4053-85a0-0f834cd3addf","name":"Shaymavenue","description":"<html><head></head><body><h2 id=\"shaymavenue-payment-api\">Shaymavenue Payment API</h2>\n<p>The <strong>Shaymavenue</strong> collection provides a set of API endpoints for interacting with the Shaymavenue Payment Gateway. It enables merchants to initiate fund transfers, check transaction statuses, create payment orders, and fetch account balances.</p>\n<h3 id=\"getting-started\">Getting Started</h3>\n<p>All requests are directed to the base URL: <code>https://shaymavenue.in/api/v1/</code></p>\n<p>Authentication is handled via merchant credentials passed in the request body:</p>\n<ul>\n<li><strong><code>mid</code></strong> — Your unique Merchant ID (e.g. <code>SHYAM7294150379</code>)</li>\n<li><strong><code>apikey</code></strong> — Your API authentication key</li>\n</ul>\n<h3 id=\"endpoints\">Endpoints</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Request</th>\n<th>Method</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>Collection</code></td>\n<td>POST</td>\n<td>Create a new payment order</td>\n</tr>\n<tr>\n<td><code>transfer</code></td>\n<td>POST</td>\n<td>Initiate a fund transfer to a recipient's bank account</td>\n</tr>\n<tr>\n<td><code>check_status</code></td>\n<td>POST</td>\n<td>Check the status of an existing transaction</td>\n</tr>\n<tr>\n<td><code>fetch_balance</code></td>\n<td>GET</td>\n<td>Retrieve the current merchant wallet balance</td>\n</tr>\n</tbody>\n</table>\n</div><h3 id=\"notes\">Notes</h3>\n<ul>\n<li>The <code>client_txn_id</code> used in transfer and order requests must be <strong>unique and alphanumeric</strong> for every transaction to prevent duplicates.</li>\n<li>Transfer amounts are specified in paise/rupees.</li>\n<li>Recipient bank details (<code>account_number</code> and <code>ifsc</code>) are required for fund transfers.</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"36968084","collectionId":"7df311d2-daf0-4053-85a0-0f834cd3addf","publishedId":"2sBY4Mu1rY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-07-15T05:24:14.000Z"},"item":[{"name":"Collection","id":"8ba30ff6-37d0-4168-a659-dc04b2045f6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM729415xxxx\",\n  \"apikey\": \"A9f3K2mX7Qpxxxx\",\n  \"client_txn_id\": \"SHYAM23451143\", // unqiue\n  \"amount\": \"100\",\n  \"customer_mobile\": \"9876543210\"\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/create_order","description":"<h1 id=\"collection-api-create-order\">Collection API (Create Order)</h1>\n<h2 id=\"description\">Description</h2>\n<p>The <strong>Collection API</strong> allows merchants to create a new payment collection order. Upon successful request, the API generates a unique payment order that can be shared with customers to collect payments. The merchant must provide valid authentication credentials along with the transaction details.</p>\n<p>This API is useful for:</p>\n<ul>\n<li><p>Creating a payment collection request.</p>\n</li>\n<li><p>Generating unique payment orders.</p>\n</li>\n<li><p>Initiating customer payment collections.</p>\n</li>\n<li><p>Tracking collections using a unique transaction ID.</p>\n</li>\n</ul>\n<hr />\n<h2 id=\"api-details\">API Details</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>API Name</strong></td>\n<td>Collection (Create Order)</td>\n</tr>\n<tr>\n<td><strong>HTTP Method</strong></td>\n<td>POST</td>\n</tr>\n<tr>\n<td><strong>Endpoint</strong></td>\n<td><code>https://shaymavenue.in/api/v1/create_order</code></td>\n</tr>\n<tr>\n<td><strong>Content-Type</strong></td>\n<td><code>application/json</code></td>\n</tr>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>Merchant ID (MID) &amp; API Key</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"request-body-parameters\">Request Body Parameters</h2>\n<p>The following parameters must be included in the request body when creating a collection order.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Required</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>mid</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique Merchant ID assigned to the merchant.</td>\n</tr>\n<tr>\n<td><code>apikey</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Secret API Key used to authenticate API requests.</td>\n</tr>\n<tr>\n<td><code>client_txn_id</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Merchant-generated unique transaction identifier. This value must be unique for every collection request.</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>Integer</td>\n<td>Yes</td>\n<td>Amount to be collected from the customer.</td>\n</tr>\n<tr>\n<td><code>customer_mobile</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Customer's valid 10-digit mobile number associated with the payment request.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"notes\">Notes</h2>\n<ul>\n<li><p>The <code>client_txn_id</code> <strong>must be unique</strong> for every collection request.</p>\n</li>\n<li><p>The <code>amount</code> should be specified in the smallest currency unit supported by your integration (or as configured).</p>\n</li>\n<li><p>The <code>customer_mobile</code> should be a valid 10-digit mobile number.</p>\n</li>\n<li><p>Always use <strong>HTTPS</strong> for secure communication.</p>\n</li>\n<li><p>Keep your <strong>API Key</strong> confidential and never expose it in client-side applications.</p>\n</li>\n<li><p>Save the <code>client_txn_id</code> and <code>order_id</code> for future transaction status verification.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["api","v1","create_order"],"host":["shaymavenue","in"],"query":[],"variable":[]}},"response":[{"id":"9932b9b1-288c-4077-af23-bfd49b7e13dd","name":"Collection_Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM7294150379\",\n  \"apikey\": \"A9f3K2mX7Qp8L6tg\",\n  \"client_txn_id\": \"SHYAM23451143\", // unqiue\n  \"amount\": \"100\",\n  \"customer_mobile\": \"9876543210\"\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/create_order"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.30"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"247"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 15 Jul 2026 03:39:18 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"True\",\n    \"validity\": \"One-time use. Valid 5 mins.\",\n    \"msg\": \"Intent created successfully\",\n    \"amount\": \"100\",\n    \"client_txn_id\": \"SHYAM23451143\",\n    \"upiLink\": \"upi://pay?pa=paytm-83967761@ptybl&pn=SHYAM%20ENTERPRISES&mc=7372&tr=TXN2607150909187925&am=100&cu=INR\"\n}"}],"_postman_id":"8ba30ff6-37d0-4168-a659-dc04b2045f6e"},{"name":"transfer","id":"7edb4b7c-ddf1-4b40-89dd-9dce9cf2b047","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM7294150xxxx\",\n  \"apikey\": \"A9f3K2mX7Qp8xxxx\",\n  \"client_txn_id\": \"TXN12345111143\", // alpha numeric unqiue\n  \"amount\": \"25000\",\n  \"customer_name\": \"Shyam\",\n  \"account_number\": \"187111010xxxxxx\",\n  \"ifsc\": \"UBIN08xxxxx\"\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/transfer","description":"<h1 id=\"fund-transfer-api\">Fund Transfer API</h1>\n<h2 id=\"description\">Description</h2>\n<p>The <strong>Fund Transfer API</strong> allows merchants to transfer funds from their merchant wallet to a beneficiary's bank account. The API securely processes payout transactions after validating the merchant's credentials and beneficiary details.</p>\n<p>This API is useful for:</p>\n<ul>\n<li><p>Initiating instant bank account payouts.</p>\n</li>\n<li><p>Sending funds to beneficiaries via supported banking channels.</p>\n</li>\n<li><p>Automating merchant payout workflows.</p>\n</li>\n<li><p>Tracking payouts using a unique client transaction ID.</p>\n</li>\n</ul>\n<hr />\n<h2 id=\"api-details\">API Details</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>API Name</strong></td>\n<td>Fund Transfer</td>\n</tr>\n<tr>\n<td><strong>HTTP Method</strong></td>\n<td>POST</td>\n</tr>\n<tr>\n<td><strong>Endpoint</strong></td>\n<td><code>https://shaymavenue.in/api/v1/transfer</code></td>\n</tr>\n<tr>\n<td><strong>Content-Type</strong></td>\n<td><code>application/json</code></td>\n</tr>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>Merchant ID (MID) &amp; API Key</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"request-body-parameters\">Request Body Parameters</h2>\n<p>The following parameters must be included in the request body when initiating a fund transfer.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Parameter</strong></th>\n<th><strong>Type</strong></th>\n<th><strong>Required</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>mid</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique Merchant ID assigned to the merchant.</td>\n</tr>\n<tr>\n<td><code>apikey</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Secret API Key used to authenticate API requests.</td>\n</tr>\n<tr>\n<td><code>client_txn_id</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique and should be alphanumeric.</td>\n</tr>\n<tr>\n<td><code>amount</code></td>\n<td>Integer</td>\n<td>Yes</td>\n<td>Amount to be transferred to the beneficiary.</td>\n</tr>\n<tr>\n<td><code>customer_name</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Full name of the beneficiary.</td>\n</tr>\n<tr>\n<td><code>account_number</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Beneficiary's bank account number.</td>\n</tr>\n<tr>\n<td><code>ifsc</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>IFSC code of the beneficiary's bank branch.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"notes\">Notes</h2>\n<ul>\n<li><p>The <code>client_txn_id</code> <strong>must be unique</strong> for every fund transfer request.</p>\n</li>\n<li><p>Ensure that the beneficiary's <strong>account number</strong> and <strong>IFSC code</strong> are correct before initiating the transfer.</p>\n</li>\n<li><p>The <code>amount</code> should be specified in the smallest currency unit supported by your integration (or as configured).</p>\n</li>\n<li><p>Always use <strong>HTTPS</strong> for secure communication.</p>\n</li>\n<li><p>Keep your <strong>API Key</strong> confidential and never expose it in client-side applications.</p>\n</li>\n<li><p>Save the <code>client_txn_id</code> for future transaction status verification.</p>\n</li>\n<li><p>Refer to the <code>transfer_response</code> example for a sample successful response.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["api","v1","transfer"],"host":["shaymavenue","in"],"query":[],"variable":[]}},"response":[{"id":"5562b744-ab55-4c0c-9fca-c38f8efb89a4","name":"transfer_response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM7294150379\",\n  \"apikey\": \"A9f3K2mX7Qp8L6tg\",\n  \"client_txn_id\": \"TXN1234511143\", // unqiue\n  \"amount\": \"101\",\n  \"customer_name\": \"Rockypayz\",\n  \"account_number\": \"5924510530\",\n  \"ifsc\": \"CBIN0284090\"\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/transfer"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.30"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"173"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 15 Jul 2026 04:50:41 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n    \"statuscode\": \"TXN\",\n    \"msg\": \"Transfer Success\",\n    \"data\": {\n        \"TXN_Time\": \"2026-07-15 10:20:41\",\n        \"TXN_ID\": \"TXN1234511143\",\n        \"Amount\": 101,\n        \"Fees\": 5.9,\n        \"UTR\": \"619635593437\",\n        \"status\": \"success\"\n    }\n}"}],"_postman_id":"7edb4b7c-ddf1-4b40-89dd-9dce9cf2b047"},{"name":"check_status","id":"7d28bcbc-6de6-46f4-b4f1-f40daba06384","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM7294150xxxx\",\n  \"apikey\": \"A9f3K2mX7Qp8Lxxx\",\n  \"client_txn_id\": \"SHYAM47536\", // unqiue\n  \"route\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/check_status","description":"<h1 id=\"check-status-api\">Check Status API</h1>\n<h2 id=\"description\">Description</h2>\n<p>The <strong>Check Status API</strong> allows merchants to retrieve the current status of a payout transaction using the unique <strong>Client Transaction ID</strong>. The API authenticates the request using the <strong>Merchant ID (MID)</strong> and <strong>API Key</strong>, then returns the latest transaction status for the specified payout.</p>\n<p>This API is useful for:</p>\n<ul>\n<li><p>Checking whether a payout is <strong>Pending</strong>, <strong>Success</strong>, or <strong>Failed</strong>.</p>\n</li>\n<li><p>Tracking transaction progress in real time.</p>\n</li>\n<li><p>Verifying the final status of a payout after initiation.</p>\n</li>\n<li><p>Synchronizing transaction status with merchant applications.</p>\n</li>\n</ul>\n<hr />\n<h2 id=\"api-details\">API Details</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>API Name</strong></td>\n<td>Check Status</td>\n</tr>\n<tr>\n<td><strong>HTTP Method</strong></td>\n<td>POST</td>\n</tr>\n<tr>\n<td><strong>Endpoint</strong></td>\n<td><code>https://shaymavenue.in/api/v1/check_status</code></td>\n</tr>\n<tr>\n<td><strong>Content-Type</strong></td>\n<td><code>application/json</code></td>\n</tr>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>Merchant ID (MID) &amp; API Key</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"request-body-parameters\">Request Body Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>mid</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique Merchant ID assigned to the merchant.</td>\n</tr>\n<tr>\n<td><code>apikey</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Secret API Key used for authentication.</td>\n</tr>\n<tr>\n<td><code>client_txn_id</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique transaction ID generated by the merchant during payout initiation.</td>\n</tr>\n<tr>\n<td><code>route</code></td>\n<td>Integer</td>\n<td>Yes</td>\n<td>0 - For Payout and 1- For Payin status check</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"notes\">Notes</h2>\n<ul>\n<li><p>The <code>client_txn_id</code> must be the same transaction ID used while initiating the payout.</p>\n</li>\n<li><p>The <code>route</code> value must match the route used during payout creation.</p>\n</li>\n<li><p>Always use <strong>HTTPS</strong> to ensure secure communication.</p>\n</li>\n<li><p>Keep your <strong>API Key</strong> confidential and never expose it in client-side applications.</p>\n</li>\n<li><p>It is recommended to call this API when a payout remains pending or to verify the final transaction status.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["api","v1","check_status"],"host":["shaymavenue","in"],"query":[],"variable":[]}},"response":[{"id":"62219466-48f2-481f-92ae-bea041be3adc","name":"check_status_response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"mid\": \"SHYAM7294150379\",\n  \"apikey\": \"A9f3K2mX7Qp8L6tg\",\n  \"client_txn_id\": \"SHYAM47536\", // unqiue\n  \"route\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/check_status"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.30"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"185"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 15 Jul 2026 05:09:49 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"msg\": \"Transaction found\",\n    \"data\": {\n        \"txnid\": \"SHYAM47536\",\n        \"createdAt\": \"2026-07-14 22:55:21\",\n        \"amount\": \"100\",\n        \"fees\": \"1.18\",\n        \"credit_amount\": \"98.82\",\n        \"utr\": \"210808099968\",\n        \"status\": \"SUCCESS\"\n    }\n}"}],"_postman_id":"7d28bcbc-6de6-46f4-b4f1-f40daba06384"},{"name":"fetch_balance","id":"b1cf5839-d014-4f2c-8b76-82c90b3fe49c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://shaymavenue.in/api/v1/fetch_balance?mid=SHYAM7294150xxx&apikey=A9f3K2mX7Qp8Lxxx","description":"<h1 id=\"fetch-balance-api\">Fetch Balance API</h1>\n<h2 id=\"description\">Description</h2>\n<p>The <strong>Fetch Balance API</strong> allows merchants to retrieve their current available wallet balance using their <strong>Merchant ID (MID)</strong> and <strong>API Key</strong>. This API authenticates the merchant and returns the available balance associated with the merchant account.</p>\n<p>This API is useful for:</p>\n<ul>\n<li><p>Checking the available balance before initiating payouts.</p>\n</li>\n<li><p>Monitoring account funds in real time.</p>\n</li>\n<li><p>Displaying the merchant's current balance on dashboards or applications.</p>\n</li>\n</ul>\n<hr />\n<h2 id=\"api-details\">API Details</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Value</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>API Name</strong></td>\n<td>Fetch Balance</td>\n</tr>\n<tr>\n<td><strong>HTTP Method</strong></td>\n<td>GET</td>\n</tr>\n<tr>\n<td><strong>Endpoint</strong></td>\n<td><code>https://shaymavenue.in/api/v1/fetch_balance</code></td>\n</tr>\n<tr>\n<td><strong>Content-Type</strong></td>\n<td><code>application/json</code></td>\n</tr>\n<tr>\n<td><strong>Authentication</strong></td>\n<td>Merchant ID (MID) &amp; API Key</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"request-parameters\">Request Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>mid</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Unique Merchant ID assigned to the merchant.</td>\n</tr>\n<tr>\n<td><code>apikey</code></td>\n<td>String</td>\n<td>Yes</td>\n<td>Secret API Key provided to authenticate API requests.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"notes\">Notes</h2>\n<ul>\n<li><p>Both <strong><code>mid</code></strong> and <strong><code>apikey</code></strong> are mandatory request parameters.</p>\n</li>\n<li><p>Always send requests over <strong>HTTPS</strong> to ensure secure communication.</p>\n</li>\n<li><p>Keep your <strong>API Key</strong> confidential and never expose it in frontend or client-side applications.</p>\n</li>\n<li><p>The <code>Main_Balance</code> field represents the merchant's currently available balance and can be used to verify sufficient funds before initiating payout transactions.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["api","v1","fetch_balance"],"host":["shaymavenue","in"],"query":[{"key":"mid","value":"SHYAM7294150xxx"},{"key":"apikey","value":"A9f3K2mX7Qp8Lxxx"}],"variable":[]}},"response":[{"id":"fd15d92c-6c7a-4dae-93f2-b3c2d278be8b","name":"fetch_balance_response","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://shaymavenue.in/api/v1/fetch_balance?mid=SHYAM7294150379&apikey=A9f3K2mX7Qp8L6tg","protocol":"https","host":["shaymavenue","in"],"path":["api","v1","fetch_balance"],"query":[{"key":"mid","value":"SHYAM7294150379"},{"key":"apikey","value":"A9f3K2mX7Qp8L6tg"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.30"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"104"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Wed, 15 Jul 2026 05:21:21 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": true,\n    \"statusMsg\": \"Balance Fetched Successfully...!!\",\n    \"data\": {\n        \"Main_Balance\": \"18277.60\"\n    }\n}"}],"_postman_id":"b1cf5839-d014-4f2c-8b76-82c90b3fe49c"},{"name":"Webhook-Request","id":"d4f16610-d2ef-4654-801b-9f939747aaa2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://yourdomain.com/webhook_rcv_payout.php","description":"<h1 id=\"webhooks\">Webhooks</h1>\n<h2 id=\"description\">Description</h2>\n<p>Shaymavenue supports <strong>Webhook Notifications</strong> to provide real-time updates for both <strong>Payout</strong> and <strong>Payin (Collection)</strong> transactions.</p>\n<p>Once a transaction reaches its final status, Shaymavenue automatically sends an HTTP <strong>POST</strong> request to the webhook URL configured by the merchant. This eliminates the need to continuously poll the <strong>Check Status API</strong>.</p>\n<hr />\n<h1 id=\"webhook-configuration\">Webhook Configuration</h1>\n<p>Merchants can configure separate webhook URLs for:</p>\n<ul>\n<li><p><strong>Payout Webhook</strong></p>\n</li>\n<li><p><strong>Payin (Collection) Webhook</strong></p>\n</li>\n</ul>\n<p>The webhook URL can be configured from the merchant dashboard.</p>\n<hr />\n<h2 id=\"http-method\">HTTP Method</h2>\n<p><code>POST</code></p>\n<hr />\n<h2 id=\"content-type\">Content-Type</h2>\n<p><code>application/json</code></p>\n<hr />\n<h2 id=\"payout-webhook\">Payout Webhook</h2>\n<p>The payout webhook is triggered whenever a payout transaction is successfully processed or fails.</p>\n<h3 id=\"sample-payload\">Sample Payload</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">[\n    {\n        \"Txn_ID\": \"SHYAM78371\",\n        \"TXN_date\": \"2026-01-01 11:11:44\",\n        \"TXN_amount\": \"110\",\n        \"UTR\": \"HDFC12345XYZ\",\n        \"TXN_Status\": \"success\"\n    }\n]\n\n</code></pre>\n<hr />\n<h2 id=\"payin-collection-webhook\">Payin (Collection) Webhook</h2>\n<p>The payin webhook is triggered whenever a collection/payment request is completed or fails.</p>\n<h3 id=\"sample-payload-1\">Sample Payload</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">[\n    {\n        \"Txn_ID\": \"SHYAM78371\",\n        \"TXN_date\": \"2026-01-01 11:11:44\",\n        \"TXN_amount\": \"110\",\n        \"UTR\": \"HDFC12345XYZ\",\n        \"TXN_Status\": \"success\"\n    }\n]\n\n</code></pre>\n<hr />\n<h2 id=\"payload-parameters\">Payload Parameters</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>Txn_ID</code></td>\n<td>String</td>\n<td>Merchant transaction ID.</td>\n</tr>\n<tr>\n<td><code>TXN_date</code></td>\n<td>String</td>\n<td>Date and time when the transaction was processed.</td>\n</tr>\n<tr>\n<td><code>TXN_amount</code></td>\n<td>String</td>\n<td>Transaction amount.</td>\n</tr>\n<tr>\n<td><code>UTR</code></td>\n<td>String</td>\n<td>Bank reference number (available after processing).</td>\n</tr>\n<tr>\n<td><code>TXN_Status</code></td>\n<td>String</td>\n<td>Current transaction status (<code>success</code> or <code>failed</code>).</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"transaction-status\">Transaction Status</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>success</code></td>\n<td>Transaction completed successfully.</td>\n</tr>\n<tr>\n<td><code>failed</code></td>\n<td>Transaction failed.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"merchant-response\">Merchant Response</h2>\n<p>Your webhook endpoint should return an <strong>HTTP 200 OK</strong> response after successfully processing the notification.</p>\n<p>Example:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-http\">HTTP/1.1 200 OK\n\n</code></pre>\n<hr />\n<h2 id=\"notes\">Notes</h2>\n<ul>\n<li><p>Webhook notifications are sent as <strong>HTTP POST</strong> requests.</p>\n</li>\n<li><p>Configure separate webhook URLs for <strong>Payout</strong> and <strong>Payin</strong> notifications.</p>\n</li>\n<li><p>Always validate the received <code>Txn_ID</code> before updating your records.</p>\n</li>\n<li><p>Do not rely solely on the webhook for reconciliation. If required, verify the final transaction status using the <strong>Check Status API</strong>.</p>\n</li>\n<li><p>Your webhook endpoint should be publicly accessible over <strong>HTTPS</strong>.</p>\n</li>\n<li><p>Ensure your server responds with <strong>HTTP 200 OK</strong> after processing the webhook to acknowledge successful receipt.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["webhook_rcv_payout.php"],"host":["yourdomain","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d4f16610-d2ef-4654-801b-9f939747aaa2"}],"event":[{"listen":"prerequest","script":{"id":"d21037bd-f774-4769-b436-ca2657db2f05","type":"text/javascript","packages":{},"requests":{},"exec":["const clientId = \"client_717e701850xxxxxxxxxxxxx\";","const secretKey = \"sk_9f9c6a0f743d3aeaf7a0xxxxxxx\";","","const method = pm.request.method;","const uri = \"/api/v1/payout/initiate\";","","const timestamp = Math.floor(Date.now() / 1000).toString();","","const requestId =","    \"req_\" +","    timestamp +","    \"_\" +","    Math.random().toString(16).substring(2,18);","","const body = pm.request.body.raw;","","const stringToSign =","    `${method}|${uri}|${timestamp}|${body}`;","","const signature =","CryptoJS.HmacSHA256(stringToSign, secretKey)",".toString(CryptoJS.enc.Hex);","","pm.request.headers.upsert({","    key: \"X-Client-ID\",","    value: clientId","});","","pm.request.headers.upsert({","    key: \"X-Timestamp\",","    value: timestamp","});","","pm.request.headers.upsert({","    key: \"X-Request-ID\",","    value: requestId","});","","pm.request.headers.upsert({","    key: \"X-Signature\",","    value: signature","});"]}},{"listen":"test","script":{"id":"bfba4a6c-80b6-44f9-993f-89ba043880de","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}]}