केमैन आइलैंड्स वेरिफिकेशन नंबरों के लिए प्री-फ़्लाइट चेकलिस्ट

प्री-फ़्लाइट चेकलिस्ट: +1 345 नंबर ऑर्डर करने से पहले क्या तैयार होना चाहिए?

इस सूची से एक बार गुज़र लें तो पहला केमैन activation आम तौर पर बिना झंझट निपट जाता है:

• अकाउंट और सुरक्षा। ईमेल पते और 6 अंकों के ईमेल कोड (या Google साइन-इन) से साइन अप करें, फिर जो भी वॉलेट से खर्च कर सकता है उसके लिए TOTP टू-फ़ैक्टर चालू करें।
• वॉलेट में फ़ंड। प्रीपेड USD वॉलेट को कार्ड या USDT/USDC से टॉप-अप करें। न कोई प्लान चुनना है और न कोई मासिक शुल्क है।
• API key। Developer console में एक key बनाएँ; वह or_live_ से शुरू होती है और Bearer हेडर में जाती है। एक अकाउंट में 10 keys तक रखी जा सकती हैं।
• वेबहुक endpoint। एक URL रजिस्टर करें और उसका secret ऐसी जगह रखें जहाँ आपका हैंडलर उसे पढ़ सके। प्रति अकाउंट पाँच endpoint की सीमा है।
• फ़ोन पार्सिंग कॉन्फ़िगर हो। पक्का करें कि आपकी नंबर लाइब्रेरी एरिया कोड 345 को केमैन आइलैंड्स से जोड़ती है, न कि हर +1 नंबर को डिफ़ॉल्ट रूप से अमेरिका का मान लेती है।
• ड्राई रन चाहिए तो sandbox। सपोर्ट से डेवलपमेंट अकाउंट को sandbox मोड पर पलटने को कहें ताकि सिम्युलेटेड नंबर और कोड वॉलेट के पैसे को छुए बिना आपके इंटीग्रेशन को परख सकें।

रिस्पॉन्स में दिखने वाली हर फ़ील्ड की सूची API reference में है।

केमैन नंबर उस कोड को क्यों अटकाता है जो मानता है कि +1 का मतलब अमेरिका है?

केमैन आइलैंड्स नॉर्थ अमेरिकन नंबरिंग प्लान के भीतर आते हैं, इसलिए वे अमेरिका, कनाडा और कैरिबियाई क्षेत्रों की एक लंबी सूची के साथ कंट्री कोड 1 साझा करते हैं। केमैन लाइन की पहचान एरिया कोड 345 से होती है। पूरा नंबर कंट्री कोड के बाद दस अंकों का होता है, स्थानीय रूप से (345) NXX-XXXX के रूप में लिखा जाता है और E.164 में +1345 के बाद सात अंक के रूप में स्टोर होता है।

इंजीनियरों के लिए तीन व्यावहारिक नतीजे:

• रीजन डिटेक्शन को एरिया कोड देखना चाहिए। जो साइन-अप फ़ॉर्म केवल +1 प्रीफ़िक्स से देश का अनुमान लगाता है, वह केमैन ग्राहक को अमेरिकी बता देगा और गलत टाइम ज़ोन, मुद्रा या सहमति टेक्स्ट चुन सकता है।
• NANP में शुरुआती 1 लंबी दूरी के trunk अंक का भी काम करता है, इसलिए यूज़र कभी 1 345... तो कभी सिर्फ़ 345... टाइप कर देते हैं। सेव करने से पहले तीनों को E.164 स्ट्रिंग में नॉर्मलाइज़ करें।
• नंबरों को बिना स्पेस, डैश या कोष्ठक के स्टोर करें, और फ़ॉर्मैट केवल दिखाते समय करें।

अंग्रेज़ी आधिकारिक भाषा है, इसलिए इस बाज़ार के कोड आम तौर पर अंग्रेज़ी में आते हैं। फिर भी सटीक शब्द उस सर्विस से तय होते हैं जो संदेश भेजती है, रूट से नहीं।

कौन-सी सर्विस केमैन आइलैंड्स वेरिफिकेशन नंबर पर कोड रूट कर सकती हैं?

देश ky के लाइव स्नैपशॉट में फ़िलहाल WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix और eBay शामिल हैं। लंबी पूँछ गिनें तो यह रूट 600 से अधिक सर्विस कवर करता है, और सूची दिन भर बदलती है, इसीलिए उपलब्धता हार्ड-कोड करने के बजाय हमेशा API से पढ़ी जाती है।

टीमों को टेस्टिंग के लिए आम तौर पर +1 345 नंबर इसलिए चाहिए कि ये द्वीप एक बड़ा ऑफ़शोर वित्तीय केंद्र और व्यस्त पर्यटन स्थल हैं। फ़ंड एडमिनिस्ट्रेटर, बीमा कंपनियाँ, ट्रैवल प्लेटफ़ॉर्म और प्रॉपर्टी कारोबार स्थानीय ग्राहकों को ऑनबोर्ड करते हैं, और उनकी प्रोडक्ट टीमें साइन-अप फ़्लो को वैसा ही चलता देखना चाहती हैं जैसा केमैन का निवासी अनुभव करेगा। fintech ऑनबोर्डिंग के नोट्स इस पैटर्न को और विस्तार से बताते हैं।

चरण-दर-चरण: केमैन आइलैंड्स OTP API कॉल का क्रम कैसे चलता है?

सभी कॉल आपकी Bearer key के साथ https://otproute.com/api/v1 पर जाती हैं, 300 रिक्वेस्ट प्रति मिनट की सीमा के भीतर।

1. GET /api/v1/services को एक बार कॉल करें और अपने टेस्ट सूट के लिए ज़रूरी सर्विस ids कैश कर लें।
2. लाइव कीमत पढ़ने और यह पक्का करने के लिए कि वह जोड़ी अभी उपलब्ध है, GET /api/v1/prices?country=ky&service=<id> कॉल करें।
3. {"service": "<id>", "country": "ky"} जैसी body के साथ POST /api/v1/activations भेजें। रिस्पॉन्स में activation id और +1 345 नंबर होता है।
4. उस नंबर को टेस्ट किए जा रहे ऐप में डालें और उसका SMS चरण ट्रिगर करें।
5. अपने वेबहुक पर activation.sms_received का इंतज़ार करें। पहले X-OTPRoute-Signature हेडर जाँचें: endpoint secret से <t>.<raw body> पर HMAC-SHA256 निकालें, उसकी v1 से तुलना करें, और पुराने टाइमस्टैम्प रिजेक्ट करें।
6. वेबहुक न हो तो कोड दिखने या विंडो बंद होने तक सामान्य अंतराल पर GET /api/v1/activations/{id} को पोल करें।
7. अगर टेस्ट बीच में रुके, तो POST /api/v1/activations/{id}/cancel कॉल करें ताकि होल्ड की गई रकम वॉलेट में लौट आए।

HMAC वेबहुक गाइड सिग्नेचर जाँच को पंक्ति-दर-पंक्ति समझाती है।

डैशबोर्ड पसंद करने वाले सहकर्मियों के लिए चरण-दर-चरण

सपोर्ट स्टाफ़ और अकाउंट मैनेजरों को API को छूने की ज़रूरत ही नहीं:

1. डैशबोर्ड में OTP Gateway पेज खोलें।
2. देश के रूप में केमैन आइलैंड्स चुनें, फिर वह सर्विस जिसे आप वेरिफ़ाई कर रहे हैं।
3. ऑर्डर से पहले दिखाई गई कीमत जाँचें और पुष्टि करें।
4. नंबर को ऐप में कॉपी करें, कोड मँगाएँ, और activation पेज खुला रखें; SMS आते ही वहाँ दिख जाता है।

20 मिनट की विंडो और रिफ़ंड ठीक वैसे ही लागू होते हैं जैसे API के ज़रिए।

समस्या निवारण: अगर +1 345 नंबर पर कोई कोड न पहुँचे तो?

चुप रहे activation का कोई शुल्क नहीं लगता। अगर 20 मिनट बीतने से पहले कोई SMS नहीं आता, या आप कैंसल कर देते हैं, तो पूरी रकम अपने आप वॉलेट में लौट जाती है। दोबारा ऑर्डर करने से पहले:

• विंडो चलने दें। डिलीवरी का समय सर्विस और रूट पर निर्भर है, इसलिए धीमा कोड ज़रूरी नहीं कि नाकाम कोड हो।
• सर्विस की नीति देखें। कुछ सर्विस वर्चुअल नंबर सीधे नकार देती हैं, और रिफ़ंड ठीक इसी स्थिति के लिए है।
• बाद में दोबारा कोशिश करें या रूट बदलें। इन्वेंटरी दिन भर बदलती है; एक घंटे बाद की दूसरी कोशिश, या किसी पड़ोसी कैरिबियाई देश पर, अलग बर्ताव दे सकती है।
• तेज़ लूप से बचें। जो स्क्रिप्ट हर कुछ सेकंड में कैंसल करके दोबारा ऑर्डर करती है, वह आपकी रेट लिमिट खर्च करती है और शायद ही कभी काम आती है।

फेल डिलीवरी प्लेबुक में और निदान हैं। हर नंबर का इस्तेमाल सिर्फ़ अपने प्रोडक्ट या अपने बिज़नेस अकाउंट के लिए करें, हर सर्विस की शर्तों का पालन करें, और याद रखें कि OTP Route की Acceptable Use Policy लागू होती है।

क्या मैं केमैन लाइन लंबे समय के लिए रख सकता हूँ, और बिलिंग कैसे होती है?

केमैन आइलैंड्स के लिए कोई सेल्फ़-सर्व लंबी अवधि वाला नंबर नहीं है। +1 कंट्री कोड साझा होने से यह नहीं बदलता: Dedicated Numbers केवल संयुक्त राज्य अमेरिका और कनाडा का प्रोडक्ट हैं, $1.95/month से, इनबाउंड SMS, आउटबाउंड SMS और ब्राउज़र कॉलिंग के साथ। अगर आपकी टीम को स्थायी 345 लाइन चाहिए, तो [email protected] पर ईमेल करें; उपलब्धता स्थानीय नियमों पर निर्भर है और उसका वादा नहीं किया जाता।

बाकी सब कुछ एक प्रीपेड USD वॉलेट पर चलता है। कार्ड या USDT/USDC से हर टॉप-अप पर ईमेल से PDF इनवॉइस बनता है, और pricing पेज पे-एज़-यू-गो मॉडल को समझाता है।

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

क्या मैं लोकल SIM के बिना अपने ऐप का केमैन आइलैंड्स साइन-अप फ़्लो टेस्ट कर सकता हूँ?

हाँ। OTP Gateway से +1 345 नंबर ऑर्डर करें, उसे अपने ऐप में डालें, और कोड डैशबोर्ड में या API से पढ़ें। आप $0.20 प्रति कोड से भुगतान करते हैं, और केवल तब जब कोड आ जाए।

API केमैन आइलैंड्स के लिए कौन-सी country id इस्तेमाल करती है?

id ky है। GET /api/v1/prices या POST /api/v1/activations कॉल करते समय उसे country मान के रूप में दें।

मैं अपने डेटाबेस में केमैन फ़ोन नंबर कैसे स्टोर करूँ?

E.164 रूप में स्टोर करें: +1345 और उसके बाद सात अंकों का सब्सक्राइबर नंबर, बिना स्पेस या विराम-चिह्न के। क्षेत्र की पहचान +1 प्रीफ़िक्स से नहीं, बल्कि 345 एरिया कोड से करें।

क्या +1 345 नंबर Dedicated Numbers के लिए अमेरिकी नंबर गिना जाता है?

नहीं। Dedicated Numbers केवल अमेरिका और कनाडा के लिए बिकते हैं, इसलिए केमैन लाइन केवल एक कोड वाले OTP Gateway activation के रूप में उपलब्ध है।

अगर SMS कभी न आए तो मेरे पैसे का क्या होता है?

activation 20 मिनट खुला रहता है। अगर उस समय में कोई कोड नहीं आता, या आप पहले कैंसल कर देते हैं, तो पूरी रकम अपने आप आपके वॉलेट में लौटा दी जाती है।

क्या मैं वॉलेट का पैसा खर्च किए बिना CI में केमैन OTP टेस्ट चला सकता हूँ?

सपोर्ट से डेवलपमेंट अकाउंट को sandbox पर ले जाने को कहें। वह सिम्युलेटेड नंबर और कोड लौटाता है, इसलिए आपकी पाइपलाइन बिना किसी लागत के पूरा activation और वेबहुक फ़्लो चला सकती है।

OTP Route केमैन की कितनी सर्विस कवर करता है?

नवीनतम स्नैपशॉट के समय 600 से अधिक। इन्वेंटरी दिन भर बदलती है, इसलिए लाइव उपलब्धता के लिए GET /api/v1/services और prices endpoint को क्वेरी करें।

सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।