Overview & Architecture
The Paytm UPI gateway engine interfaces directly with Paytm's secure channel & acquiring ledger API.
It supports real-time multi-account authorization, instant OTP verification, automatic session persistence in
sessions/{mobile}.json and session.json, live UPI QR generation, and millisecond-grade 12-digit UTR payment reconciliation.
Key Capabilities:
- Supports Dual Protocols: All endpoints accept HTTP
GET(query string) andPOST(application/json or form-data). - No Frontend Records Limits: Transactions are fetched based on dynamic date ranges without artificial record cutoffs.
- Precise 12-Digit UTR Validation: Verification returns HTTP
200on ledger match with detailed payer info, or HTTP404when not found. - Isolated Multi-Account Storage: Each account is independently saved under
sessions/{mobile}.json.
1. Request Login OTP
Dispatches an official 6-digit login OTP SMS to the customer's registered mobile number.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| mobile_number | string | REQUIRED | 10-digit registered mobile number. |
curl -X POST "https://paytm.payupi.online/request-otp.php" \
-H "Content-Type: application/json" \
-d '{"mobile_number": "7300669643"}'
{
"status": "success",
"status_code": 200,
"message": "OTP has been sent to your mobile number.",
"data": {
"mobile_number": "7300669643",
"state": "7fb3fc23-b471-5c0d-b50b-6a6582f28cf3",
"csrf_token": "3a97734d-8109-508d-96f1-33612e3a4abe"
}
}
2. Validate OTP & Create Session
Verifies the 6-digit OTP code along with the state token, establishes the session, and saves credentials to disk.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| mobile_number | string | REQUIRED | 10-digit registered mobile number. |
| otp | string | REQUIRED | 6-digit numeric OTP code received via SMS. |
| state | string | REQUIRED | State token returned in Step 1. |
curl -X POST "https://paytm.payupi.online/validate-otp.php" \
-H "Content-Type: application/json" \
-d '{
"mobile_number": "7300669643",
"otp": "123456",
"state": "7fb3fc23-b471-5c0d-b50b-6a6582f28cf3"
}'
{
"status": "success",
"status_code": 200,
"message": "OTP validated successfully. Session established.",
"data": {
"mobile_number": "7300669643",
"user_name": "OMKANT",
"primary_vpa": "7300669643@pthdfc",
"userToken": "007ybgtw1ffwice7k2d4p8dq3uto8ryk2280",
"userId": "1058239506"
}
}
3. User Profile & QR Code
Retrieves user name, registered VPAs, QR code data string, and merchant branding info.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| mobile_number | string | OPTIONAL | Target mobile session (defaults to active session). |
curl -s "https://paytm.payupi.online/profile.php?mobile_number=7300669643"
{
"status": "success",
"status_code": 200,
"message": "Paytm profile fetched successfully.",
"data": {
"mobile_number": "7300669643",
"user_name": "OMKANT",
"primary_vpa": "7300669643@pthdfc",
"qr_string": "upi://pay?pa=7300669643@pthdfc&pn=OMKANT&cu=INR"
}
}
4. Linked Bank Accounts
Retrieves linked bank accounts, masked account numbers, IFSC codes, and settlement account preferences.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| mobile_number | string | OPTIONAL | Target mobile number. |
curl -s "https://paytm.payupi.online/bank-details.php?mobile_number=7300669643"
5. Fetch All Transactions
Retrieves live ledger records across consumer P2P/P2M passbook and merchant acquiring orders. No records limit parameter is required — pass date ranges as needed.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| mobile_number | string | OPTIONAL | Target mobile session. |
| fromDate | string | OPTIONAL | Start date (DD-MM-YYYY). Defaults to 30 days ago. |
| toDate | string | OPTIONAL | End date (DD-MM-YYYY). Defaults to tomorrow. |
curl -s "https://paytm.payupi.online/transactions.php?mobile_number=7300669643"
{
"status": "success",
"status_code": 200,
"message": "Paytm UPI transactions fetched successfully.",
"data": {
"mobile_number": "7300669643",
"account_type": "PERSONAL_UPI",
"primary_vpa": "7300669643@pthdfc",
"total_count": 10,
"summary": {
"total_transactions": 10,
"total_credit_amount": 9.00,
"total_debit_amount": 250.00
},
"transactions": [
{
"source": "PAYTM_UPI",
"txn_id": "SMY11006604325A448D99E135E30AD5D922",
"order_id": "SMY11006604325A448D99E135E30AD5D922",
"utr": "632204124884",
"rrn": "632204124884",
"amount": 1,
"amount_in_paise": 100,
"amount_formatted": "₹1.00",
"type": "CREDIT",
"status": "SUCCESS",
"payer_name": "Yatendra Rajput",
"payer_vpa": "",
"payee_vpa": "7300669643@pthdfc",
"payee_name": "Omkant",
"channel": "UPI",
"timestamp": "2026-11-18 04:36:03"
}
]
}
}
6. Validate UTR / RRN
Verifies payment authenticity by cross-referencing a 12-digit UTR/RRN against real ledger records.
Returns HTTP 200 on match, or HTTP 404 when not found.
| Parameter | Type | Requirement | Description |
|---|---|---|---|
| utr | string | REQUIRED | 12-digit unique banking reference number (UTR / RRN). |
| mobile_number | string | OPTIONAL | Mobile number of target account. |
curl -s "https://paytm.payupi.online/validate-utr.php?mobile_number=7016386899&utr=618544531343"
{
"status": "success",
"status_code": 200,
"message": "Payment verified successfully by UTR.",
"data": {
"matched": true,
"utr": "618544531343",
"rrn": "618544531343",
"txn_id": "PTMDE5024A97CC344C9A4A6C872CCC01EE1",
"order_id": "PTMDE5024A97CC344C9A4A6C872CCC01EE1",
"amount": 500,
"amount_in_paise": 50000,
"amount_formatted": "₹500.00",
"type": "DEBIT",
"status": "SUCCESS",
"payer_name": "SADAT JIGARKUMAR RAMESHBHAI",
"payer_vpa": "r-sadat@ptyes",
"payee_vpa": "9296199846-3@ybl",
"payee_name": "Vikash Kumar",
"timestamp": "2026-11-20 12:32:19",
"channel": "UPI"
}
}
{
"status": "failed",
"status_code": 404,
"message": "Transaction not found for UTR / RRN: 999999999999",
"data": {
"matched": false,
"utr": "999999999999"
}
}
7. Verify Session Token
Validates active session tokens against the upstream server.
8. Multi-Account Automation Cron Sweep
Runs health checks and transaction syncs across all registered sessions.
9. Permanent Session Logout
Permanently terminates session and unlinks disk files.
curl -s "https://paytm.payupi.online/logout.php?mobile=7300669643"