Paytm UPI & Merchant Gateway API

Base URL: https://paytm.payupi.online/

⚡ Launch Interactive Console

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) and POST (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 200 on ledger match with detailed payer info, or HTTP 404 when 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.

POST GET https://paytm.payupi.online/request-otp.php
ParameterTypeRequirementDescription
mobile_numberstringREQUIRED10-digit registered mobile number.
Example Request (cURL)
curl -X POST "https://paytm.payupi.online/request-otp.php" \
  -H "Content-Type: application/json" \
  -d '{"mobile_number": "7300669643"}'
Success Response (HTTP 200)
{
  "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.

POST GET https://paytm.payupi.online/validate-otp.php
ParameterTypeRequirementDescription
mobile_numberstringREQUIRED10-digit registered mobile number.
otpstringREQUIRED6-digit numeric OTP code received via SMS.
statestringREQUIREDState token returned in Step 1.
Example Request (cURL)
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"
  }'
Success Response (HTTP 200)
{
  "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.

GET POST https://paytm.payupi.online/profile.php
ParameterTypeRequirementDescription
mobile_numberstringOPTIONALTarget mobile session (defaults to active session).
Example Request (cURL)
curl -s "https://paytm.payupi.online/profile.php?mobile_number=7300669643"
Success Response (HTTP 200)
{
  "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.

GET POST https://paytm.payupi.online/bank-details.php
ParameterTypeRequirementDescription
mobile_numberstringOPTIONALTarget mobile number.
Example Request (cURL)
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.

GET POST https://paytm.payupi.online/transactions.php
ParameterTypeRequirementDescription
mobile_numberstringOPTIONALTarget mobile session.
fromDatestringOPTIONALStart date (DD-MM-YYYY). Defaults to 30 days ago.
toDatestringOPTIONALEnd date (DD-MM-YYYY). Defaults to tomorrow.
Example Request (cURL)
curl -s "https://paytm.payupi.online/transactions.php?mobile_number=7300669643"
Success Response (HTTP 200)
{
  "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.

GET POST https://paytm.payupi.online/validate-utr.php
ParameterTypeRequirementDescription
utrstringREQUIRED12-digit unique banking reference number (UTR / RRN).
mobile_numberstringOPTIONALMobile number of target account.
Example Request (cURL)
curl -s "https://paytm.payupi.online/validate-utr.php?mobile_number=7016386899&utr=618544531343"
Success Response (HTTP 200 - Match Found)
{
  "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"
  }
}
Failure Response (HTTP 404 - Not Found)
{
  "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.

GET POST https://paytm.payupi.online/token-verify.php

8. Multi-Account Automation Cron Sweep

Runs health checks and transaction syncs across all registered sessions.

GET https://paytm.payupi.online/cron.php

9. Permanent Session Logout

Permanently terminates session and unlinks disk files.

GET https://paytm.payupi.online/logout.php
Example Request (cURL)
curl -s "https://paytm.payupi.online/logout.php?mobile=7300669643"