Copy & Paste into Any AI to Integrate Instantly
Enter your API Key and Redirect URL below, click Copy AI Prompt, and paste it into ChatGPT, Claude, or Cursor alongside your website, bot, or app code. The TruexGateway Arrival Banner and Checkout Modal work automatically when an order is created.
https://truexgateway.xyz.viphub.online/api/create-order.php
X-API-Key: txg_live_...
Creates a locked-amount UPI order and returns orderId, checkoutUrl, qrUrl, and qrDownloadUrl. Opening checkoutUrl automatically launches the TruexGateway Arrival Banner and redirects back to the referring page once paid.
| Parameter | Type | Required | Description |
|---|---|---|---|
amount |
number / string | Yes | Order amount in INR (`1.00` to `100000.00`). |
orderRef |
string | Optional | Your custom Order ID (e.g. `ORD-9812`). Auto-generated in IST if omitted. |
redirectUrl |
string (URL) | Optional | URL where the customer redirects after payment succeeds (automatically returns to the referring page if omitted). |
webhookUrl |
string (URL) | Optional | Your server endpoint to receive instant HMAC-SHA256 signed POST notifications when payment succeeds. |
description |
string | Optional | Order note embedded in the UPI transaction remark (`tn`). |
curl -X POST https://truexgateway.xyz.viphub.online/api/create-order.php \
-H "X-API-Key: txg_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": "499.00",
"orderRef": "ORD-2026-101",
"description": "Order Payment",
"redirectUrl": "https://yoursite.com/payment-success",
"webhookUrl": "https://yoursite.com/api/truex-webhook"
}'
https://truexgateway.xyz.viphub.online/api/generate-qr.php?orderId=TXG...&public=1
Renders or downloads a high-contrast, locked-amount dynamic UPI QR code PNG for any orderId with a built-in white quiet-zone border on all 4 sides so gallery scanning in Google Pay, PhonePe, and Paytm works with zero errors. Perfect for custom checkout pages, Telegram bots, Discord bots, and mobile apps.
| Query Parameter | Value | Required | Description |
|---|---|---|---|
orderId |
TXG... |
Yes | The unique orderId returned by /api/create-order.php. |
public |
1 |
Yes | Allows public rendering inside customer <img> tags and Telegram/Discord bots without headers. |
download |
1 (Optional) |
Optional | Forces direct PNG file attachment download (`Content-Disposition: attachment`) with a 12px white border on all 4 sides straight into the user's Gallery. |
<!-- 1. Embed Dynamic QR Code Image Directly in HTML -->
<img src="https://truexgateway.xyz.viphub.online/api/generate-qr.php?orderId=TXG8A91B2C3D4E5&public=1"
alt="Scan UPI QR" width="220" height="220">
<!-- 2. Direct 1-Click Save QR to Phone Gallery Button -->
<a href="https://truexgateway.xyz.viphub.online/api/generate-qr.php?orderId=TXG8A91B2C3D4E5&public=1&download=1"
download="TruexGateway-QR.png">
Save QR to Gallery
</a>
// 3. Send QR Image Directly in a Telegram Bot (Node.js / Python / PHP)
https://api.telegram.org/bot<BOT_TOKEN>/sendPhoto?chat_id=<CHAT_ID>&photo=https%3A%2F%2Ftruexgateway.xyz.viphub.online%2Fapi%2Fgenerate-qr.php%3ForderId%3DTXG8A91B2C3D4E5%26public%3D1&caption=Scan+to+Pay
orderId=DEMO_ORDER_TXG)
Generated dynamically by /api/generate-qr.php with safe quiet-zone padding on all 4 sides.
https://truexgateway.xyz.viphub.online/api/payment-status.php?orderId=TXG...&public=1
Verifies live payment status across your connected Paytm Business, BharatPe, or FamPay gateway. Returns status: "success", 12-digit bank utr, and verifiedAtIst (Kolkata time).
// Webhook Payload Sent to your webhookUrl (HTTP POST)
// Header: X-Truex-Signature: <HMAC-SHA256 of raw JSON body using your Webhook Secret>
{
"event": "payment.success",
"orderId": "TXG8A91B2C3D4E5",
"orderRef": "ORD-2026-101",
"status": "success",
"amount": "499.00",
"currency": "INR",
"utr": "431982746510",
"gateway": "paytm",
"verifiedAtIst": "26 Oct 2026, 09:26:00 AM"
}