eSIM API चेकलिस्ट (2026): 12 फीचर्स जो एक Travel eSIM API में होने चाहिए — और प्रत्येक का परीक्षण कैसे करें

त्वरित उत्तर

एक प्रोडक्शन-रेडी ट्रैवल eSIM API में सुरक्षित token authentication, idempotency keys (ताकि रिट्राय करने पर दोबारा चार्ज न हो), कीमत को लॉक करने वाले price quotes, हर eSIM इवेंट के लिए signed webhooks, एक sandbox जो पूरे eSIM जीवन चक्र और त्रुटियों (errors) का अनुकरण कर सके, top-ups, usage data, suspend/resume, और कवरेज एवं fair-use विवरणों के साथ एक catalog feed होनी चाहिए। लाइव होने से पहले sandbox में इनमें से हर एक का परीक्षण करें।

अपने ऐप, ट्रैवल प्लेटफॉर्म या बुकिंग इंजन से eSIM API को कनेक्ट करना कठिन नहीं है। कठिन यह है कि लॉन्च के बाद पता चले कि API टाइमआउट होने पर दोबारा चार्ज कर रहा है, यह नहीं बता पा रहा है कि ग्राहक का डेटा कब खत्म हो गया, या आपको विफलताओं (failures) का परीक्षण करने का कोई तरीका नहीं दे रहा है।

यह चेकलिस्ट प्रोडक्शन में काम आने वाले 12 फीचर्स को कवर करती है, और प्रत्येक के लिए, साइन अप करने से पहले इसे कैसे टेस्ट करें। हम उदाहरण के रूप में TripoSIM Partner API का उपयोग कर रहे हैं, लेकिन आप किसी भी प्रोवाइडर की तुलना करने के लिए इसी चेकलिस्ट का उपयोग कर सकते हैं।

1. Secure token authentication

क्या देखें: OAuth 2.0 client credentials: आप एक client ID और secret के बदले थोड़े समय के लिए वैध access token प्राप्त करते हैं। Secrets कभी भी हर रिक्वेस्ट के साथ नहीं भेजे जाते।

कैसे टेस्ट करें: एक token के लिए रिक्वेस्ट करें, फिर चेक करें कि क्या यह एक्सपायर होता है। TripoSIM API में, POST /auth/token 15 minutes के लिए वैध access token लौटाता है। सुनिश्चित करें कि आपका कोड इसके एक्सपायर होने से पहले इसे स्वचालित रूप से रिफ्रेश कर दे।

2. Idempotency keys (कोई डबल चार्ज नहीं)

क्या देखें: हर ऑर्डर और top-up पर एक Idempotency-Key header। यदि आपकी रिक्वेस्ट टाइमआउट हो जाती है और आप उसी key के साथ दोबारा कोशिश करते हैं, तो API को दूसरा पेड eSIM बनाने के बजाय मूल परिणाम लौटाना चाहिए।

कैसे टेस्ट करें: उसी key के साथ एक ही ऑर्डर दो बार भेजें और पुष्टि करें कि आपको एक ही ऑर्डर मिलता है। फिर अलग body के साथ वही key भेजें — एक अच्छा API इसे रिजेक्ट कर देगा। TripoSIM प्रोडक्शन ऑर्डर्स और top-ups पर key की आवश्यकता रखता है और यदि किसी अलग रिक्वेस्ट के साथ key का पुन: उपयोग किया जाता है, तो यह 409 IDEMPOTENCY_KEY_REUSED लौटाता है।

3. Price quotes जो कीमत को लॉक कर दें

क्या देखें: कीमत प्राप्त करने और उसे कुछ समय के लिए बनाए रखने का तरीका, ताकि आपका ग्राहक ठीक वही भुगतान करे जो आपने उन्हें दिखाया था।

कैसे टेस्ट करें: एक quote बनाएं, प्रतीक्षा करें, फिर उसके साथ ऑर्डर करें। TripoSIM quotes 10 minutes के लिए वैध होते हैं; एक एक्सपायर्ड quote 409 QUOTE_EXPIRED लौटाता है ताकि आप अचानक बढ़ी हुई कीमत चार्ज करने के बजाय नया quote ले सकें।

4. एक साफ-सुथरा catalog feed

क्या देखें: एक ऐसा endpoint जो कीमत, डेटा, वैधता, कवरेज देश, 5G, top-up सपोर्ट के साथ हर प्लान को सूचीबद्ध करता है — और अनलिमिटेड प्लान्स के लिए, दैनिक फुल-स्पीड सीमा (daily full-speed limit)।

कैसे टेस्ट करें: किसी एक देश के लिए कैटलॉग निकालें और उसकी तुलना प्रोवाइडर की अपनी वेबसाइट से करें। TripoSIM /catalog endpoint JSON या CSV लौटाता है, जिसमें देश को कवर करने वाले क्षेत्रीय प्लान शामिल होते हैं, और अनलिमिटेड प्लान्स के लिए fair-use फ़ील्ड (fup_daily_mb, fup_throttle_kbps) भी जोड़ता है। देखें [अनलिमिटेड डेली लिमिट कैसे काम करती है](/blog/unlimited-esim-daily-limit-by-country-2026)।

5. इंस्टेंट ऑर्डर और QR डिलीवरी

क्या देखें: ऑर्डर रिस्पॉन्स (या कुछ सेकंड बाद मिलने वाला webhook) में मानक LPA फॉर्मेट में एक्टिवेशन कोड शामिल होना चाहिए, उदाहरण के लिए LPA:1$smdp.example.com$ACTIVATION_CODE, ताकि आप QR कोड या वन-टैप इंस्टॉल लिंक दिखा सकें।

कैसे टेस्ट करें: एक sandbox ऑर्डर दें, LPA स्ट्रिंग से QR जेनरेट करें, और यह जांचने के लिए फोन कैमरे से स्कैन करें कि फॉर्मेट वैध है या नहीं।

6. हर इवेंट के लिए Signed webhooks

क्या देखें: पूरे eSIM जीवन चक्र के लिए पुश नोटिफिकेशन, जो signed हों ताकि हमलावर उन्हें फर्जी न बना सकें।

TripoSIM आठ प्रकार के इवेंट भेजता है: order.completed, order.failed, esim.activated, esim.usage_80, esim.suspended, esim.resumed, esim.depleted और esim.expired। प्रत्येक रिक्वेस्ट में एक X-TripoSIM-Signature header होता है — जो आपके signing secret का उपयोग करके टाइमस्टैम्प और रॉ बॉडी का HMAC-SHA256 है:

<pre><code>// reject requests older than 5 minutes (replay protection) if (Math.floor(Date.now() / 1000) - parseInt(timestamp) > 300) throw new Error('Webhook too old'); const expected = crypto .createHmac('sha256', signingSecret) .update(timestamp + '.' + rawBody) .digest('hex'); if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) { throw new Error('Invalid webhook signature'); }</code></pre>

कैसे टेस्ट करें: एक webhook रजिस्टर करें, एक ऑर्डर ट्रिगर करें, और अपने कोड में सिग्नेचर को सत्यापित करें। फिर बॉडी के एक बाइट को बदलें और सुनिश्चित करें कि आपका चेक उसे रिजेक्ट कर देता है।

7. एक sandbox जो पूरे eSIM जीवन का अनुकरण (simulate) करे

क्या देखें: वास्तविक eSIM को एक्टिवेट होने और डेटा उपयोग करने में कई दिन लगते हैं। एक अच्छा sandbox आपको इसे तेजी से करने की अनुमति देता है।

Ready to get connected?

Get a travel eSIM for 200+ destinations — instant QR by email, no roaming charges, with a discount applied automatically at checkout.

Browse eSIM plans

कैसे टेस्ट करें: TripoSIM sandbox में, activate, usage, deplete, expire या reset एक्शन के साथ POST /sandbox/esims/{iccid}/simulate का उपयोग करें। प्रत्येक स्टेप संबंधित webhook को ट्रिगर करता है, जिससे आप अपने "आपका डेटा लगभग खत्म हो गया है" वाले ईमेल का परीक्षण दिनों के बजाय मिनटों में कर सकते हैं।

8. Failure simulation

क्या देखें: जानबूझकर त्रुटियों (errors) को फोर्स करने का एक तरीका, ताकि आपको पता चले कि आपका ऐप उन्हें संभाल सकता है।

कैसे टेस्ट करें: insufficient_balance, price_changed, rate_limit, provider_unavailable या timeout जैसे मोड के साथ X-Sandbox-Simulate header भेजें, और जांचें कि क्या आपका ऐप एक स्पष्ट संदेश दिखाता है और केवल तभी रिट्राय करता है जब उसे करना चाहिए।

9. उसी eSIM पर Top-ups

क्या देखें: जिन ग्राहकों का डेटा खत्म हो जाता है, वे नया eSIM इंस्टॉल किए बिना और अधिक डेटा जोड़ने में सक्षम होने चाहिए।

कैसे टेस्ट करें: sandbox में (idempotency key के साथ) POST /esims/{iccid}/topup को कॉल करें, फिर नया डेटा बैलेंस चेक करें। यह भी जांचें कि कौन से प्लान top-ups का समर्थन करते हैं — कैटलॉग आपको यह बता देना चाहिए।

10. Usage और status डेटा

क्या देखें: उपयोग किए गए डेटा, बचे हुए डेटा और समाप्ति (expiry) के लिए एक endpoint, ताकि आपकी सपोर्ट टीम और ऐप यह जवाब दे सकें कि "मेरे पास कितना डेटा बचा है?"

कैसे टेस्ट करें: एक सिम्युलेटेड usage इवेंट के बाद GET /esims/{iccid}/usage को कॉल करें। TripoSIM 5 मिनट के लिए usage को कैश करता है, इसलिए रियल-टाइम अलर्ट के लिए webhooks (esim.usage_80, esim.depleted) का उपयोग करें।

11. Suspend और resume

क्या देखें: एक eSIM को रोकने का तरीका — उदाहरण के लिए जब किसी भुगतान पर विवाद हो या ग्राहक फोन खो जाने की रिपोर्ट करे — और उसे बाद में फिर से शुरू (resume) करना।

कैसे टेस्ट करें: एक sandbox eSIM को suspend करें, पुष्टि करें कि esim.suspended webhook प्राप्त हुआ है, फिर उसे resume करें और esim.resumed की पुष्टि करें।

12. स्पष्ट rate limits, error codes और एक changelog

क्या देखें: दस्तावेजीकृत सीमाएं (limits), ऐसे error codes जो आपको बताते हैं कि क्या रिट्राय करना है, और एक सार्वजनिक changelog ताकि अपडेट्स आपको कभी हैरान न करें।

कैसे टेस्ट करें: एरर लिस्ट पढ़ें और अपने कोड में प्रत्येक कोड को "retry" या "do not retry" के साथ मैप करें। TripoSIM प्रति पार्टनर अकाउंट प्रति मिनट 120 रिक्वेस्ट की अनुमति देता है (आप व्यक्तिगत API keys पर कम सीमाएं सेट कर सकते हैं), 429 रिस्पॉन्स पर Retry-After header लौटाता है, प्रत्येक error code को retryable या नहीं के रूप में चिह्नित करता है, और एक changelog endpoint प्रकाशित करता है।

एक सरल लॉन्च प्लान

दिन 1: sandbox keys प्राप्त करें, authenticate करें, कैटलॉग निकालें।
दिन 2: idempotency keys के साथ sandbox ऑर्डर दें और QR कोड दिखाएं।
दिन 3: webhooks जोड़ें, लाइफसाइकिल और फेलियर सिम्युलेटर चलाएं।
दिन 4: top-ups और usage जोड़ें, फिर एक लाइव eSIM के साथ वास्तविक फोन पर टेस्ट करें।
दिन 5: लाइव जाएं।

अधिकांश टीमें एक सप्ताह से कम समय में कनेक्ट कर लेती हैं। पूरी [API documentation](https://docs.triposim.com) पढ़ें या हमारा स्टेप-बाय-स्टेप [eSIM API integration guide](/blog/esim-reseller-api-how-to-integrate-travel-esim-sales-into-your-platform) देखें।

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

एक ट्रैवल eSIM API में क्या शामिल होना चाहिए?

न्यूनतम: token authentication, idempotency keys, price quotes, एक catalog feed, इंस्टेंट QR/activation codes, signed webhooks, लाइफसाइकिल और फेलियर सिम्युलेटर के साथ एक sandbox, top-ups, usage data, suspend/resume, और दस्तावेजीकृत rate limits और error codes।

eSIM API के लिए idempotency keys क्यों महत्वपूर्ण हैं?

हर eSIM ऑर्डर की वास्तविक कीमत लगती है। यदि कोई रिक्वेस्ट टाइमआउट हो जाती है और आपका सिस्टम दोबारा कोशिश (retry) करता है, तो एक idempotency key यह सुनिश्चित करती है कि रिट्राय करने पर दूसरा eSIM खरीदने के बजाय पहला परिणाम ही मिले।

मैं eSIM बिना खरीदे eSIM API का परीक्षण कैसे करूँ?

sandbox का उपयोग करें। एक अच्छा sandbox बिना आपके वॉलेट से पैसे लिए ऑर्डर्स, एक्टिवेशन, डेटा उपयोग, समाप्ति और एक्सपायरी का अनुकरण करता है — और आपको त्रुटियों (errors) को फोर्स करने की अनुमति देता है।

eSIM API इंटीग्रेशन में कितना समय लगता है?

एक अच्छी तरह से दस्तावेजीकृत API और पूर्ण sandbox के साथ, अधिकांश टीमें 3–5 कार्य दिवसों में लाइव हो जाती हैं।

क्या TripoSIM API white-label डिलीवरी का समर्थन करता है?

हाँ। आपको एक्टिवेशन कोड और QR डेटा प्राप्त होता है, इसलिए आप अपने स्वयं के ऐप या ईमेल के भीतर अपने ब्रांड के तहत eSIM डिलीवर कर सकते हैं। [API program](/api-program) देखें।

निष्कर्ष

कीमत मायने रखती है, लेकिन एक eSIM API के लिए वास्तविक अंतर लॉन्च के बाद दिखाई देता है: रिट्राय जो कभी दोबारा चार्ज नहीं करते, webhooks जिन पर आप भरोसा कर सकते हैं, और एक sandbox जो आपको पहले सब कुछ टेस्ट करने की अनुमति देता है। किसी भी प्रोवाइडर के साथ प्रतिबद्ध होने से पहले इस चेकलिस्ट को चलाएं — और यह देखने के लिए कि TripoSIM Partner API कैसा स्कोर करता है, हमारे [sandbox के साथ शुरुआत करें](/api-program)।