आवर्ती eSIM पैकेज प्रबंधित करें
बिलिंग शेड्यूल के अनुसार डेटा पैकेज खरीदने के लिए आवर्ती सब्सक्रिप्शन का उपयोग करें। इसके लिए आपको eSIM सेवा खरीदने की अनुमति, संगठन के वॉलेट में धनराशि, और eSIM का उपयोग करने वाले व्यक्ति के लिए एक सब्सक्राइबर चाहिए। उपलब्धता चुने गए ऑफ़र और प्रोफ़ाइल पर निर्भर करती है।
यह गाइड नई खरीद और मौजूदा eSIM पर नामांकन को कवर करती है। eSIM API में किसी सक्रिय सब्सक्रिप्शन को दूसरे प्लान पर बदलने का कोई ऑपरेशन नहीं है।
1. आवर्ती शर्तों की समीक्षा करें
नए eSIM के लिए चेकआउट विकल्प प्राप्त करें। जब recurrence.available true हो, तब स्वचालित नवीनीकरण का विकल्प दें और स्वीकृत शर्तों के लिए उसके quote का उपयोग करें। यदि यह उपलब्ध नहीं है, तो unavailable_reason देखें और कोई समर्थित खरीद विकल्प दें।
मौजूदा eSIM के लिए recurring_only=true के साथ संगत ऑफ़र की सूची प्राप्त करें, फिर चुने गए ऑफ़र की आवर्ती शर्तें प्राप्त करें। खरीद स्वीकार करने से पहले नामांकन संगतता की दोबारा जाँच करता है।
स्वीकृति से पहले आवर्ती मूल्य, प्रकाशित मुद्रा, अवधि-चक्र और डिलीवरी मोड दिखाएँ। कोट किया गया मूल्य कर से पहले का होता है; अवधि इतिहास में वसूली गई कुल राशि और कर दर्ज होते हैं। calendar_month कैलेंडर महीनों के अनुसार चलता है; fixed_days बताए गए 24-घंटे वाले दिनों की संख्या का उपयोग करता है। सेवा का भुगतान संगठन का वॉलेट करता है; सब्सक्राइबर का कोई अलग वॉलेट नहीं होता।
जाँचें कि पैकेज पूरी भुगतान की गई अवधि को कवर करता है (exact_period) या हर नवीनीकरण एक मानक पैकेज खरीदता है (recurring_top_up)। आवर्ती टॉप-अप में सक्रियण और समाप्ति पैकेज की शर्तों के अनुसार होती है और बिलिंग की सीमाओं से अलग हो सकती है। केवल नवीनीकरण शेड्यूल होने के आधार पर ग्राहक से बिना रुकावट डेटा का वादा न करें।
2. सब्सक्राइबर असाइन करें
डैशबोर्ड में eSIMs से प्रोफ़ाइल खोलें, More eSIM actions खोलें, Assign person चुनें, संपर्क चुनें और Assign person से पुष्टि करें। असाइन किए गए व्यक्ति को आप बाद में नहीं बदल सकते।
API के साथ, अपने वर्कस्पेस के किसी संपर्क के contact_id का उपयोग करके सब्सक्राइबर बनाएँ। इसके लिए Contacts पर email_marketing:read और esim:write आवश्यक हैं। यदि संपर्क का पहले से कोई सब्सक्राइबर है, तो प्रतिक्रिया वही मौजूदा सब्सक्राइबर लौटाती है।
संबंध बनाने के बाद संपर्क को हटाया नहीं जा सकता, eSIM समाप्त होने के बाद भी नहीं। सब्सक्राइबर संबंधों को हटाया, अलग या गुमनाम नहीं किया जा सकता। संबंध बनाने से पहले तय करें कि यह प्रतिधारण आपकी ग्राहक प्रक्रिया के अनुकूल है या नहीं।
मौजूदा प्रोफ़ाइल के लिए, subscriber_id का उपयोग करके eSIM असाइन करें। वही असाइनमेंट दोहराने पर मौजूदा रिकॉर्ड लौटता है, जबकि किसी दूसरे व्यक्ति को असाइन करने पर 409 लौटता है। नई प्रोफ़ाइल के लिए, खरीद में subscriber_id शामिल करें, ताकि डिलीवरी के साथ असाइनमेंट पूरा हो जाए।
असाइनमेंट से वर्कस्पेस की पहुँच या इंस्टॉलेशन क्रेडेंशियल पढ़ने की अनुमति नहीं मिलती। पहचान संबंधी जानकारी ऑफ़र की आवश्यकताओं और इंटीग्रेशन गाइड के अनुसार अलग से एकत्र करें।
3. नामांकन करें और डिलीवरी सत्यापित करें
डैशबोर्ड में किसी मौजूदा असाइन किए गए eSIM के लिए, Automatic renewal खोलें और Set up renewal चुनें। कोई Package चुनें, Check recurring price चुनें, और कीमत, अवधि-चक्र तथा पैकेज डिलीवरी की शर्तें देखें। पहली अवधि खरीदने और नवीनीकरण चालू करने के लिए Buy first package and renew चुनें।
API के ज़रिए नए eSIM के लिए, चुने गए offer_id, वर्कस्पेस subscriber_id और इन स्वीकृत चेकआउट शर्तों के साथ ऑर्डर बनाएँ:
offer_revisionकोrecurrence.quote.offer_revisionपर सेट करें।recurrence.recurrence_revisionकोrecurrence.quote.recurrence_revisionपर सेट करें।recurrence.accepted_priceको पूरेrecurrence.quote.priceऑब्जेक्ट पर सेट करें।
Idempotency-Key भेजें; इस खरीद के लिए esim_id और expected_price शामिल न करें। ऑर्डर ID और उसका recurring_subscription_id सहेजें। भुगतान की राशि उपलब्ध होने पर पहली बिलिंग अवधि शुरू होती है। ऑर्डर के पूरा या विफल होने तक उसकी स्थिति देखते रहें, और ज़रूरत हो तो खरीद पुनर्प्राप्ति के चरणों का उपयोग करें।
किसी मौजूदा असाइन किए गए eSIM के लिए, esim_id, offer_id, ऑफ़र के revision को offer_revision के रूप में, और आवर्ती शर्तों के revision को recurrence_revision के रूप में देकर आवर्ती सब्सक्रिप्शन बनाएँ। आवर्ती शर्तों का पूरा price accepted_price के रूप में भेजें। Idempotency-Key आवश्यक है; नामांकन पुनर्प्राप्त करने के लिए उसे उसी अनुरोध के साथ दोबारा उपयोग करें। नामांकन पहली अवधि तुरंत खरीदता है; यह किसी मौजूदा पैकेज के खत्म होने का इंतज़ार नहीं करता।
सब्सक्रिप्शन प्राप्त करें और उसकी अवधियों की सूची देखें। भुगतान और पैकेज डिलीवरी की पुष्टि अलग-अलग करें। नए eSIM के लिए, उसका ऑर्डर पूरा होने के बाद इंस्टॉलेशन विवरण भेजें।
4. नवीनीकरण पर नज़र रखें
स्वीकृत शर्तें, स्थिति और अगला नवीनीकरण देखने के लिए Subscriptions खोलें। API में next_renewal_at, stop_reason और अवधि इतिहास पढ़ें। प्रकाशित मूल्य बदलने पर नई स्वीकृति ज़रूरी होती है। जिस नवीनीकरण के लिए धनराशि उपलब्ध नहीं होती, वह आगे की खरीद रोक देता है।
यदि status का मान needs_attention है, तो नवीनतम अवधि और उससे जुड़ा ऑर्डर देखें। अनसुलझी डिलीवरी का भुगतान फिर भी देय रह सकता है, और वह प्रतिस्थापन नामांकन को रोकती है। प्रतिस्थापन खरीदने से पहले इन संदर्भों के साथ सपोर्ट से संपर्क करें।
5. आगे का नवीनीकरण रोकें
eSIM के Automatic renewal सेक्शन में Cancel renewal चुनें। वर्तमान भुगतान की गई अवधि की समाप्ति देखें, फिर डायलॉग में Cancel renewal की पुष्टि करें। अपडेट किए गए सब्सक्रिप्शन में उसकी रद्दीकरण तिथि जाँचें।
API से सब्सक्रिप्शन रद्द करें, फिर उसे दोबारा पढ़ें। नवीनीकरण कब समाप्त होगा, इसकी पुष्टि के लिए cancel_at_period_end, cancellation_effective_at और next_renewal_at जाँचें। जो अवधि पहले से प्रतिबद्ध है, उसका भुगतान देय रहता है। डिलीवर किए गए पैकेज अपनी वैधता बनाए रखते हैं, और इंस्टॉल की गई प्रोफ़ाइल सुरक्षित रहती है।
फ़ोन से प्रोफ़ाइल हटाने से नवीनीकरण रद्द नहीं होता। eSIM को रिलीज़ करने से वह स्थायी रूप से बंद हो जाता है, बचा हुआ डेटा समाप्त हो जाता है और कोई रिफ़ंड नहीं मिलता। यदि आप नवीनीकरण के साथ कनेक्टिविटी भी बदलना चाहते हैं, तो सेवा कार्रवाइयों का उपयोग करें।
समस्या निवारण
वॉलेट में धनराशि जोड़ने से रुका हुआ सब्सक्रिप्शन अपने-आप फिर से शुरू नहीं होता। नया नामांकन स्वीकार करने से पहले stop_reason और पिछली सेवा की अंतिम स्थिति जाँचें। भुगतान की गई डिलीवरी के विफल होने और उसके क्रेडिट के परिणाम अलग-अलग होते हैं: अवधि इतिहास में order_status और refund_transaction_id देखें।
ग्राहक के अनुभव की जाँच करें
पुष्टि करें कि ग्राहक खरीदा गया डेटा, पैकेज की समाप्ति, अगला नवीनीकरण, रद्दीकरण तिथि और सपोर्ट संपर्क ढूँढ सकता है। पहले पैकेज की डिलीवरी जाँचें और किसी संगत डिवाइस पर मोबाइल डेटा का परीक्षण करें। किसी बाद की अवधि के भुगतान और डिलीवरी को उसकी निर्धारित नवीनीकरण तिथि से अलग जाँचें।
अगले कदम
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।