रिसेलर्स के लिए गेम टॉप-अप API
संक्षिप्त उत्तर
गेम टॉप-अप API रिसेलर्स को प्लेयर का गेम ID और टॉप-अप अमाउंट सबमिट करके इन-गेम करेंसी (UC, Diamonds, Robux, Crystals) सीधे प्लेयर के गेम अकाउंट में भेजने देता है। गिफ्ट कार्ड API के विपरीत जो कोड डिलीवर करता है, टॉप-अप API रिडीमेबल कोड जेनरेट किए बिना क्रेडिट अकाउंट में भेजता है। इससे इंटीग्रेशन रिक्वायरमेंट बदलती है: प्लेयर ID वैलिडेशन अनिवार्य है, रीजन मैचिंग क्रिटिकल है।
परिभाषा: गेम टॉप-अप API एक B2B इंटरफ़ेस है जो रिसेलर्स को प्लेयर ID सबमिट करके और टॉप-अप पैकेज चुनकर प्लेयर के इन-गेम अकाउंट में वर्चुअल करेंसी फंड करने देता है — बिना रिडीमेबल कोड जेनरेट किए।
मुख्य निष्कर्ष: टॉप-अप API में गिफ्ट कार्ड API की तुलना में कोड फ्रॉड का जोखिम कम होता है क्योंकि कोई रिडीमेबल कोड जेनरेट नहीं होता। लेकिन इनपुट रिक्वायरमेंट सख्त होती है: गलत प्लेयर ID या रीजन मिसमैच का मतलब है क्रेडिट गलत अकाउंट में जाना। प्लेयर ID वैलिडेशन ऑप्शनल नहीं है।
टॉप-अप बनाम गिफ्ट कार्ड: रिसेलर्स के लिए क्या बदलता है
| फ़ैक्टर | गिफ्ट कार्ड API | टॉप-अप API |
|---|---|---|
| क्या डिलीवर होता है | रिडीमेबल कोड | गेम अकाउंट में सीधे क्रेडिट |
| कस्टमर इनपुट | कोई नहीं | प्लेयर ID (+ कुछ गेम के लिए सर्वर ID) |
| रीजन सेंसिटिविटी | कार्ड का रीजन अकाउंट रीजन से मेल खाना चाहिए | प्लेयर का गेम रीजन स्पेसिफाई करना होगा |
| रिफंड रिस्क | कोड का दुरुपयोग हो सकता है | अकाउंट क्रेडिट अपरिवर्तनीय है |
| इंटीग्रेशन जटिलता | कम | ज़्यादा (प्लेयर ID वैलिडेशन) |
API वर्कफ़्लो
1. कस्टमर प्लेयर ID एंटर करता है (जरूरत हो तो सर्वर भी)
2. आपका स्टोर प्लेयर ID वैलिडेशन एंडपॉइंट कॉल करता है
3. API प्लेयर ID की पुष्टि करता है और अकाउंट नाम रिटर्न करता है
4. कस्टमर कन्फर्म करता है और पेमेंट करता है
5. आपका स्टोर वैलिडेटेड ID के साथ ऑर्डर क्रिएशन एंडपॉइंट कॉल करता है
6. API गेम अकाउंट में करेंसी भेजता है
7. API डिलीवरी कन्फर्मेशन रिटर्न करता है
8. आपका स्टोर कस्टमर को कन्फर्मेशन दिखाता है
सर्वर/रीजन सेलेक्शन की जरूरत वाले गेम
सर्वर स्पेसिफिकेशन आवश्यक:
- Mobile Legends: Bang Bang (सर्वर ID चाहिए)
- Genshin Impact (सर्वर चाहिए: Asia, America, Europe, TW/HK/MO)
- Honkai: Star Rail (सर्वर चाहिए)
ग्लोबली यूनिक ID वाले गेम:
- PUBG Mobile (प्लेयर ID ग्लोबली यूनिक है)
- Roblox (यूज़रनेम/यूज़र ID ग्लोबली यूनिक)
- Free Fire (प्लेयर ID ग्लोबली यूनिक)
एरर हैंडलिंग
| एरर परिदृश्य | कारण | कस्टमर को क्या दिखाएं |
|---|---|---|
| इनवैलिड प्लेयर ID | टाइपो या न मिलने वाला अकाउंट | "प्लेयर ID नहीं मिला। ID चेक करें और फिर कोशिश करें।" |
| गलत सर्वर | सही ID, गलत सर्वर | "इस सर्वर पर ID नहीं मिला। अपना सर्वर चेक करें।" |
| अकाउंट रेस्ट्रिक्टेड | गेम अकाउंट बैन या रेस्ट्रिक्टेड | "यह अकाउंट टॉप-अप नहीं ले सकता।" |
| डिलीवरी फेल | गेम सर्वर एरर | रिट्राई करें या सपोर्ट से संपर्क करें |
इंटीग्रेशन चेकलिस्ट
- उन गेम की पहचान करें जो आप ऑफर करेंगे
- कन्फर्म करें कि किन गेम में सर्वर/रीजन सेलेक्शन चाहिए
- प्रत्येक गेम के लिए प्लेयर ID वैलिडेशन एंडपॉइंट इम्प्लीमेंट करें
- जहां जरूरी हो वहां सर्वर सेलेक्टर के साथ प्लेयर ID इनपुट UI बनाएं
- पेमेंट से पहले वैलिडेटेड अकाउंट नाम दिखाएं
- एरर हैंडलिंग के साथ ऑर्डर क्रिएशन इम्प्लीमेंट करें
- डिलीवरी कन्फर्मेशन के लिए वेबहुक सेट अप करें
- अलर्ट के साथ बैलेंस मॉनिटरिंग सेट अप करें
- टर्म्स लिखें: डिलीवरी के बाद टॉप-अप नॉन-रिफंडेबल है
अक्सर पूछे जाने वाले प्रश्न
टॉप-अप API और गिफ्ट कार्ड API में क्या अंतर है? गिफ्ट कार्ड API एक रिडीमेबल कोड डिलीवर करता है। टॉप-अप API गेम अकाउंट में सीधे करेंसी भेजता है। टॉप-अप के लिए प्लेयर ID इनपुट चाहिए; गिफ्ट कार्ड के लिए नहीं।
क्या प्लेयर ID वैलिडेशन हमेशा उपलब्ध होती है? अधिकांश प्रतिष्ठित सप्लायर प्रमुख गेम के लिए वैलिडेशन प्रदान करते हैं। वैलिडेशन की उपलब्धता गेम के API एक्सेस पर निर्भर करती है।
पेमेंट के बाद टॉप-अप फेल हो जाए तो क्या करें? ऑर्डर स्टेटस फेलर कोड दिखाएगा। आपका स्टोर कस्टमर को कन्फर्मेशन न दे; रिट्राई करें या रिफंड दें।
FoxReload से टॉप-अप API एक्सेस पाएं
FoxReload गेम टॉप-अप के लिए REST API प्रदान करता है: PUBG UC, Roblox Robux, Mobile Legends Diamonds, Telegram Stars और अधिक।