अपने ऐप में eSIM कनेक्टिविटी जोड़ें
इस गाइड की मदद से आप eSIM की खरीद को अपने ऐप के किसी खाते से जोड़ सकते हैं। इसके लिए आपको एक Bird वर्कस्पेस, सर्वर-साइड API इंटीग्रेशन और अपने ग्राहकों को प्रमाणित करने का तरीका चाहिए। अनुमतियों और अनुरोध के विवरण के लिए API गाइड देखें।
1. वे ऑफ़र दिखाएँ जिनका आपका ग्राहक उपयोग कर सकता है
ग्राहक के गंतव्य के लिए ऑफ़र की सूची पाएँ और चुने गए ऑफ़र का कवरेज, डेटा सीमा, वैधता और प्रकाशित मूल्य दिखाएँ। खरीद से पहले डिवाइस संगतता और पहचान संबंधी आवश्यकताएँ जाँचें।
स्वचालित नवीनीकरण के लिए, ऑफ़र के चेकआउट विकल्पों से उपलब्ध खरीद मोड और स्वीकृत शर्तें दिखाएँ। ग्राहक के चयन के साथ ऑफ़र का संशोधन और बताया गया मूल्य सहेजें। अगर कोटेशन बदल जाए, तो नई शर्तें दिखाएँ और खरीदने से पहले ग्राहक से उन्हें स्वीकार करवाएँ।
2. खरीद को अपने ग्राहक से जोड़ें
Bird API कुंजियाँ अपने सर्वर पर ही रखें। हर ऑर्डर और eSIM तक पहुँच की अनुमति अपने ऐप के ग्राहक खाते के आधार पर दें, क्योंकि वर्कस्पेस की API कुंजी कई ग्राहकों के संसाधनों तक पहुँच सकती है।
अपनी ग्राहक ID को ऑर्डर ID के साथ सहेजें, और डिलीवरी होने के बाद eSIM और पैकेज ID भी सहेजें। अगर आपको किसी नामित सेवा उपयोगकर्ता या स्वचालित नवीनीकरण की ज़रूरत है, तो वर्कस्पेस संपर्क से सब्सक्राइबर बनाएँ। असाइनमेंट केवल यह दर्ज करता है कि eSIM कौन इस्तेमाल करता है। इससे वह व्यक्ति आपके ऐप में साइन इन नहीं होता और उसे क्रेडेंशियल तक पहुँच नहीं मिलती।
Bird खरीद का भुगतान आपके संगठन के वॉलेट से होता है। अगर आप अपने ग्राहक से अलग से शुल्क लेते हैं, तो उस भुगतान को eSIM ऑर्डर से अलग ट्रैक करें, ताकि भुगतान या डिलीवरी विफल होने पर आप समस्या हल कर सकें।
3. ऐसी खरीद बनाएँ जिसे दोबारा पाया जा सके
ऑर्डर बनाने से पहले एक Idempotency-Key बनाएँ और उसे सहेजें। अगर प्रतिक्रिया बीच में रुक जाए, तो उसी अनुरोध के साथ वही कुंजी दोबारा इस्तेमाल करें।
जब तक ऑर्डर अंतिम परिणाम तक न पहुँचे, तब तक प्रोसेसिंग की स्थिति दिखाएँ। ग्राहक को इंस्टॉलेशन पर भेजने से पहले ऑर्डर सहेजें, और उन्हें अपने खाते से उस पर लौटने दें। बिना भुगतान वाले या विफल ऑर्डर के लिए खरीद रिकवरी के चरणों का पालन करें।
4. निजी इंस्टॉलेशन निर्देश भेजें
ऑर्डर पूरा होने के बाद, संबंधित ग्राहक के लिए होस्ट किया गया इंस्टॉलेशन लिंक बनाएँ या लिंक ईमेल या SMS से भेजें। डिलीवरी, समाप्ति, रद्दीकरण और डिवाइस सेटअप के लिए इंस्टॉलेशन गाइड का पालन करें।
लिंक और एक्टिवेशन विवरण को क्रेडेंशियल की तरह संभालें। उन्हें एनालिटिक्स, सार्वजनिक लॉग और सामान्य सपोर्ट नोट्स से बाहर रखें। खरीद का पूरा होना, लिंक की डिलीवरी और डिवाइस पर इंस्टॉलेशन को अलग-अलग परिणामों के रूप में दर्ज करें।
अगर आप किसी मौजूदा कनेक्टिविटी सेवा को बदल रहे हैं, तो नई Bird eSIM खरीद और इंस्टॉलेशन की योजना बनाएँ। ग्राहक के अपनी मौजूदा सेवा बदलने से पहले संबंधित डिवाइस और पैकेज की जाँच करें। Bird eSIM API किसी मौजूदा प्रोफ़ाइल को इम्पोर्ट नहीं करता और न ही मोबाइल नंबर ट्रांसफ़र करता है।
5. लगातार इस्तेमाल के लिए खाता पेज जोड़ें
प्रमाणित ग्राहक को अपना मौजूदा eSIM फिर से खोलने, रिपोर्ट किए गए पैकेज बैलेंस और समाप्ति देखने, और सपोर्ट तक पहुँचने दें। बैलेंस टाइमस्टैम्प और अज्ञात मान सही तरीके से दिखाएँ।
टॉप-अप के लिए संगत ऑफ़र का इस्तेमाल करें, और कौन-से कंट्रोल दिखाने हैं यह तय करने के लिए eSIM के available_actions का इस्तेमाल करें। किसी निष्क्रिय कार्रवाई का कारण उसके लौटाए गए कारण से समझाएँ, और अगर सबमिशन से पहले उपलब्धता बदल जाए तो अस्वीकृति को संभालें। रिन्यूअल और रद्दीकरण के लिए आवर्ती पैकेज गाइड का पालन करें।
रुकावट और रिकवरी की जाँच करें
खरीद के बाद ब्राउज़र बंद करें और ग्राहक का खाता फिर से खोलें। पुष्टि करें कि यह उसी ऑर्डर और eSIM तक ले जाता है। इंस्टॉलेशन शुरू होने के बाद यही दोहराएँ।
जाँचें कि खोई हुई खरीद प्रतिक्रिया, समाप्त इंस्टॉलेशन लिंक और अज्ञात उपयोग मान, हर एक उपयुक्त रिकवरी कार्रवाई तक ले जाता है। पुष्टि करें कि एक ग्राहक आपके खाता पेज से किसी दूसरे ग्राहक का इंस्टॉलेशन लिंक या eSIM नहीं खोल सकता।
अगले चरण
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।