ऑनलाइन स्टोर के लिए गिफ्ट कार्ड API: यह कैसे काम करता है

संक्षिप्त उत्तर

गिफ्ट कार्ड API आपके ऑनलाइन स्टोर को सप्लायर के प्रोडक्ट कैटलॉग से कनेक्ट करने, स्टॉक चेक करने, करेंट प्राइसिंग रिट्रीव करने, ऑर्डर क्रिएट करने और डिजिटल कोड ऑटोमैटिकली रिसीव करने देता है — कस्टमर पेमेंट और कोड डिलीवरी के बीच कोई मैनुअल स्टेप नहीं। मूल्यांकन की जाने वाली प्रमुख क्षमताएं: प्रोडक्ट कैटलॉग एक्सेस, रियल-टाइम स्टॉक, प्राइस सिंक, ऑर्डर क्रिएशन, कोड डिलीवरी, ऑर्डर स्टेटस ट्रैकिंग, बैलेंस मॉनिटरिंग और रेकन्सिलिएशन एक्सपोर्ट।

परिभाषा: गिफ्ट कार्ड API एक B2B इंटरफ़ेस है जो ऑनलाइन स्टोर या रिसेलर को डिजिटल गुड्स सप्लायर के कैटलॉग से कनेक्ट करने, कोड फुलफिलमेंट ऑटोमेट करने, ऑर्डर स्टेटस ट्रैक करने और रेकन्सिलिएशन के लिए ट्रांजैक्शन डेटा एक्सपोर्ट करने देता है।

मुख्य निष्कर्ष: ठीक से इंटीग्रेट किया गया गिफ्ट कार्ड API डिजिटल गुड्स रिसेलिंग की चार सबसे बड़ी बाधाएं दूर करता है: मैनुअल स्टॉक मैनेजमेंट, देरी से कोड डिलीवरी, रेकन्सिलिएशन एरर और मिसिंग कोड के लिए कस्टमर सपोर्ट ओवरहेड। इंटीग्रेशन का काम एक बार होता है; ऑपरेशनल फायदा स्थायी है।

यह गाइड किसके लिए है

• ऑनलाइन स्टोर मालिक जो गिफ्ट कार्ड या गेम कोड अपने कैटलॉग में जोड़ना चाहते हैं
• डेवलपर्स जो स्टोर और डिजिटल गुड्स सप्लायर के बीच इंटीग्रेशन बना रहे हैं
• मार्केटप्लेस ऑपरेटर जो API-बेस्ड डिजिटल गुड्स फुलफिलमेंट का मूल्यांकन कर रहे हैं
• Telegram बॉट डेवलपर्स जिन्हें ऑटोमैटेड कोड डिलीवरी चाहिए

गिफ्ट कार्ड API के मुख्य फीचर

ऑर्डर क्रिएशन फ्लो

1. POST /api/orders/
   { "items": [{"itemId": "product_01k...", "quantity": 1}] }
   → { "id": "ord_...", "status": "active" }

2. GET /api/orders/{order_id} poll करें जब तक completed न हो:
   → { "status": "completed",
       "items": [{"externalData": ["XXXXX-YYYYY-ZZZZZ"]}] }

3. आपका स्टोर items[].externalData से कोड पार्स करके कस्टमर को डिलीवर करता है

इंटीग्रेशन मॉडल

इंटीग्रेशन चेकलिस्ट

• कोड लिखने से पहले पूरी API डॉक्युमेंटेशन पढ़ें
• API key Dashboard → API से प्राप्त करें; isMock: true से test orders करें (कोई sandbox नहीं)
• GET /api/categories/ और GET /api/products/ से प्रोडक्ट कैटलॉग सिंक इम्प्लीमेंट करें
• चेकआउट से पहले रियल-टाइम स्टॉक चेक इम्प्लीमेंट करें
• एरर हैंडलिंग के साथ POST /api/orders/ ऑर्डर क्रिएशन इम्प्लीमेंट करें
• पोलिंग लूप इम्प्लीमेंट करें: GET /api/orders/{id} हर 3-5s, max 30 attempts
• सभी terminal statuses हैंडल करें: completed, failed, cancelled
• अलर्ट के साथ बैलेंस मॉनिटरिंग सेट अप करें (BalanceNotEnough पर ops को notify)
• फाइनेंस के लिए GET /api/orders/ से रेकन्सिलिएशन एक्सपोर्ट इम्प्लीमेंट करें

अक्सर पूछे जाने वाले प्रश्न

क्या गिफ्ट कार्ड API तुरंत कोड डिलीवर कर सकता है? हाँ। ऑन-डिमांड स्टॉक के लिए, API ऑर्डर क्रिएशन आमतौर पर सेकंड के भीतर कोड रिटर्न करती है।

न्यूनतम आवश्यक API फीचर क्या हैं? न्यूनतम: कैटलॉग (GET /api/categories/, GET /api/products/), ऑर्डर क्रिएशन (POST /api/orders/) और ऑर्डर स्टेटस पोलिंग (GET /api/orders/{id})। प्रोडक्शन में बैलेंस monitoring और GET /api/orders/ से reconciliation भी जोड़ें।

क्या गिफ्ट कार्ड API Telegram बॉट के लिए काम करता है? हाँ। API कॉल HTTP रिक्वेस्ट हैं — ये वेब स्टोर, Telegram बॉट बैकएंड या मार्केटप्लेस इंटीग्रेशन — किसी के लिए भी समान रूप से काम करती हैं।

गिफ्ट कार्ड API और टॉप-अप API में क्या अंतर है? गिफ्ट कार्ड API एक कोड डिलीवर करता है जिसे कस्टमर प्लेटफ़ॉर्म पर रिडीम करता है। टॉप-अप API क्रेडिट सीधे कस्टमर के गेम अकाउंट में भेजता है — कोई कोड जेनरेट नहीं होता।

FoxReload API कनेक्ट करें

FoxReload ऑर्डर क्रिएशन, ऑर्डर स्टेटस पोलिंग और रेकन्सिलिएशन के साथ गिफ्ट कार्ड, गेम टॉप-अप और डिजिटल गुड्स के होलसेल कैटलॉग तक REST API एक्सेस प्रदान करता है।

FoxReload से API एक्सेस पाएं | API डॉक्युमेंटेशन देखें | प्रोडक्ट कैटलॉग देखें