GuruPay API Reference

https://gurupaygateway.com/api

{
  "status": "success",
  "message": "Order created successfully",
  "data": {
    "payment_url": "https://gurupaygateway.com/pay/LRd7jTFOV2sFyhMyOBzbJLL1SQzMxe5V",
    "order_id": "ORD_20260911_7948",
    "token": "LRd7jTFOV2sFyhMyOBzbJLL1SQzMxe5V",
    "amount": 100.00,
    "currency": "INR",
    "customer_name": "Raushan Kumar",
    "expires_at": "2026-06-06 11:15:30",
    "created_at": "2026-06-05 11:15:30"
  }
}

{
  "status": "success",
  "data": {
    "order_id": "ORD_20260911_7948",
    "amount": 100.00,
    "currency": "INR",
    "payment_status": "success",
    "customer_name": "Raushan Kumar",
    "customer_mobile": "9999999999",
    "utr": "615372849102",
    "payment_method": "UPI QR",
    "provider": "paytm",
    "gateway_txn_id": "TXN_9201938561",
    "paid_at": "2026-06-05 11:16:45",
    "payment_url": "https://gurupaygateway.com/pay/LRd7jTFOV2sFyhMyOBzbJLL1SQzMxe5V",
    "callback_url": "https://yourwebsite.com/callback.php",
    "expires_at": "2026-06-06 11:15:30",
    "created_at": "2026-06-05 11:15:30"
  }
}

<?php
// Retrieve the signature header
$signature = $_SERVER['HTTP_X_PAYINDIA_SIGNATURE'] ?? '';

// Get Webhook Secret from your settings
$webhookSecret = "your_webhook_secret_key";

// Read raw POST body payload
$payload = file_get_contents('php://input');

// Calculate expected signature
$expectedSignature = hash_hmac('sha256', $payload, $webhookSecret);

// Verify match
if (hash_equals($expectedSignature, $signature)) {
    // Valid request! Parse JSON
    $data = json_decode($payload, true);
    $orderId = $data['order_id'];
    $amount = $data['amount'];
    $utr = $data['utr'];
    $status = $data['status']; // 'success'
    
    if ($data['event'] === 'payment.success') {
        // 1. Mark order as Paid in your database
        // 2. Deliver goods to customer
    }
    
    // Respond with 200 OK to acknowledge receipt
    http_response_code(200);
    echo json_encode(['received' => true]);
} else {
    // Invalid signature, ignore/fail
    http_response_code(400);
    echo "Invalid signature";
}
?>

https://yourwebsite.com/callback.php?status=success&order_id=ORD_20260911_7948&amount=100.00&utr=615372849102

<?php
/**
 * Step 1: Initialize Payment Order
 */
function initiatePayment($orderId, $amount, $customerName) {
    $guruKey = "guru_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
    
    $payload = [
        'amount' => number_format($amount, 2, '.', ''),
        'order_id' => $orderId,
        'customer_name' => $customerName,
        'callback_url' => 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF'] . '?action=callback'
    ];

    $ch = curl_init('https://gurupaygateway.com/api/create-order');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'X-Guru-Key: ' . $guruKey,
        ]
    ]);

    $response = curl_exec($ch);
    $data = json_decode($response, true);
    curl_close($ch);

    if (isset($data['status']) && $data['status'] === 'success') {
        // Redirect customer to GuruPay payment card
        header("Location: " . $data['data']['payment_url']);
        exit;
    } else {
        die("Payment initiation failed: " . ($data['error'] ?? 'Unknown Error'));
    }
}

/**
 * Step 2: Handle Browser Redirect Callback
 */
function handleCallback() {
    $orderId = $_GET['order_id'] ?? '';
    $status = $_GET['status'] ?? '';
    
    if (empty($orderId) || $status !== 'success') {
        die("Payment was not successful or was cancelled.");
    }
    
    // Now verify status securely on the backend
    $guruKey = "guru_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
    
    $ch = curl_init('https://gurupaygateway.com/api/check-status');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode(['order_id' => $orderId]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'X-Guru-Key: ' . $guruKey,
        ]
    ]);

    $response = curl_exec($ch);
    $data = json_decode($response, true);
    curl_close($ch);

    if (isset($data['status']) && $data['status'] === 'success' && $data['data']['payment_status'] === 'success') {
        $amount = $data['data']['amount'];
        $utr = $data['data']['utr'];
        
        echo "<h1 style='color:green;'>Payment Successful!</h1>";
        echo "<p>Thank you, your order <strong>$orderId</strong> of ₹$amount has been paid successfully.</p>";
        echo "<p>UTR Reference: $utr</p>";
    } else {
        echo "<h1 style='color:red;'>Verification Failed</h1>";
        echo "<p>The payment verification returned an unconfirmed status.</p>";
    }
}

// Simple Router Trigger
$action = $_GET['action'] ?? '';
if ($action === 'pay') {
    $randomOrderId = 'ORD_' . uniqid();
    initiatePayment($randomOrderId, 100.00, 'Raushan Kumar');
} elseif ($action === 'callback') {
    handleCallback();
} else {
    // Show initiation button
    echo "<a href='?action=pay' style='padding:12px 24px; background:#1B1F3B; color:#C9A227; text-decoration:none; border-radius:8px; font-family:sans-serif; font-weight:bold;'>Pay ₹100 using GuruPay</a>";
}
?>

Mujhe apni website/app me "GuruPay Payment Gateway" fully integrate karna hai apne single HTML file me.

Pehle mera diya gaya code/structure dhyan se padho, uske hisaab se banao. Jaha "Add Amount" ya "Pay Now" jaisa option hoga, wahan payment start hoga aur success hone par payment success redirect/confirmation dikhna chahiye. Agar ye subscription ka payment hai, to success confirm hone ke baad us subscription ko turant unlock kar do (locked content/features ka lock hata do, "Subscribed" status show karo).

Requirements:
- Sirf EK single HTML file me pura kaam (inline CSS + inline JS ek hi file me), koi separate file nahi.
- Error-free, fully working, production-style code do — incomplete ya example-only snippet mat do.
- Neeche di gayi API details ke basis par pura end-to-end payment flow banao:
  1. Create Order — user amount enter kare ya plan select kare, us par click karte hi create-order API call ho.
  2. Payment Page Redirect — API response me mile "payment_url" par user ko redirect karo.
  3. Callback Handling — payment ke baad wapas is page par aane par URL params (order_id, status) read karo.
  4. Status Verification — sirf URL params par bharosa mat karo, hamesha check-status API call karke confirm karo ki payment fully successful hai.
  5. Amount Payment Flow — normal amount payment success hone par "Payment Successful" confirmation screen dikhao.
  6. Subscription Payment Flow — subscription payment success confirm hone ke baad subscription unlock karo aur locked/premium content ko turant accessible bana do.
- Loading state, error state, aur success state teeno cleanly handle karo.
- UI clean, simple aur mobile-friendly rakho.
- Final pura single HTML code ek hi baar me do jo copy-paste karte hi directly kaam kare.

=== API DETAILS ===

1) CREATE ORDER API
Endpoint: POST https://gurupaygateway.com/api/create-order
Headers:
  X-Guru-Key: guru_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  Content-Type: application/json
Body (JSON):
{
  "amount": "100.00",
  "order_id": "ORD_20260911_XXXX",
  "customer_name": "Customer Name",
  "description": "Order description",
  "callback_url": "https://yourwebsite.com/your-page.html"
}
Success Response (201):
{
  "status": "success",
  "data": {
    "payment_url": "https://gurupaygateway.com/pay/xxxxxxxxxxxx",
    "order_id": "ORD_20260911_XXXX",
    "amount": 100.00,
    "currency": "INR"
  }
}

2) CHECK STATUS API
Endpoint: POST https://gurupaygateway.com/api/check-status
Headers:
  X-Guru-Key: guru_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  Content-Type: application/json
Body (JSON):
{
  "order_id": "ORD_20260911_XXXX"
}
Success Response (200):
{
  "status": "success",
  "data": {
    "order_id": "ORD_20260911_XXXX",
    "amount": 100.00,
    "payment_status": "success",
    "utr": "615372849102",
    "paid_at": "2026-08-09 21:41:09"
  }
}

Is API key aur endpoint ko exactly isi tarah hardcode karke use karo. Ab upar diye gaye structure/design ke hisaab se pura single HTML file bana kar do.