Developer Portal

API Documentation

Integrate Paytm UPI Gateway UPI Payment Gateway into your app or website. Accept 0% fee UPI payments with real-time callbacks.

1. Copy API Token

2. Create Order

Send a POST request to /api/create-order.php to generate customer payment URL.

3. Real-Time Webhook

Set your webhook URL under API Details to receive instant payment callbacks.

1. Create Order API

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

POST https://www.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.

Response (201 Created)

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

2. Check Order Status API

Query the payment status of an existing order ID.

POST https://www.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.

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-09 22:46:29",
    "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-09 22:46:29"
}

4. 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://www.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

curl -X POST https://www.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"

Get Started

Ready to Accept Payments?

Create your merchant account now and get instant API key access.