हिन्दी
QA, फ़िनटेक और लॉन्च टीमों के लिए नाइजीरिया (+234) SMS वेरिफ़िकेशन API
OTP Route से आप सिंगल-यूज़ OTP Gateway नंबरों पर नाइजीरिया (+234) के SMS वेरिफ़िकेशन कोड पा सकते हैं; कोड डैशबोर्ड में दिखता है और REST पोलिंग या साइन किए गए वेबहुक से आपके सिस्टम तक पहुँचता है। कीमत $0.20 प्रति कोड से शुरू होती है, हर सर्विस की सटीक कीमत API लाइव बताती है, और जिस एक्टिवेशन पर 20 मिनट में कोई SMS नहीं आता उसका कोई पैसा नहीं लगता।
नाइजीरियाई OTP पाने के लिए मुझे कौन-से endpoints कॉल करने होंगे?
सब कुछ https://otproute.com/api/v1 के अंतर्गत है और or_live_ से शुरू होने वाली Bearer key से ऑथेंटिकेट होता है। नाइजीरिया का country id ng है। एक सामान्य इंटीग्रेशन में चार कॉल होते हैं:
GET /api/v1/prices?country=ng&service=<id>से ऑर्डर करने से पहले मौजूदा कीमत पक्की करें।POST /api/v1/activationsको{"service": "<id>", "country": "ng"}के साथ भेजकर +234 नंबर रिज़र्व करें। लौटे हुए activation id को सँभालकर रखें; बाद की हर कॉल और हर वेबहुक इवेंट उसी पर आधारित होता है।GET /api/v1/activations/{id}से स्टेटस पढ़ें और कोड आ जाने पर कोड भी।- अगर आपका टेस्ट पहले ही फ़ेल हो जाए और नंबर की ज़रूरत न रहे तो
POST /api/v1/activations/{id}/cancelकॉल करें।
CI में GET /api/v1/balance को प्री-फ़्लाइट चेक की तरह इस्तेमाल करना काम आता है, ताकि वॉलेट कम होने पर नाइटली सूट शुरू में ही फ़ेल हो जाए। OTP API इंटीग्रेशन गाइड इसी क्रम को एरर हैंडलिंग के साथ समझाती है।
लागोस की टेस्ट सूट को पोलिंग करनी चाहिए या वेबहुक?
कुछ मैन्युअल रन के लिए पोलिंग ठीक है। लेकिन जब कोई पाइपलाइन एक साथ कई +234 नंबर ऑर्डर करने लगे, तो वेबहुक ज़्यादा साफ़-सुथरा रास्ता है। Developer console में अपने पाँच endpoints में से एक रजिस्टर करें और activation.sms_received, activation.expired और activation.cancelled को सब्सक्राइब करें।
हर रिक्वेस्ट में X-OTPRoute-Signature: t=<unix>,v1=<hex> आता है। टाइमस्टैम्प, एक डॉट और रॉ बॉडी पर अपने endpoint secret से HMAC-SHA256 दोबारा निकालें, उसे constant time में मिलाएँ, और टाइमस्टैम्प पुराना हो तो रिक्वेस्ट छोड़ दें। प्रोसेस हो चुके activation id सहेजें ताकि दोबारा भेजा गया इवेंट आपका टेस्ट दो बार न चला दे। HMAC से OTP वेबहुक सुरक्षित करने वाली पोस्ट में ज़्यादा विस्तृत चेकलिस्ट है। कुल ट्रैफ़िक प्रति अकाउंट 300 रिक्वेस्ट प्रति मिनट के भीतर रखें; इवेंट पर निर्भर रहने पर, लगातार पोलिंग के मुक़ाबले, यह सीमा काफ़ी खुली है।
+234 रूट पर कौन-सी सर्विसें उपलब्ध हैं?
ng रूट पर अभी 2,700 से ज़्यादा सर्विसें सूचीबद्ध हैं। अक्सर माँगी जाने वाली सर्विसों में WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon और ChatGPT (OpenAI) शामिल हैं। हमारे कैरियर पार्टनर सप्लाई अपडेट करते रहते हैं, इसलिए इन्वेंटरी दिन भर बदलती है; कल दिखी कोई सर्विस आज भी मौजूद होगी, यह मानने के बजाय लाइव उपलब्धता क्वेरी करें।
टीमों को सबसे पहले नाइजीरिया वेरिफ़िकेशन नंबर की ज़रूरत क्यों पड़ती है?
नाइजीरिया अफ़्रीका के सबसे व्यस्त फ़िनटेक और कंज़्यूमर-ऐप बाज़ारों में से एक है, और कई प्रोडक्ट फ़ोन नंबर को ही प्राथमिक पहचान मानते हैं। इसीलिए वॉलेट, लेंडिंग ऐप, राइड-हेलिंग, डिलीवरी और सोशल प्रोडक्ट्स के ऑनबोर्डिंग में SMS वाला चरण बेहद अहम हो जाता है। देश के बाहर की टीमें टेस्टिंग के लिए +234 नंबर इस्तेमाल करती हैं ताकि पक्का हो सके कि साइन-अप फ़्लो, रीसेंड टाइमर और एरर कॉपी वैसे ही चलें जैसे किसी स्थानीय यूज़र के लिए चलते।
अंग्रेज़ी आधिकारिक भाषा है, इसलिए वेरिफ़िकेशन टेक्स्ट आमतौर पर अंग्रेज़ी में आते हैं, जिससे ऑटोमेटेड टेस्ट में असर्शन लॉजिक सीधा रहता है। ख़ास तौर पर फ़िनटेक टीमें फ़िनटेक ऑनबोर्डिंग पेज देखें, जहाँ बताया गया है कि यह उन आइडेंटिटी चेक के साथ कैसे बैठता है जिनकी जगह OTP Route नहीं लेता।
नाइजीरियाई मोबाइल नंबर किस फ़ॉर्मेट में लिखे जाते हैं?
कंट्री कोड +234 है और ट्रंक प्रीफ़िक्स 0 है। नाइजीरियाई लोग आम तौर पर मोबाइल नंबर शून्य से शुरू होने वाले ग्यारह अंकों में लिखते हैं, जैसे 0803 123 4567; अंतरराष्ट्रीय रूप में शून्य हट जाता है और +234 803 123 4567 बनता है। E.164 मान (+234803...) ही सहेजें, इनपुट में स्थानीय ग्यारह-अंकीय फ़ॉर्मेट स्वीकार करें, और सहेजने से पहले शुरुआती 0 हटा दें। जो वैलिडेटर सिर्फ़ कुल लंबाई जाँचता है, वह +2340803... को ख़ुशी-ख़ुशी मान लेगा, और प्रोडक्शन में SMS भेजने की विफलताओं का यह एक आम कारण है।
क्या मैं डैशबोर्ड से भी नाइजीरियाई नंबर ऑर्डर कर सकता हूँ?
हाँ। ईमेल कोड या Google से साइन अप करें, वॉलेट में पैसे डालें, OTP Gateway खोलें, नाइजीरिया और सर्विस चुनें, और दिख रही कीमत की पुष्टि करें। नंबर तुरंत तैयार होता है और कोड आते ही ऑर्डर के बगल में दिखने लगता है।
अगर कोड नहीं आता, तो 20 मिनट की विंडो को पूरा चलने दें; पैसा तभी कटता है जब कोड आता है, और एक्सपायर या कैंसल हुए ऑर्डर अपने आप रिफ़ंड हो जाते हैं। फिर थोड़ी देर बाद नया ऑर्डर आज़माएँ, टेस्ट इजाज़त दे तो घाना जैसा कोई दूसरा रूट आज़माएँ, और देखें कि कहीं वह सर्विस वर्चुअल नंबरों को मना तो नहीं करती। एक के बाद एक तेज़ी से नए ऑर्डर देने से बचें।
नाइजीरिया में लंबे समय वाली लाइनों, बिलिंग और सैंडबॉक्स का क्या?
OTP Route नाइजीरिया का कोई सेल्फ़-सर्व लंबी अवधि वाला नंबर नहीं देता। Dedicated Numbers सिर्फ़ संयुक्त राज्य अमेरिका और कनाडा के लिए बिकते हैं, $1.95/month से। टिकाऊ +234 लाइन के लिए [email protected] पर ईमेल करें; वह मिल पाएगी या नहीं, यह स्थानीय नियमों पर निर्भर है।
ख़र्च एक प्रीपेड USD वॉलेट से होता है, जिसमें कोई प्लान या मासिक फ़ीस नहीं है। कार्ड से या USDT/USDC से टॉप-अप करें और हर टॉप-अप का PDF इनवॉइस पाएँ। सपोर्ट से डेवलपमेंट अकाउंट को सैंडबॉक्स मोड में बदलने को कहें, तो आपका इंटीग्रेशन सिम्युलेटेड नंबर और कोड पाएगा, और आप वॉलेट का पैसा ख़र्च किए बिना पूरे वेबहुक पाथ को टेस्ट कर सकेंगे।
अक्सर पूछे जाने वाले प्रश्न
क्या मैं स्थानीय SIM के बिना अपने ऐप का नाइजीरियाई साइन-अप फ़्लो टेस्ट कर सकता हूँ?
हाँ। OTP Gateway से +234 नंबर ऑर्डर करें और कोड डैशबोर्ड में या API से पढ़ें।
OTP Route API में नाइजीरिया का country id क्या है?
प्राइस लुकअप और एक्टिवेशन रिक्वेस्ट में country वैल्यू के रूप में ng इस्तेमाल करें।
नाइजीरिया SMS OTP पाने की लागत कितनी है?
$0.20 प्रति कोड से शुरू; सटीक रकम सर्विस पर निर्भर करती है और prices endpoint बताता है।
अगर SMS न आए तो क्या मुझसे पैसे लगते हैं?
नहीं। 20 मिनट में कुछ न आए, या आप कैंसल कर दें, तो पूरी रकम वॉलेट में लौट जाती है।
0803 123 4567 जैसे नंबर को कैसे सहेजूँ?
शुरुआती शून्य हटाएँ और उसे +2348031234567 की तरह सहेजें, यानी बिना स्पेस वाला E.164 रूप।
क्या इन नंबरों को किसी भी अकाउंट के लिए इस्तेमाल करना ठीक है?
सिर्फ़ अपने वैध प्रोडक्ट्स और अकाउंट के लिए। हर सर्विस की शर्तों और OTP Route की Acceptable Use Policy का पालन करें; कुछ सर्विसें वर्चुअल नंबर सीधे ठुकरा देती हैं।
सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।