इंटीग्रेशन गाइड

डेवलपर API एवं SDK दस्तावेज़

PayPulse UPI को अपनी किसी भी वेबसाइट, ऐप या ई-कॉमर्स स्टोर में आसानी से जोड़ने का पूरा विवरण।

1. जावास्क्रिप्ट पॉपअप चेकआउट (पसंदीदा)

यह विधि सबसे आसान है। इसके लिए आपको किसी सर्वर कॉन्फ़िगरेशन की आवश्यकता नहीं होती। बस अपने HTML पेज के हेड में SDK स्क्रिप्ट जोड़ें और बटन क्लिक पर चेकआउट खोलें:

<!-- 1. SDK स्क्रिप्ट लोड करें -->
<script src="http://localhost/upi-payment-gateway/sdk/PayPulse.js"></script>

<!-- 2. पेमेंट फंक्शन कॉल करें -->
<script>
PayPulse.open({
    apiKey: 'YOUR_API_KEY_HERE',
    amount: 499.00,
    orderId: 'ORD_' + Date.now(),
    customerName: 'अजय कुमार',
    customerPhone: '9876543210',
    onSuccess: function(response) {
        console.log('भुगतान सफल:', response);
        // आपका आर्डर सफल पेज
        window.location.href = '/success.php?order=' + response.order_id;
    }
});
</script>

2. कस्टम PHP SDK (सर्वर-साइड इंटीग्रेशन)

यदि आपकी वेबसाइट कस्टम PHP या शेयर्ड होस्टिंग पर है, तो हमारी sdk/PayPulse.php फाइल डाउनलोड करके अपनी वेबसाइट में शामिल करें:

<?php
require_once 'PayPulse.php';

$gateway = new PayPulse('pk_live_your_api_key_here', 'http://localhost/upi-payment-gateway');

// नया PhonePe डायनामिक QR आर्डर बनाएं
$order = $gateway->createOrder([
    'order_id' => 'MY_SHOP_ORD_1001',
    'amount' => 750.00,
    'customer_name' => 'सुनील वर्मा',
    'redirect_url' => 'https://myshop.com/payment-complete.php',
    'webhook_url' => 'https://myshop.com/api/payment-callback.php'
]);

if ($order['status'] === 'success') {
    // ग्राहक को हमारे सिक्योर चेकआउट पेज पर रीडायरेक्ट करें
    header("Location: " . $order['data']['checkout_url']);
    exit;
} else {
    echo "त्रुटि: " . $order['message'];
}
?>

3. REST API संदर्भ

आप Node.js, Python, Laravel या किसी भी भाषा से डायरेक्ट REST API कॉल कर सकते हैं:

POST http://localhost/upi-payment-gateway/api/v1/create-order.php

अनुरोध हेडर: Content-Type: application/json

{
  "api_key": "pk_live_xxxxx",
  "order_id": "ORD_12345",
  "amount": 250.00,
  "customer_name": "राहुल कुमार",
  "customer_phone": "9999988888"
}
⚠️

4. 3, 6, 12 माह सब्सक्रिप्शन एक्सपायरी एवं चेतावनी

गेटवे में ऑटोमैटिक सुरक्षा प्रणाली शामिल है:

  • यदि आपका सब्सक्रिप्शन 7 दिन से कम शेष हो, तो हर API रिस्पांस में warning संदेश भेजा जाता है।
  • सब्सक्रिप्शन समाप्त होने पर API खुद-ब-खुद नए ऑर्डर्स ब्लॉक कर देती है (SUBSCRIPTION_EXPIRED) जिससे अवांछित ट्रांजैक्शन न हों।
  • मर्चेंट पोर्टल से एक क्लिक में 3, 6 अथवा 12 महीने के लिए नवीनीकरण किया जा सकता है।