जमैका के SMS वेरिफ़िकेशन कोड: चेकलिस्ट, स्टेप और समाधान

पहली जमैकन एक्टिवेशन से पहले मुझे क्या पक्का करना चाहिए?

जमैका नॉर्थ अमेरिकन नंबरिंग प्लान के भीतर आता है, इसलिए ज़्यादातर देशों से कुछ जाँचें अलग हैं:

• आपका वैलिडेटर ऐसे +1 नंबर स्वीकार करता है जो अमेरिकी या कनाडाई नहीं हैं। बहुत से साइन-अप फ़ॉर्म चुपचाप मान लेते हैं कि हर +1 नंबर अमेरिकी है।
• आपका कंट्री सिलेक्टर जमैका को अलग से दिखाता है, +1 को एक ही क्षेत्र मानने के बजाय।
• Developer console में or_live_ API कुंजी मौजूद है, और secret वाला webhook endpoint डिप्लॉय है, या आपका टेस्ट हार्नेस poll करने के लिए सेट है।
• वॉलेट में फ़ंड है, या ड्राई रन के लिए sandbox मोड चालू करा लिया गया है।
• आपको GET /api/v1/services से सेवा का id पता है; जमैका का country id jm है।

पहली दो बातें ग़लत हों तो ऐसी नाकामियाँ बनती हैं जो रूटिंग की समस्या जैसी दिखती हैं पर पूरी तरह आपके अपने कोड में होती हैं।

+1 जमैकन नंबर को ख़ास तरह से क्यों सँभालना पड़ता है?

जमैकन नंबर एरिया कोड 876 और नए 658 का इस्तेमाल करते हैं, जिनके बाद सात अंकों का सब्सक्राइबर नंबर आता है, इसलिए पूरा E.164 रूप +1 और दस अंक होता है। घरेलू तौर पर लोग लंबी दूरी के लिए शुरुआती 1 डायल करते हैं, जिसे स्टोर करने से पहले हटाना चाहिए।

इंजीनियरों के लिए ज़रूरी बात यह है कि अकेला +1 देश के बारे में कुछ नहीं बताता। क्षेत्र की पहचान एरिया कोड देखकर करनी होगी, और जो भी लॉजिक डायलिंग कोड से करेंसी, टाइम ज़ोन या SMS टेम्प्लेट चुनता है, उसे भी यही सावधानी चाहिए। कैनोनिकल E.164 स्ट्रिंग स्टोर करें, पहचाने गए क्षेत्र को अलग फ़ील्ड में रखें, और 876 व 658 दोनों इनपुट टेस्ट करें।

अंग्रेज़ी आधिकारिक भाषा है और वेरिफ़िकेशन टेक्स्ट लगभग हमेशा अंग्रेज़ी में आते हैं, जबकि रोज़मर्रा की बोलचाल में अक्सर जमैकन पैटवा चलती है। टीमें यहाँ कैरिबियन लॉन्च के लिए, अमेरिका, UK और कनाडा में बसे प्रवासी समुदाय को सेवा देने वाले रेमिटेंस और फ़िनटेक फ़्लो के लिए, और पर्यटन व हॉस्पिटैलिटी प्रोडक्ट के लिए टेस्ट करती हैं। हर बाज़ार के लिए रूट कैसे चुनें, यह OTP के लिए कंट्री रूटिंग वाले लेख में है।

जमैका SMS वेरिफ़िकेशन API के स्टेप क्या हैं?

1. बेस URL https://otproute.com/api/v1 पर GET /api/v1/prices?country=jm&service=<id> से लाइव क़ीमत जाँचें।
2. ऑर्डर करें: POST /api/v1/activations को बॉडी {"service": "<id>", "country": "jm"} के साथ भेजें। activation id और नंबर नोट कर लें।
3. जिस ऐप को टेस्ट कर रहे हैं उसमें नंबर सबमिट करें।
4. कोड अपने webhook पर activation.sms_received इवेंट से लें, या GET /api/v1/activations/{id} को poll करके।
5. जमैकन कोशिश को जल्दी छोड़ना हो तो POST /api/v1/activations/{id}/cancel भेजें, जिससे होल्ड हट जाता है।

किसी भी इवेंट पर कार्रवाई से पहले, अपने endpoint secret से "<t>.<raw body>" का HMAC-SHA256 दोबारा निकालें, उसे X-OTPRoute-Signature के v1 मान से मिलाएँ, और बहुत पुराने टाइमस्टैम्प ठुकरा दें। activation.expired और activation.cancelled भी activation id के आधार पर सँभालें, ताकि रीट्राई से दोहरी प्रोसेसिंग न हो। क्षमता की योजना के लिए: एक अकाउंट में 10 कुंजियाँ और 5 webhook endpoint हो सकते हैं, और उन सबमें मिलाकर सीमा 300 अनुरोध प्रति मिनट है।

जमैकन रूट पर कौन-से ऐप कोड पा सकते हैं?

जमैका में अभी 900 से ज़्यादा सेवाएँ सूचीबद्ध हैं। अक्सर इस्तेमाल होने वालों में WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb और ChatGPT (OpenAI) हैं।

हर सेवा की उपलब्धता दिन भर बदलती है, इसलिए सूची हार्ड-कोड करने की जगह हर रन की शुरुआत में prices endpoint पढ़ें।

नॉन-डेवलपर डैशबोर्ड में यही चेकलिस्ट कैसे अपनाएँ?

/signup पर ईमेल कोड या Google से अकाउंट बनाएँ, TOTP चालू करें और टॉप-अप करें। फिर OTP Gateway खोलें, सेवा चुनें, जमैका चुनें और लाइव क़ीमत कन्फ़र्म करें। नंबर को ऐप में पेस्ट करें, और टेक्स्ट पहुँचते ही कोड डैशबोर्ड में दिख जाता है। सपोर्ट स्टाफ़ अक्सर इसी रास्ते से जमैकन नंबर पर किसी ग्राहक की साइन-अप समस्या दोहराकर देखता है।

ट्रबलशूटिंग: जमैकन कोड देर से आया, नहीं आया या ठुकरा दिया गया

• एंट्री पर ही रिजेक्ट हुआ? पहले अपना फ़ॉर्म जाँचें; सिर्फ़-US वैलिडेटर आम दोषी होता है। अगर थर्ड-पार्टी ऐप ख़ुद नंबर ठुकराता है, तो हो सकता है वह वर्चुअल नंबर स्वीकार नहीं करता।
• अभी तक कुछ नहीं? कैंसल करके दोबारा ऑर्डर करने की जगह एक्टिवेशन को उसके 20 मिनट खुला रहने दें।
• फिर भी कुछ नहीं? बाद में या किसी दूसरे सेवा रूट से कोशिश करें। एक ही ऑर्डर को लूप में दोहराकर दबाव न डालें।

विंडो ख़त्म होने से पहले नंबर पर कोई SMS न पहुँचे, तो पूरा शुल्क अपने-आप वॉलेट में लौटा दिया जाता है। लंबी चेकलिस्ट OTP डिलीवरी फ़ेल होना कम करने वाली गाइड में है।

क्या डेडिकेटेड लाइनें, वॉलेट और sandbox जमैका पर लागू होते हैं?

+1 कोड साझा होने से जमैका डेडिकेटेड प्रोडक्ट का हिस्सा नहीं बन जाता। Dedicated Virtual Numbers सिर्फ़ संयुक्त राज्य अमेरिका और कनाडा के लिए बिकते हैं, $1.95/month से, और जमैका का कोई सेल्फ़-सर्व लंबे समय वाला नंबर नहीं है। ज़रूरत हो तो पूछने के लिए [email protected] पर ईमेल करें; फ़ैसला स्थानीय नियम करते हैं और कोई वादा नहीं है।

बाक़ी सब कुछ हर जगह जैसा ही चलता है: प्रीपेड USD वॉलेट, कोई मासिक शुल्क नहीं, कार्ड या USDT/USDC से टॉप-अप, और हर टॉप-अप पर ईमेल से PDF इनवॉइस। अनुरोध पर मिलने वाला sandbox मोड इंटीग्रेशन टेस्ट के लिए सिमुलेटेड नंबर और कोड लौटाता है। शुल्क कैसे लगते हैं, यह /pricing पर देखें।

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

क्या मैं किंग्स्टन में हुए बिना अपने ऐप का जमैकन फ़ोन वेरिफ़िकेशन टेस्ट कर सकता हूँ?

हाँ। OTP Route से अपनी सेवा के लिए +1 876 या +1 658 नंबर ऑर्डर करें और कोड डैशबोर्ड या API में पढ़ें, आपकी टीम कहीं भी हो।

जमैका के लिए मैं कौन-सा country id भेजूँ?

jm भेजें। डायलिंग कोड +1 है, पर API देश की पहचान इसी id से करता है।

क्या जमैकन नंबर को अमेरिकी नंबर माना जाता है?

नहीं। वह +1 कोड साझा करता है, पर अपने एरिया कोड वाला अलग देश है, और कई ऐप उसे जमैका ही मानते हैं।

अगर जमैकन कोड न आए तो मेरे पैसे का क्या होता है?

अगर 20 मिनट के भीतर कोई SMS नहीं आता, या आप कैंसल कर देते हैं, तो पूरी रक़म वॉलेट में लौट जाती है।

क्या मैं OTP Route से जमैका का लंबे समय वाला नंबर ख़रीद सकता हूँ?

सेल्फ़-सर्व नहीं। लंबे समय वाले Dedicated Numbers सिर्फ़ अमेरिका और कनाडा के लिए हैं; जमैका के बारे में पूछने के लिए सपोर्ट को ईमेल करें।

क्या बिना भुगतान के webhook फ़्लो टेस्ट करने का कोई तरीका है?

डेवलपमेंट अकाउंट पर sandbox मोड माँगें। वह सिमुलेटेड नंबर और कोड लौटाता है, और हैंडलर वाला पक्ष webhook आधारित OTP कैप्चर लेख में समझाया गया है।

टेस्टिंग के लिए +1 जमैका नंबर के किन इस्तेमालों की अनुमति है?

अपने प्रोडक्ट की टेस्टिंग, QA ऑटोमेशन और वैध बिज़नेस अकाउंट चलाना। कैरिबियन रूट पर हर ऐप की अपनी शर्तें और OTP Route की Acceptable Use Policy, दोनों लागू होती हैं।

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