एक ही कॉल में गिफ्ट कार्ड और eSIM जारी करें
हर प्रोडक्ट फ़ैमिली के लिए एक कैटलॉग। ऑर्डर की कीमत उसी पल तय होती है जब आप उसे देते हैं और आपकी तय की गई ऊपरी सीमा से कभी ज़्यादा नहीं होती, यह आपके प्रीपेड वॉलेट के सामने आइडेम्पोटेंट है, और वेबहुक साइन किए जाते हैं — इसलिए रीट्राई सुरक्षित हैं और लॉन्च का दिन बिल्कुल बोरिंग।
आपके वर्कस्पेस को मंज़ूरी मिलने के बाद API कुंजियाँ मर्चेंट डैशबोर्ड में जारी और मैनेज की जाती हैं।
ऑर्डर कैसे आगे बढ़ता है
एक छोटा-सा लूप — तीन कॉल और एक साइन किया हुआ वेबहुक — और हर प्रोडक्ट फ़ैमिली के लिए यही लूप।
प्रोडक्ट खोजें
GET /products
गिफ्ट कार्ड, eSIM प्लान और मोबाइल रिचार्ज का एक ही कैटलॉग श्रेणी, देश या टेक्स्ट से ब्राउज़ करें — या जो प्रोडक्ट आप बेचते हैं, ठीक उन्हीं को id से रिफ्रेश करें।
ऑर्डर करें
POST /orders
आइटम भेजें: एक ही कॉल में उसकी कीमत तय होती है और ऑर्डर हो जाता है, आपकी तय की गई ऊपरी सीमा से कभी ज़्यादा नहीं। उसी कुंजी के साथ दोहराने पर वही ऑर्डर लौटता है।
वेबहुक पाएँ
order.fulfilled
ऑर्डर पूरा होते ही एक साइन किया हुआ इवेंट आपको तुरंत बता देता है। पोलिंग लूप की ज़रूरत नहीं।
कोड दिखाएँ
POST /orders/{id}/fulfillment
कोड और PIN एक अलग, ऑडिट किए गए एंडपॉइंट से पाएँ — कभी कैश नहीं होते, हर बार कोड दिखाने की गिनती होती है।
आपकी भाषा, सीधा HTTPS
एक साफ़ और सुसंगत REST API — JSON भेजें, JSON पाएँ, एक X-Api-Key हेडर, और किसी SDK की ज़रूरत नहीं। खोजें, ऑर्डर करें, कोड दिखाएँ: आपका पहला ऑर्डर बस तीन कॉल में।
const BASE = "https://integration.xegora.com/api/v1";const response = await fetch(`${BASE}/orders`, { method: "POST", headers: { "X-Api-Key": process.env.XEGORA_API_KEY!, "Content-Type": "application/json", "Idempotency-Key": "order-10231", }, body: JSON.stringify({ clientReference: "po-10231", item: { productId, variantId, quantity: 1, currency: "USD" }, maximumTotal: 60.0, // the price your buyer saw }),});const order = await response.json();// 409 price_above_maximum carries quotedTotal — show the new price insteadconsole.log(order.status); // "reserved" — wait for "fulfilled", then reveal- आइडेम्पोटेंट ऑर्डर
- साइन किए गए वेबहुक
- स्कोप वाली API कुंजियाँ
- पहले से फ़ंड किया गया वॉलेट
मुख्य API, शुरू से आखिर तक
असली रिक्वेस्ट और रिस्पॉन्स का स्वरूप — किसी भी पंक्ति पर क्लिक करें। निकासी, जमा इतिहास और प्रोडक्ट इमेज इसे पूरा करते हैं; पूरा रेफ़रेंस docs.xegora.com पर है।
POST /api/v1/orders
अपने प्रीपेड वॉलेट से ऑर्डर करें: आइटम भेजें ताकि एक ही कॉल में उसकी कीमत तय हो और ऑर्डर हो जाए (वैकल्पिक maximumTotal के साथ), या कोई quoteId भेजें। Idempotency-Key हेडर ज़रूरी है — रीट्राई करने पर वही ऑर्डर लौटता है। स्कोप: orders.create।
{
"id": "0198e000-1111-7abc-9def-222233334444",
"clientReference": "po-10231",
"status": "reserved",
"total": 58.50,
"currency": "USD",
"lines": [
{ "productId": "0198d72d-99d6-75a6-9f12-971050ba7a5f", "variantId": "0198d72d-a15b-7cbf-…",
"productName": "Everyday Digital Gift Card", "variantLabel": "50", "quantity": 1,
"unitPrice": 58.50, "currency": "USD", "faceValue": 50, "faceCurrency": "EUR" }
],
"createdAtUtc": "2026-09-05T12:01:02Z",
"updatedAtUtc": "2026-09-05T12:01:02Z"
}वो बोरिंग इंफ्रास्ट्रक्चर, जो आप असल में चाहते हैं
वह सब कुछ जो किसी इश्यूइंग इंटीग्रेशन को असली ट्रैफ़िक में टिकाए रखे — आइडेम्पोटेंसी, सिग्नेचर, स्कोप वाले क्रेडेंशियल, और ऐसा वॉलेट जो ज़रूरत से ज़्यादा खर्च नहीं कर सकता।
एकीकृत कैटलॉग
गिफ्ट कार्ड, eSIM प्लान और मोबाइल रिचार्ज — सबका एक ही स्कीमा, एक ही प्राइस फ़ीड और एक ही ऑर्डर फ़्लो है। एक बार इंटीग्रेट करें, और Xegora जो भी नया प्रोडक्ट जोड़ेगा, वह अपने आप आपके पास होगा।
आइडेम्पोटेंट ऑर्डर
ऑर्डर बनाना और फ़ुलफ़िलमेंट रिवील, दोनों Idempotency-Key हेडर लेते हैं। नेटवर्क में रुकावट, टाइमआउट, ताबड़तोड़ रीट्राई लूप — अनुरोध को जितनी बार चाहें दोहराएँ, ऑर्डर ठीक एक ही बनेगा।
साइन किए गए वेबहुक
order.processing, order.fulfilled, order.failed, order.refunded और wallet.credited, HTTPS पर HMAC-SHA256 सिग्नेचर (X-Xegora-Signature) के साथ डिलीवर होते हैं, कम से कम एक बार डिलीवरी के लिए रीट्राई किए जाते हैं, और स्थिर X-Xegora-Event-Id से उनके डुप्लिकेट हटाए जाते हैं।
न्यूनतम-अधिकार वाली कुंजियाँ
हर कुंजी के साथ स्कोप का एक स्पष्ट सेट होता है — कैटलॉग पढ़ना, कोटेशन, ऑर्डर करना, वॉलेट पढ़ना और पैसे भेजने वाले स्कोप, सब अलग-अलग हैं — साथ में वैकल्पिक CIDR अलाउ-लिस्ट और एक्सपायरी। रद्द करना तुरंत लागू होता है।
पहले से फ़ंड किया गया वॉलेट
ऑर्डर आपके प्रीपेड बैलेंस से राशि रिज़र्व करते हैं और पूरा होने पर उसे कैप्चर करते हैं; विफल होने पर रिज़र्वेशन अपने आप हट जाता है। स्थायी जमा पते पर ऑन-चेन राशि जोड़ें, और बिना इस्तेमाल की राशि सिर्फ़ अपने रजिस्टर्ड भुगतान विवरण पर ही निकालें।
चयन के लिए बना कैटलॉग
श्रेणी, देश या टेक्स्ट से ब्राउज़ करें, तय या कस्टम राशि तक सीमित करें, और जो प्रोडक्ट आप बेचते हैं उन्हें एक ही कॉल में id से रिफ्रेश करें — हर प्रोडक्ट पर रिडेम्प्शन के स्टेप और ब्रांड के दूसरे देश, आपकी बिक्री की मुद्रा में कीमत के साथ।
होलसेल कीमतें, कोई सरप्राइज़ नहीं
कोटेशन ही कीमत है। आपकी व्यावसायिक शर्तों से जुड़ी बाकी सारी बातें आपका मर्चेंट वर्कस्पेस सेट होते समय तय की जाती हैं।
- आपकी बिक्री मुद्रा में होलसेल प्रोडक्ट प्राइसिंग — कोटेशन की कुल राशि ठीक उतनी ही है जितनी आपके वॉलेट से डेबिट होती है
- प्रति कॉल कोई छिपा शुल्क नहीं; हर वर्कस्पेस के लिए 120 अनुरोध/मिनट की एक समान रेट लिमिट
- आपके वर्कस्पेस का प्लान (सेटअप और शर्तें) मर्चेंट ऑनबोर्डिंग के समय तय होता है
- बिना इस्तेमाल की राशि की निकासी का कोटेशन पारदर्शी होता है — शुल्क, शुद्ध राशि और भुगतान की तारीख पहले से
अपना पहला ऑर्डर जारी करने के लिए तैयार हैं?
अपने खाते से मर्चेंट वर्कस्पेस के लिए आवेदन करें, मंज़ूरी पाएँ, और डैशबोर्ड से स्कोप वाली API कुंजियाँ जारी करें — फिर आपका पहला ऑर्डर बस तीन कॉल दूर है। पूरा रेफ़रेंस docs.xegora.com पर आपका इंतज़ार कर रहा है।