# ๐ฎ Postman Collection Import Guide
## ๐ฏ **Mercury UPI PSP - Complete API Collection**
This Postman collection provides comprehensive testing coverage for all Mercury UPI PSP APIs including NPCI interface and Partner APIs.
## ๐ฅ **How to Import**
### **Method 1: Import JSON File**
1. Open Postman
2. Click **Import** button (top-left)
3. Select **File** tab
4. Choose `Mercury_UPI_PSP_Postman_Collection.json`
5. Click **Import**
### **Method 2: Import from URL**
1. Open Postman
2. Click **Import** button
3. Select **Link** tab
4. Paste: `https://raw.githubusercontent.com/momentpay/UPI-PSP/main/Mercury_UPI_PSP_Postman_Collection.json`
5. Click **Continue** โ **Import**
## ๐๏ธ **Collection Structure**
### **๐๏ธ NPCI โ PSP Interface (Official UPI APIs)**
- โ
**QR Validation (ReqValQR)** - NPCI validates merchant QR
- โ
**Payment Processing (ReqPay)** - NPCI processes payment
- โ
**Transaction Status Check (ReqChkTxn)** - NPCI checks status
- โ
**Heartbeat Check (ReqHbt)** - NPCI health monitoring
- โ
**Batch Transaction Check** - Multiple transaction processing
- โ
**Settlement Reconciliation** - Daily settlement matching
- โ
**Mandate Management** - Recurring payment setup
### **๐ค Partner โ PSP Interface (Business APIs)**
- โ
**Generate QR Code** - Partner creates dynamic QR
- โ
**Check QR Status** - Partner monitors QR usage
### **๐ International UPI Queries**
- โ
**Get International QR** - QR with FX conversion
- โ
**Get FX Rate** - Real-time currency rates
### **๐ Legacy Transaction APIs**
- โ
**List Transactions** - Transaction history
- โ
**Get Transaction Details** - Detailed transaction info
## โ๏ธ **Environment Setup**
### **Create Environment Variables:**
1. **Create New Environment** in Postman
2. **Add Variables:**
| Variable | Value | Description |
|----------|-------|-------------|
| `base_url` | `http://localhost:4040` | Local development server |
| `api_version` | `v1` | API version |
| `partner_token` | `your-partner-token` | Partner authentication |
### **Production Environment:**
| Variable | Value | Description |
|----------|-------|-------------|
| `base_url` | `https://upi-psp.mercury.com` | Production server |
| `api_version` | `v1` | API version |
| `partner_token` | `prod-partner-token` | Production token |
## ๐งช **Testing Features**
### **Pre-request Scripts:**
- โ
**Auto-generate timestamps** for UPI requests
- โ
**Generate random message IDs** (NPCI format)
- โ
**Generate random transaction IDs** (UUID format)
### **Test Scripts:**
- โ
**Response status validation** (200/201)
- โ
**Content-Type validation** (JSON/XML/HTML)
- โ
**Response time validation** (< 5 seconds)
### **Sample Data:**
- โ
**Realistic UPI XML** requests
- โ
**International merchant** data
- โ
**Multi-currency** examples
- โ
**Partner integration** scenarios
## ๐ **Quick Start Testing**
### **1. Start Local Server:**
```bash
cd /path/to/mercury_upi_psp
mix phx.server
```
### **2. Test NPCI APIs:**
1. Open **"๐๏ธ NPCI โ PSP Interface"** folder
2. Run **"4. Heartbeat Check (ReqHbt)"** first
3. Verify XML response with `result="SUCCESS"`
4. Test other NPCI APIs in sequence
### **3. Test Partner APIs:**
1. Open **"๐ค Partner โ PSP Interface"** folder
2. Run **"1. Generate QR Code"**
3. Copy `qr_id` from response
4. Run **"2. Check QR Status"** with copied ID
### **4. Test International Features:**
1. Open **"๐ International UPI Queries"** folder
2. Test **"2. Get FX Rate"** for SGDโINR conversion
3. Test **"1. Get International QR"** with FX parameters
## ๐ **Expected Response Formats**
### **NPCI APIs (XML):**
```xml
```
### **Partner APIs (JSON):**
```json
{
"success": true,
"data": {
"qr_id": "QR_SG_2025_001",
"qr_string": "upi://pay?pa=merchant@mercury...",
"amount": "100.50",
"currency": "SGD",
"fx_rate": "83.25",
"inr_amount": "8325.00"
},
"message": "QR code generated successfully"
}
```
## ๐ง **Troubleshooting**
### **Common Issues:**
1. **Connection Refused:**
- โ
Ensure Phoenix server is running (`mix phx.server`)
- โ
Check `base_url` variable points to correct port
2. **XML Parsing Errors:**
- โ
Verify Content-Type is `application/xml`
- โ
Check XML format matches NPCI specification
3. **Authentication Errors:**
- โ
Set `partner_token` environment variable
- โ
Check Authorization header in Partner APIs
4. **Route Not Found:**
- โ
Verify API endpoints match router configuration
- โ
Check for typos in endpoint URLs
## ๐ **Testing Checklist**
### **โ
NPCI Compliance Tests:**
- [ ] All 4 mandatory UPI APIs respond correctly
- [ ] XML format matches NPCI specification
- [ ] Error codes follow UPI standard
- [ ] Response times under 5 seconds
### **โ
Partner Integration Tests:**
- [ ] QR generation with all currencies (SGD, USD, AED, EUR, GBP)
- [ ] FX rate conversion accuracy
- [ ] QR status tracking works correctly
- [ ] International corridors supported
### **โ
Performance Tests:**
- [ ] Concurrent request handling
- [ ] Large batch processing
- [ ] High-volume QR generation
- [ ] Database transaction integrity
## ๐ **Collection Benefits**
1. **๐ฏ Complete Coverage** - All APIs documented and testable
2. **๐ Environment Switching** - Easy dev/staging/prod testing
3. **๐งช Automated Testing** - Built-in validation scripts
4. **๐ Documentation** - Self-documenting API examples
5. **๐ Quick Onboarding** - New developers can test immediately
---
**Your Mercury UPI PSP APIs are now fully testable with this comprehensive Postman collection!** ๐