5 मिनट में अपने एकीकरण का परीक्षण करें
हमारे सार्वजनिक सैंडबॉक्स API प्लेग्राउंड का उपयोग साझा परीक्षण क्रेडेंशियल्स के साथ करें। कोई वास्तविक राशि शुल्क नहीं ली जाती — ऑर्डर कभी लाइव भुगतान प्रदाताओं तक नहीं पहुँचते।
चरण 1: सैंडबॉक्स क्रेडेंशियल्स प्राप्त करें
/sandbox खोलें। App ID, API Key (हस्ताक्षर के लिए), और Query Key (ऑर्डर देखने के लिए) कॉपी करें।
चरण 2: एक परीक्षण ऑर्डर बनाएं
प्लेग्राउंड फॉर्म का उपयोग करें या /api/createorder पर हस्ताक्षरित POST भेजें:
curl -X POST "https://your-domain.com/api/createorder" \
-H "Content-Type: application/json" \
-d '{
"appid": "YOUR_SANDBOX_APPID",
"action": "createorder",
"clientip": "127.0.0.1",
"amount": "9.99",
"currency": "USD",
"paymentMethod": "alipay",
"description": "Test order",
"notify_url": "https://your-domain.com/api/sandbox/webhook-receiver",
"sign_type": "MD5",
"sign": "CALCULATED_MD5_SIGN"
}'प्लेग्राउंड आपके लिए MD5 हस्ताक्षर की गणना करता है। एल्गोरिदम के लिए API दस्तावेज़ — हस्ताक्षर देखें।
चरण 3: भुगतान का अनुकरण करें
redirectUrl को create-order प्रतिक्रिया से खोलें (या प्लेग्राउंड में Simulate pay का उपयोग करें)। Simulate Success पर क्लिक करें। गेटवे आपके notify_url पर एक वेबहुक को कतारबद्ध करता है।
चरण 4: वेबहुक हस्ताक्षर सत्यापित करें
कॉलबैक GET अनुरोध के रूप में भेजे जाते हैं, जिनमें sign और sign_type=MD5 सहित क्वेरी पैरामीटर शामिल होते हैं। अपनी API कुंजी के साथ, ऑर्डर बनाने की तरह ही उसी एल्गोरिदम का उपयोग करके सत्यापित करें।
// Node.js उदाहरण (अवधारणात्मक)
const crypto = require('crypto');
function verifyCallback(params, apiKey) {
const copy = { ...params };
delete copy.sign;
delete copy.sign_type;
const keys = Object.keys(copy).filter(k => copy[k] != null).sort();
const str = keys.map(k => k + '=' + copy[k]).join('&') + apiKey;
const expected = crypto.createHash('md5').update(str).digest('hex');
return expected === params.sign;
}आपके सर्वर को सादे टेक्स्ट success (केस-असंवेदनशील) के साथ प्रतिक्रिया देनी चाहिए।
चरण 5: ऑर्डर स्थिति क्वेरी करें
GET /api/order?action=order&appid=APPID&key=QUERY_KEY&paymentId=ORDER_IDया सार्वजनिक एंडपॉइंट को पोल करें: GET /api/order/status/:orderId
उत्पादन में जाना
- एक व्यापारी खाता पंजीकृत करें और अपने उत्पादन
appid,apikey, औरkeyका उपयोग करें। - खाता सेटिंग्स या प्रति ऑर्डर में अपना वास्तविक
notify_urlसेट करें। - क्लाइंट-साइड कोड में API Key कभी भी उजागर न करें।
- हमेशा सर्वर-साइड पर वेबहुक हस्ताक्षर सत्यापित करें।
पूर्ण संदर्भ: API दस्तावेज़ीकरण · लाइव परीक्षण: सैंडबॉक्स प्लेग्राउंड