paytm.lushai.dev

PayTM UPI Payment Collection Gateway

Enable instant UPI payments, QR code dynamic generation, order status polling, and instant HTTP POST webhook callbacks for your websites, SaaS apps, and mobile applications.

Launch paytm.lushai.dev
PayTM Gateway by Lushai Dev Showcase

PayTM Gateway Core Capabilities

Developer-centric payment processing engineered for speed, security, and effortless merchant integration.

Instant Order Session Creation

Initialize payment orders via HTTP POST API requests and get dynamic instant payment URLs for custom checkout flows.

Real-Time Order Verification

Query transaction status, bank UTR reference numbers, completion timestamps, and exact payment amounts instantly.

Automated Webhook Callbacks

Receive instant HTTP POST webhook payload notifications directly to your server URL upon successful customer payment.

UPI & Intent App Compatibility

Supports direct UPI app redirect, Paytm QR code scanning, and desktop/mobile multi-platform payment collection.

Merchant API Token Authentication

Secure authentication using unique Merchant API Tokens for order creation, status verification, and merchant dashboard management.

Plug-and-Play Code Snippets

Ready-to-use cURL commands, PHP code examples, and lightweight JSON payloads for fast 5-minute integration.

PayTM Gateway API Reference & Specs

Complete API endpoints, parameter requirements, JSON response samples, and webhook payloads.

1. Create Order API

Initialize a UPI payment order session and generate instant payment URL.

POST
POST https://paytm.lushai.dev/api/create-order.php

Request Body Parameters (POST / Form Data)

Parameter Type Required Description
user_token String Required Your Merchant API Token from API Details.
amount Decimal / String Required Order amount in INR (e.g. "100.00").
order_id String Required Your unique merchant transaction/order ID (e.g. "ORD123456").
customer_mobile String Required Customer 10-digit mobile number.
redirect_url URL Required Redirect URL after customer completes payment.
remark1 String Optional Optional note, customer name, or product label.
remark2 String Optional Optional secondary remark or reference.

Sample Response (201 Created)

{
  "status": true,
  "message": "Order Created Successfully",
  "result": {
    "orderId": "ORD123456",
    "payment_url": "https://paytm.lushai.dev/pay/instant-pay/329f10a842b109c847"
  }
}

2. Check Order Status API

Query the payment status of an existing order ID.

POST
POST https://paytm.lushai.dev/api/check-order-status.php

Request Body Parameters (POST / Form Data)

Parameter Type Required Description
user_token String Required Your Merchant API Token.
order_id String Required Merchant order ID to query.

Sample Response (200 OK)

{
  "status": "COMPLETED",
  "message": "Transaction Successfully",
  "result": {
    "txnStatus": "COMPLETED",
    "resultInfo": "Transaction Success",
    "orderId": "ORD123456",
    "status": "SUCCESS", // SUCCESS, PENDING, or FAILURE
    "amount": "100.00",
    "date": "2026-08-10 11:57:54",
    "utr": "329481029384"
  }
}

3. Webhook Configuration & Callbacks

Configure your Webhook / Callback URL under API Details in merchant dashboard. When a payment completes, our gateway dispatches instant HTTP POST notification.

Sample Webhook Callback Payload (HTTP POST)

{
  "status": "SUCCESS",
  "order_id": "ORD123456",
  "amount": "100.00",
  "utr": "329481029384",
  "customer_mobile": "9876543210",
  "create_date": "2026-08-10 11:57:54"
}

4. Integration Code Examples

Ready-to-use integration code snippets in PHP and cURL.

PHP cURL Example

<?php
$post_data = [
    "user_token"      => "YOUR_MERCHANT_API_TOKEN",
    "amount"          => "100.00",
    "order_id"        => "ORD_" . time(),
    "customer_mobile" => "9876543210",
    "redirect_url"    => "https://yoursite.com/success.php",
    "remark1"         => "Order Payment"
];

$ch = curl_init("https://paytm.lushai.dev/api/create-order.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if (isset($result['result']['payment_url'])) {
    header("Location: " . $result['result']['payment_url']);
    exit;
} else {
    echo "Error: " . ($result['message'] ?? 'Order creation failed');
}
?>

cURL Command Example

curl -X POST https://paytm.lushai.dev/api/create-order.php \
  -F "user_token=YOUR_MERCHANT_API_TOKEN" \
  -F "amount=100.00" \
  -F "order_id=ORD123456" \
  -F "customer_mobile=9876543210" \
  -F "redirect_url=https://yoursite.com/success.php"
Access PayTM Merchant Dashboard

Paytm Gateway Frequently Asked Questions

Answers to common questions regarding UPI order creation, webhook verification, and merchant integration.

Webhooks are dispatched instantly within 500 milliseconds of bank transaction completion with HMAC-SHA256 signature verification.

Yes! Paytm gateway provides simple JSON endpoints compatible with PHP (cURL/Guzzle), Node.js (Axios/Fetch), Python, Go, and mobile app backends.

Sending a POST request to /api/create-order.php with order details returns a unique payment_url that redirects users to an automated QR & UPI intent checkout page.

Yes, merchants can poll /api/check-order-status.php with their order_id to retrieve real-time bank UTR numbers and confirmation timestamps.

Start Collecting UPI Payments Today

Register on PayTM Gateway by Lushai Dev to acquire your Merchant API Token and integrate instant payments.