Instant UPI payment order session initialization, dynamic payment URL generation, real-time status verification, and automated merchant webhooks.
Developer-centric payment processing engineered for speed, security, and effortless merchant integration.
Initialize payment orders via HTTP POST API requests and get dynamic instant payment URLs for custom checkout flows.
Query transaction status, bank UTR reference numbers, completion timestamps, and exact payment amounts instantly.
Receive instant HTTP POST webhook payload notifications directly to your server URL upon successful customer payment.
Supports direct UPI app redirect, Paytm QR code scanning, and desktop/mobile multi-platform payment collection.
Secure authentication using unique Merchant API Tokens for order creation, status verification, and merchant dashboard management.
Ready-to-use cURL commands, PHP code examples, and lightweight JSON payloads for fast 5-minute integration.
Complete API endpoints, parameter requirements, JSON response samples, and webhook payloads.
Initialize a UPI payment order session and generate instant payment URL.
POST https://paytm.lushai.dev/api/create-order.php
| 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. |
{
"status": true,
"message": "Order Created Successfully",
"result": {
"orderId": "ORD123456",
"payment_url": "https://paytm.lushai.dev/pay/instant-pay/329f10a842b109c847"
}
}
Query the payment status of an existing order ID.
POST https://paytm.lushai.dev/api/check-order-status.php
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_token | String | Required | Your Merchant API Token. |
| order_id | String | Required | Merchant order ID to query. |
{
"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"
}
}
Configure your Webhook / Callback URL under API Details in merchant dashboard. When a payment completes, our gateway dispatches instant HTTP POST notification.
{
"status": "SUCCESS",
"order_id": "ORD123456",
"amount": "100.00",
"utr": "329481029384",
"customer_mobile": "9876543210",
"create_date": "2026-08-10 11:57:54"
}
Ready-to-use integration code snippets in PHP and cURL.
<?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 -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"
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.
Register on PayTM Gateway by Lushai Dev to acquire your Merchant API Token and integrate instant payments.