Production User Token
Pass this token as
user_token in all API requests
Log in to view and manage your live merchant API token, or use this demo token for testing.
Login to View Your Live Merchant Key
Instant Webhook Callback URL
Server-to-server POST notifications upon payment completion
Real-time notifications push order ID, amount, and bank UTR directly to your endpoint as soon as UPI is confirmed.
Register Merchant Account
Retailer & Merchant Integration Guide (रिटेलर इंटीग्रेशन गाइड)
Step-by-step instructions for Retail Websites, Portals (KDSONI API, E-commerce, Wallets) to accept UPI payments
1
Get Production Token & Link Gateways (टोकन एवं गेटवे सेटअप)
Register your account and go to UPI Settings (auth/upisettings.php). Connect any or all of your UPI gateways (Paytm QR, PhonePe, BharatPe, GooglePay, or HDFC). Copy your
user_token.
2
Call Create Order from Checkout (ऑर्डर जनरेट करें)
When your customer initiates a wallet recharge or checkout on your retail site, send a
POST request to https://pgg.hellojee.sbs/api/create-order with your user_token, unique order_id, and amount.
3
Redirect Customer to Secure Payment Page (कस्टमर को पेमेंट पेज पर भेजें)
The API returns
result.payment_url. Redirect the customer's browser to this URL. The customer sees dynamic UPI QR code and 1-tap UPI app intent buttons (GPay, PhonePe, Paytm, BHIM, Cred).
4
Verify Status & Credit Customer Wallet (पेमेंट स्टेटस वेरीफाई करें)
When customer completes payment, PGG redirects to your
redirect_url with the order ID. Your backend simply verifies by calling https://pgg.hellojee.sbs/api/check-order-status, confirms COMPLETED status and bank UTR, and credits the customer's wallet or marks the order completed.
Drop-in Retail PHP Helper (Complete Class for Retail Sites)
Save this code as pgg_helper.php in your retail website directory. You can use it directly in KDSONI API, recharge portals, or custom e-commerce stores:
pgg_helper.php (Retail Ready Helper)
<?php
/**
* A2Z WEB SOLUTIONS - Retailer & Merchant Integration Helper
* Compatible with KDSONI API, Recharge Portals, E-Commerce, SMM Panels
*/
class PGG_Gateway {
private static $user_token = 'c397150ae5d01c32989143612163ac01';
private static $base_url = 'https://pgg.hellojee.sbs';
/**
* Create New UPI Payment Order
* @return array [success => bool, payment_url => string, order_id => string, message => string]
*/
public static function createOrder($order_id, $amount, $customer_mobile = '9876543210', $redirect_url = '') {
$endpoint = self::$base_url . '/api/create-order';
$payload = [
'user_token' => self::$user_token,
'order_id' => (string)$order_id,
'amount' => number_format((float)$amount, 2, '.', ''),
'customer_mobile' => preg_replace('/[^0-9]/', '', (string)$customer_mobile),
'redirect_url' => $redirect_url,
'remark1' => 'Retail Checkout',
'remark2' => 'PGG_GATEWAY'
];
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'User-Agent: PGG-Retail-Client/2.0'
]
]);
$response = curl_exec($ch);
$err = curl_error($ch);
curl_close($ch);
if ($err) {
return ['success' => false, 'message' => 'Connection error: ' . $err];
}
$res = json_decode($response, true);
if (isset($res['status']) && ($res['status'] === true || $res['status'] === 'true') && !empty($res['result']['payment_url'])) {
return [
'success' => true,
'order_id' => $res['result']['orderId'] ?? $order_id,
'payment_url' => $res['result']['payment_url'],
'message' => $res['message'] ?? 'Order Created'
];
}
return [
'success' => false,
'message' => $res['message'] ?? ($res['msg'] ?? 'Unable to initialize order'),
'raw' => $res
];
}
/**
* Verify Live Payment Status
* @return array [success => bool, status => string, is_completed => bool, amount => float, utr => string]
*/
public static function checkStatus($order_id) {
$endpoint = self::$base_url . '/api/check-order-status';
$payload = [
'user_token' => self::$user_token,
'order_id' => (string)$order_id
];
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'User-Agent: PGG-Retail-Client/2.0'
]
]);
$response = curl_exec($ch);
curl_close($ch);
$res = json_decode($response, true);
if (is_array($res) && isset($res['status'])) {
$isCompleted = (strtoupper($res['status']) === 'COMPLETED' || strtoupper($res['result']['status'] ?? '') === 'SUCCESS');
return [
'success' => true,
'status' => $res['status'],
'is_completed' => $isCompleted,
'is_pending' => (strtoupper($res['status']) === 'PENDING'),
'amount' => (float)($res['result']['amount'] ?? 0),
'utr' => $res['result']['utr'] ?? '',
'date' => $res['result']['date'] ?? '',
'raw' => $res
];
}
return ['success' => false, 'status' => 'ERROR', 'message' => 'Malformed response from gateway'];
}
}
?>
REST API Endpoints Reference
Interactive endpoints, parameters, JSON specifications, and copy-paste code snippets
POST
https://pgg.hellojee.sbs/api/create-order
(Accepts JSON & Form URL-encoded)
Initializes a dynamic payment session and generates a high-definition UPI payment link supporting intent apps (GPay, PhonePe, Paytm) and dynamic QR codes.
| Parameter | Type | Requirement | Description | Example |
|---|---|---|---|---|
user_token |
String | Required | Your secret merchant authentication token | c397150ae5d01c32989143612163ac01 |
order_id |
String | Required | Unique transaction ID generated by your system | ORD_1795145742 |
amount |
Numeric | Required | Payment amount in INR (min ₹1.00) | 500.00 |
customer_mobile |
String | Optional | Customer 10-digit Indian phone number | 9876543210 |
redirect_url |
URL | Optional | Customer browser redirect page upon payment | https://yoursite.com/callback |
remark1 |
String | Optional | Custom memo or customer name for reconciliation | Wallet Topup |
remark2 |
String | Optional | Internal User ID or product identifier | USER_1042 |
<?php
$url = 'https://pgg.hellojee.sbs/api/create-order';
$data = [
'user_token' => 'c397150ae5d01c32989143612163ac01',
'order_id' => 'ORD' . time(),
'amount' => '100.00',
'customer_mobile' => '9876543210',
'redirect_url' => 'https://yoursite.com/callback.php',
'remark1' => 'Wallet Recharge'
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json']
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if (!empty($result['result']['payment_url'])) {
// Redirect customer to UPI Checkout
header('Location: ' . $result['result']['payment_url']);
exit;
} else {
echo "Error: " . ($result['message'] ?? 'Failed to initialize order');
}
?>
Success Response (200 OK)
{
"status": true,
"message": "Order Created Successfully",
"result": {
"orderId": "ORD1700000001",
"payment_url": "https://pgg.hellojee.sbs/payment3/instant-pay/471713b37e7220983..."
}
}
Failure Response
{
"status": "false",
"message": "Order ID already exists for this user"
}
POST
https://pgg.hellojee.sbs/api/check-order-status
(Verify live bank confirmation & UTR)
Queries real-time bank status for any initiated order. Returns live transaction status (COMPLETED, PENDING, or FAILED), amount paid, and 12-digit bank UTR / Reference number.
| Parameter | Type | Requirement | Description | Example |
|---|---|---|---|---|
user_token |
String | Required | Your merchant secret authentication token | c397150ae5d01c32989143612163ac01 |
order_id |
String | Required | The order ID generated during checkout | ORD_1795145742 |
<?php
$url = 'https://pgg.hellojee.sbs/api/check-order-status';
$payload = [
'user_token' => 'c397150ae5d01c32989143612163ac01',
'order_id' => 'ORD1700000001'
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json']
]);
$response = curl_exec($ch);
curl_close($ch);
$statusData = json_decode($response, true);
if (($statusData['status'] ?? '') === 'COMPLETED') {
$utr = $statusData['result']['utr'];
$amount = $statusData['result']['amount'];
echo "Payment verified! UTR: $utr, Amount: ₹$amount";
// Credit customer wallet or approve order
} else {
echo "Payment Status: " . ($statusData['status'] ?? 'UNKNOWN');
}
?>
COMPLETED Status Response
{
"status": "COMPLETED",
"message": "Transaction Success",
"result": {
"txnStatus": "COMPLETED",
"resultInfo": "Transaction Success",
"orderId": "ORD1700000001",
"status": "SUCCESS",
"amount": 100,
"date": "2026-10-10 16:30:00",
"utr": "428492019482"
}
}
PENDING Status Response
{
"status": "PENDING",
"message": "Transaction Pending",
"result": {
"txnStatus": "PENDING",
"resultInfo": "Transaction Pending",
"orderId": "ORD1700000001",
"status": "PENDING",
"amount": 100,
"date": "2026-10-10 16:30:00",
"utr": ""
}
}
Downloadable SDKs & CMS Plugins
One-click downloads for production client libraries and WooCommerce store plugins
Interactive Live API Console (इंटरैक्टिव API टेस्टर)
Test order creation and live status verification directly in your browser with real server responses
POST Test /api/create-order
POST Test /api/check-order-status