उपयोग देखें और टॉप-अप जोड़ें
किसी मौजूदा eSIM में डेटा जोड़ने के लिए इस गाइड का उपयोग करें। इसके लिए आपको eSIM पढ़ने और पैकेज खरीदने की अनुमति चाहिए, साथ ही वॉलेट में पर्याप्त राशि होनी चाहिए। टॉप-अप उपलब्ध है या नहीं, यह प्रोफ़ाइल, मौजूदा पैकेजों और चुने गए ऑफ़र पर निर्भर करता है।
1. सक्रिय पैकेज देखें
eSIMs से प्रोफ़ाइल खोलें और Data packages देखें। API के साथ eSIM के पैकेजों की सूची बनाएँ और उनकी स्थिति, समाप्ति और बैलेंस देखें।
balance.total_bytes खरीदा गया डेटा है। अगर used_bytes, remaining_bytes या used_percent null है, तो इसका मतलब है कि कोई माप उपलब्ध नहीं है। अपने ऐप्लिकेशन में इन मानों को अज्ञात ही रखें।
क्या दिखाना है, यह तय करने के लिए eSIM का balance_reporting फ़ील्ड पढ़ें। अगर यह unavailable है, तो खरीदा गया डेटा दिखाएँ, लेकिन उसे मापा गया शेष डेटा न बताएँ। अगर यह available है, तब भी रिपोर्ट आने तक खपत अज्ञात हो सकती है। दैनिक उपयोग का इतिहास अलग है और उपलब्ध नहीं है।
बैलेंस के आखिरी अपडेट का समय जानने के लिए balance.as_of का उपयोग करें; खपत रिपोर्ट होने से पहले यह पैकेज की डिलीवरी का समय हो सकता है। अगर balance.observed_at दिया गया है, तो वह नेटवर्क द्वारा माप किए जाने का समय है। मापे गए उपयोग के साथ टाइमस्टैम्प दिखाएँ, ताकि ग्राहक देर से आई रिपोर्ट पहचान सके।
2. संगत ऑफ़र की सूची बनाएँ
eSIM पर Top up चुनें, या उस प्रोफ़ाइल के लिए संगत ऑफ़र की सूची बनाएँ को कॉल करें। सामान्य कैटलॉग से चुनने के बजाय लौटाए गए ऑफ़र का उपयोग करें। किसी ऑफ़र का उसी देश में कवरेज होने से यह तय नहीं होता कि वह संगत है।
अगर टॉप-अप उपलब्ध नहीं है, तो कारण जानने के लिए eSIM पर available_actions पढ़ें। कोई अधूरा ऑर्डर या पैकेज सीमा एक और खरीद को रोक सकती है। फिर से प्रयास करने से पहले मौजूदा ऑर्डर का समाधान करें। सबमिट करने से पहले संगत ऑफ़र रीफ़्रेश करें, क्योंकि चुनने और खरीदने के बीच कोई ऑफ़र अनुपलब्ध हो सकता है।
expired स्थिति वाला eSIM निष्क्रिय होता है और संगत टॉप-अप पूरा होने के बाद active में लौट सकता है। यह तय करने से पहले कि इंस्टॉल की गई प्रोफ़ाइल को बदलना होगा, उपलब्ध कार्रवाई और संगत ऑफ़र जाँचें।
3. प्रभावी शर्तों की समीक्षा करें
चुने गए ऑफ़र का डेटा भत्ता, कवरेज, प्रकाशित मूल्य और मुद्रा, और वैधता दिखाएँ। यदि eSIM में active_until सेवा सीमा मौजूद है, तो नए पैकेज की वैधता की तुलना उससे करें। यदि वह सीमा खरीदी गई वैधता को छोटा कर देगी, तो ऑर्डर प्रभावी वैधता के साथ 409 लौटाता है। acknowledge_shortened_validity: true सेट करने से पहले छोटी अवधि दिखाएँ और स्वीकृति लें।
टॉप-अप एक और पैकेज बनाता है। यह मौजूदा पैकेज का बैलेंस नहीं बदलता और न ही उस पैकेज की समाप्ति तिथि बढ़ाता है। डिलीवरी के बाद नए पैकेज का सक्रियण और समाप्ति जाँचें।
4. ऑर्डर स्वीकृत करें और उसकी स्थिति पर नज़र रखें
डैशबोर्ड में खरीद की पुष्टि करें। API से ऑर्डर बनाएँ, जिसमें मौजूदा esim_id, चुना गया offer_id, ऑफ़र का revision offer_revision के रूप में, और उसका pricing.price expected_price के रूप में उपयोग करें। subscriber_id छोड़ दें, क्योंकि टॉप-अप मौजूदा असाइनमेंट बनाए रखता है। ऑर्डर ID और फिर से प्रयास के लिए एक Idempotency-Key सहेजें।
यदि स्वीकार किया गया मूल्य या संशोधन बदल गया है, तो दूसरी खरीद सबमिट करने से पहले मौजूदा ऑफ़र प्राप्त करें और नई शर्तों की पुष्टि करें। लौटाई गई मूल्य राशि और मुद्रा को बिना रूपांतरण या राउंडिंग के कॉपी करें।
Orders में ऑर्डर पर नज़र रखें, या API के ज़रिए ऑर्डर प्राप्त करें। 201 और 202 दोनों प्रतिक्रियाओं के बाद status जाँचें। यदि प्रतिक्रिया खो जाए, तो उसी कुंजी के साथ वही अनुरोध फिर से प्रयास करें। परिणाम अनिश्चित रहते हुए कोई प्रतिस्थापन खरीद न बनाएँ।
5. परिणामी पैकेज जाँचें
जब ऑर्डर completed हो, तो उसके package_id से नया पैकेज प्राप्त करें। पुष्टि करें कि लक्षित eSIM, कवरेज और डेटा भत्ता खरीद से मेल खाते हैं। टॉप-अप इंस्टॉल की गई प्रोफ़ाइल का उपयोग करता है, इसलिए आपको नया eSIM इंस्टॉल करने की ज़रूरत नहीं है। पहले उपयोग की प्रतीक्षा कर रहे पैकेज में अभी सक्रियण या समाप्ति टाइमस्टैम्प नहीं हो सकता।
समस्या निवारण
यदि ऑर्डर पूरा हो गया है लेकिन बैलेंस अब भी अज्ञात है, तो पैकेज की स्थिति और रिपोर्ट टाइमस्टैम्प की तुलना करें। रिपोर्टिंग डिवाइस के उपयोग से पीछे रह सकती है, और दोबारा ऑर्डर करने से यह देरी दूर नहीं होती। यदि कोई खरीद विफल हो जाए, तो फिर से प्रयास करने से पहले उसकी विफलता का विवरण और कोई भी क्रेडिट संदर्भ जाँचें।
अगले चरण
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।