{ "info": { "name": "UPI PSP Mercury - Complete API Collection", "description": "Complete Postman collection for Mercury UPI PSP APIs including NPCI interface and Partner APIs", "version": "1.0.0", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "http://localhost:4040", "type": "string" }, { "key": "api_version", "value": "v1", "type": "string" } ], "item": [ { "name": "๐Ÿ›๏ธ NPCI โ†’ PSP Interface (Official UPI APIs)", "description": "Official NPCI UPI protocol APIs - These handle communication from NPCI to PSP", "item": [ { "name": "1. QR Validation (ReqValQR)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/validate-qr", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "validate-qr"] }, "description": "NPCI sends QR validation request to PSP for merchant verification and amount validation. Uses simplified XML structure with minimal required fields: Head (msgId, orgId, ts, ver), Txn (custRef, id, refId, refUrl, ts, type), and Institution (QrPayLoad with actual UPI payment string)." }, "response": [ { "name": "Success Response - Basic QR", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "\n\n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/validate-qr", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "validate-qr"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n" }, { "name": "Success Response - Complex QR", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "\n\n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/validate-qr", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "validate-qr"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n" } ] }, { "name": "2. Payment Processing (ReqPay)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/process-payment", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "process-payment"] }, "description": "NPCI sends payment request (CREDIT) to PSP for processing with international partner" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n \n" } ] }, { "name": "2b. International Payment Processing (ReqPay - International)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Singapore Test Merchant Pte Ltd\n 201234567X\n \n
\n 123 Orchard Road\n Singapore\n Central\n 238896\n SG\n
\n \n \n \n \n SGD\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Friend\n Salary\n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/process-payment", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "process-payment"] }, "description": "NPCI sends international payment request (CREDIT) to PSP for processing with international partner. Includes enhanced international fields: destination country, FX conversion, merchant business details, risk scoring, device fingerprinting, and remittance information." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n \n \n \n \n \n \n \n \n \n SG-APR-789123\n SG-SET-456789\n 2025-01-11T10:32:15+08:00\n \n \n \n \n \n \n \n \n \n \n" } ] }, { "name": "3. Transaction Status Check (ReqChkTxn)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/check-transaction", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "check-transaction"] }, "description": "NPCI requests transaction status check (timeout scenario)" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n \n \n" } ] }, { "name": "4. Heartbeat Check (ReqHbt)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/heartbeat", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "heartbeat"] }, "description": "NPCI health check to verify PSP system availability" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "xml", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": "\n\n \n \n" } ] }, { "name": "5. Batch Transaction Check", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n \n \n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/batch-check", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "batch-check"] }, "description": "Batch processing for multiple transaction status checks" } }, { "name": "6. Settlement Reconciliation", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n 2025-01-10\n 2025-01-11\n SINGAPORE_PARTNER\n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/reconciliation", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "reconciliation"] }, "description": "Settlement reconciliation for international transactions" } }, { "name": "7. Mandate Management", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" }, { "key": "Accept", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "\n\n \n \n MANDATE_001\n 1000.00\n MONTHLY\n 2025-02-01\n 2025-12-31\n \n \n \n" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/mandate-request", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "mandate-request"] }, "description": "Recurring payment mandate management" } } ] }, { "name": "๐Ÿค Partner โ†’ PSP Interface (Business APIs)", "description": "Partner-facing APIs for QR generation and management", "item": [ { "name": "1. Generate QR Code", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{partner_token}}", "description": "Partner authentication token" } ], "body": { "mode": "raw", "raw": "{\n \"partner_id\": \"SINGAPORE_PARTNER_001\",\n \"merchant_id\": \"MERCHANT_SG_123\",\n \"amount\": \"100.50\",\n \"currency\": \"SGD\",\n \"corridor\": \"singapore\",\n \"merchant_name\": \"Singapore Test Merchant\",\n \"merchant_category\": \"5411\",\n \"purpose_code\": \"P0101\",\n \"validity_minutes\": 300,\n \"max_usage_count\": 1,\n \"metadata\": {\n \"invoice_id\": \"INV_2025_001\",\n \"customer_ref\": \"CUST_REF_123\"\n }\n}" }, "url": { "raw": "{{base_url}}/api/{{api_version}}/qr-generate", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "qr-generate"] }, "description": "Partner requests QR code generation for their merchant with international parameters" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "", "host": [""] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"qr_id\": \"QR_SG_2025_001\",\n \"qr_string\": \"upi://pay?pa=merchant@mercury&pn=Singapore%20Test%20Merchant&am=8325.00&cu=INR&mc=5411&pc=P0101\",\n \"merchant_id\": \"MERCHANT_SG_123\",\n \"amount\": \"100.50\",\n \"currency\": \"SGD\",\n \"fx_rate\": \"83.25\",\n \"markup_percentage\": \"2.5\",\n \"inr_amount\": \"8325.00\",\n \"expires_at\": \"2025-01-11T15:30:00Z\",\n \"qr_url\": \"https://mercury-psp.com/qr/dXBpOi8vcGF5P3BhPW1lcmNoYW50QG1lcmN1cnkmc\",\n \"status\": \"active\"\n },\n \"message\": \"QR code generated successfully\"\n}" } ] }, { "name": "2. Check QR Status", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{partner_token}}", "description": "Partner authentication token" } ], "url": { "raw": "{{base_url}}/api/{{api_version}}/qr-status/QR_SG_2025_001", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "qr-status", "QR_SG_2025_001"] }, "description": "Partner checks QR code status and usage details" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"qr_id\": \"QR_SG_2025_001\",\n \"merchant_id\": \"MERCHANT_SG_123\",\n \"partner_id\": \"SINGAPORE_PARTNER_001\",\n \"amount\": \"100.50\",\n \"currency\": \"SGD\",\n \"fx_rate\": \"83.25\",\n \"inr_amount\": \"8325.00\",\n \"status\": \"used\",\n \"created_at\": \"2025-01-11T10:30:00Z\",\n \"expires_at\": \"2025-01-11T15:30:00Z\",\n \"usage_count\": 1,\n \"max_usage\": 1,\n \"qr_string\": \"upi://pay?pa=merchant@mercury&pn=Singapore%20Test%20Merchant&am=8325.00&cu=INR&mc=5411&pc=P0101\",\n \"last_used_at\": \"2025-01-11T12:45:00Z\",\n \"transactions\": [\n {\n \"txn_id\": \"TXN_SG_001\",\n \"status\": \"success\",\n \"completed_at\": \"2025-01-11T12:45:30Z\"\n }\n ]\n },\n \"message\": \"QR status retrieved successfully\"\n}" } ] } ] }, { "name": "๐Ÿ” International UPI Queries", "description": "PSP internal APIs for international transaction support", "item": [ { "name": "1. Get International QR", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/international-qr?merchant_id=MERCHANT_SG_123&amount=100.50¤cy=SGD&corridor=singapore", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "international-qr"], "query": [ { "key": "merchant_id", "value": "MERCHANT_SG_123" }, { "key": "amount", "value": "100.50" }, { "key": "currency", "value": "SGD" }, { "key": "corridor", "value": "singapore" } ] }, "description": "Get international QR with FX conversion details" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"qr_string\": \"upi://pay?pa=merchant@mercury&pn=Singapore%20Test%20Merchant&am=8325.00&cu=INR&mc=5411\",\n \"foreign_amount\": \"100.50\",\n \"foreign_currency\": \"SGD\",\n \"fx_rate\": \"83.25\",\n \"markup_percentage\": \"2.5\",\n \"inr_amount\": \"8325.00\",\n \"corridor\": \"singapore\",\n \"validity_minutes\": 300\n },\n \"message\": \"International QR generated successfully\"\n}" } ] }, { "name": "2. Get FX Rate", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/{{api_version}}/upi/fx-rate/SGD/INR", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "upi", "fx-rate", "SGD", "INR"] }, "description": "Get current FX rate for currency conversion" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"from_currency\": \"SGD\",\n \"to_currency\": \"INR\",\n \"base_rate\": \"81.25\",\n \"markup_percentage\": \"2.5\",\n \"final_rate\": \"83.25\",\n \"rate_timestamp\": \"2025-01-11T10:30:00Z\",\n \"rate_source\": \"LIVE_MARKET\"\n },\n \"message\": \"FX rate retrieved successfully\"\n}" } ] } ] }, { "name": "๐Ÿ“Š Legacy Transaction APIs", "description": "Legacy transaction management APIs (if needed for backward compatibility)", "item": [ { "name": "1. List Transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/{{api_version}}/transactions?status=success&limit=10&offset=0", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "transactions"], "query": [ { "key": "status", "value": "success" }, { "key": "limit", "value": "10" }, { "key": "offset", "value": "0" } ] }, "description": "List transactions with filtering options" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"transactions\": [\n {\n \"id\": 1,\n \"org_txn_id\": \"TXN_SG_001\",\n \"payer_addr\": \"user@demo-bank\",\n \"payee_addr\": \"merchant@mercury\",\n \"foreign_amount\": \"100.50\",\n \"foreign_currency\": \"SGD\",\n \"fx_rate\": \"83.25\",\n \"inr_amount\": \"8325.00\",\n \"status\": \"success\",\n \"corridor\": \"singapore\",\n \"created_at\": \"2025-01-11T10:30:00Z\",\n \"completed_at\": \"2025-01-11T10:32:15Z\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"limit\": 10,\n \"offset\": 0,\n \"has_more\": false\n }\n },\n \"message\": \"Transactions retrieved successfully\"\n}" } ] }, { "name": "2. Get Transaction Details", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/{{api_version}}/transactions/TXN_SG_001", "host": ["{{base_url}}"], "path": ["api", "{{api_version}}", "transactions", "TXN_SG_001"] }, "description": "Get detailed transaction information with event history" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"transaction\": {\n \"id\": 1,\n \"org_txn_id\": \"TXN_SG_001\",\n \"payer_addr\": \"user@demo-bank\",\n \"payee_addr\": \"merchant@mercury\",\n \"foreign_amount\": \"100.50\",\n \"foreign_currency\": \"SGD\",\n \"fx_rate\": \"83.25\",\n \"inr_amount\": \"8325.00\",\n \"status\": \"success\",\n \"corridor\": \"singapore\",\n \"partner_code\": \"SINGAPORE_PARTNER_001\",\n \"created_at\": \"2025-01-11T10:30:00Z\",\n \"completed_at\": \"2025-01-11T10:32:15Z\"\n },\n \"events\": [\n {\n \"seq\": 1,\n \"event_type\": \"transaction_initiated\",\n \"timestamp\": \"2025-01-11T10:30:00Z\",\n \"payload\": {\n \"initiated_by\": \"NPCI\",\n \"amount\": \"8325.00\"\n }\n },\n {\n \"seq\": 2,\n \"event_type\": \"partner_credit_requested\",\n \"timestamp\": \"2025-01-11T10:30:30Z\",\n \"payload\": {\n \"partner\": \"SINGAPORE_PARTNER_001\",\n \"foreign_amount\": \"100.50\",\n \"currency\": \"SGD\"\n }\n },\n {\n \"seq\": 3,\n \"event_type\": \"transaction_completed\",\n \"timestamp\": \"2025-01-11T10:32:15Z\",\n \"payload\": {\n \"final_status\": \"success\",\n \"partner_response\": \"CS\"\n }\n }\n ]\n },\n \"message\": \"Transaction details retrieved successfully\"\n}" } ] } ] }, { "name": "๐Ÿงช Test & Development", "description": "Testing and development utilities", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/", "host": ["{{base_url}}"], "path": [""] }, "description": "Basic health check endpoint" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "", "host": [""] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "html", "header": [ { "key": "Content-Type", "value": "text/html" } ], "body": "\n\n\n Mercury UPI PSP\n\n\n

Mercury UPI PSP - System Online

\n

UPI Payment Service Provider - Ready for NPCI integration

\n\n" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{partner_token}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "// Auto-generate timestamps for requests", "const now = new Date();", "const timestamp = now.toISOString();", "pm.globals.set('timestamp', timestamp);", "", "// Generate random message IDs for UPI requests", "const messageId = 'MSG' + Math.random().toString(36).substr(2, 32).toUpperCase();", "pm.globals.set('message_id', messageId);", "", "// Generate random transaction IDs", "const txnId = 'TXN' + Math.random().toString(36).substr(2, 32).toUpperCase();", "pm.globals.set('txn_id', txnId);" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "// Basic response validation", "pm.test('Response status is successful', function () {", " pm.expect(pm.response.code).to.be.oneOf([200, 201]);", "});", "", "// Content-Type validation", "pm.test('Response has correct content type', function () {", " const contentType = pm.response.headers.get('Content-Type');", " pm.expect(contentType).to.satisfy(function(type) {", " return type.includes('application/json') || type.includes('application/xml') || type.includes('text/html');", " });", "});", "", "// Response time validation", "pm.test('Response time is reasonable', function () {", " pm.expect(pm.response.responseTime).to.be.below(5000);", "});" ] } } ] }