बुर्किना फासो OTP API: +226 वेरिफिकेशन कोड

Q: OTP Route API में बुर्किना फासो की country id क्या है?

वह bf है। prices या activations endpoint कॉल करते समय उसे GET /api/v1/services से मिली सर्विस id के साथ जोड़ें।

+226 नंबर मँगाने से पहले क्या तैयार होना चाहिए?

ज़्यादातर पहली कोशिशें रूट की वजह से नहीं, बल्कि किसी छूटे हुए सेटअप की वजह से फेल होती हैं। पहला ऑर्डर देने से पहले ये बातें जाँच लें:

एक API key। Developer console में बनाएँ; लाइव keys का प्रीफ़िक्स or_live_ होता है और उन्हें Bearer टोकन के रूप में भेजा जाता है। आप 10 keys तक रख सकते हैं, इसलिए staging और CI को अलग key दें।
फ़ंड वाला वॉलेट। कार्ड या USDT/USDC से टॉप-अप करें। जो कोड आया ही नहीं, उसका कोई पैसा नहीं कटता।
सही ids। API में बुर्किना फासो bf है। सर्विस id अंदाज़े से न लिखें, GET /api/v1/services से देखें।
डिलीवरी की योजना। या तो सुरक्षित रखे गए secret वाला एक वेबहुक endpoint, या ठीक-ठाक अंतराल वाला पोलिंग लूप। एक अकाउंट में 5 तक वेबहुक endpoint रजिस्टर हो सकते हैं, जो staging और production को अलग रखने में काम आते हैं।
वेरिफ़ाई करने के लिए एक वैध अकाउंट। आपके अपने प्रोडक्ट का टेस्ट यूज़र, या वह बिज़नेस अकाउंट जिसे आपकी टीम चलाती है। हर सर्विस की शर्तें और OTP Route की Acceptable Use Policy लागू होती हैं।

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

बुर्किना फासो रूट पर कौन-से ऐप कोड भेज सकते हैं?

bf के लाइव कैटलॉग में फ़िलहाल 900 से अधिक सर्विस दर्ज हैं। लिखते समय उपलब्ध लोकप्रिय सर्विस में शामिल हैं: WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon और ChatGPT (OpenAI)।

हमारे कैरियर पार्टनर दिन भर क्षमता जोड़ते और घटाते रहते हैं, इसलिए इस सूची को एक स्नैपशॉट समझें। आपके कोड को हर ऑर्डर से ठीक पहले GET /api/v1/prices से पूछना चाहिए; वह मौजूदा कीमत बताता है और यह भी कि वह जोड़ी ऑर्डर की जा सकती है या नहीं।

देश `bf` के लिए API का क्रम कैसा चलता है?

GET /api/v1/prices?country=bf&service=whatsapp से अपनी जोड़ी की कीमत पढ़ें (service की जगह अपनी सर्विस id रखें)।
POST /api/v1/activations से activation बनाएँ, body होगी {"service": "whatsapp", "country": "bf"}। लौटाई गई activation id सहेज लें; आगे सब कुछ उसी पर टिका है।
जिस ऐप की टेस्टिंग कर रहे हैं, उससे SMS ट्रिगर करें, रिस्पॉन्स में मिले +226 नंबर का इस्तेमाल करते हुए।
अपने वेबहुक पर activation.sms_received का इंतज़ार करें। X-OTPRoute-Signature हेडर जाँचें, जिसका रूप t=<unix>,v1=<hex> है: endpoint secret से "<t>.<raw body>" पर HMAC-SHA256 निकालें, मिलान करें, और जिन रिक्वेस्ट का टाइमस्टैम्प पुराना हो उन्हें छोड़ दें। किनारे के मामलों के लिए OTP वेबहुक को HMAC से सुरक्षित करना वाला walkthrough देखें।
वेबहुक नहीं है? तो हर कुछ सेकंड में GET /api/v1/activations/{id} को पोल करें।
जल्दी निपट गया, या फेलियर पाथ टेस्ट कर रहे हैं? POST /api/v1/activations/{id}/cancel कॉल करें। जब कोई रन बिना कोड के खत्म होता है, तब आपको activation.expired या activation.cancelled भी दिखेगा।

अकाउंट पर 300 रिक्वेस्ट प्रति मिनट की सीमा है, जो पोलिंग के लिए काफ़ी है बशर्ते हर रन थोड़ा रुक-रुककर पोल करे।

क्या बिना कोडिंग वाला व्यक्ति +226 कोड मँगा सकता है?

हाँ। सपोर्ट स्टाफ़, मार्केटर और अकाउंट मैनेजर यही काम हाथ से कर सकते हैं। साइन इन करें, OTP Gateway खोलें, बुर्किना फासो चुनें, सर्विस चुनें और स्क्रीन पर दिखी कीमत की पुष्टि करें। नंबर तुरंत दिख जाता है; उसे ऐप में पेस्ट करें, SMS मँगाएँ, और कोड उसी डैशबोर्ड रो में आ जाता है। टैब खुला छोड़ दें या बाद में लौटें, activation अपने पूरे 20 मिनट तक सुनता रहता है।

+226 नंबर कैसे स्टोर करें, और SMS किस भाषा में आएगा?

बुर्किना फासो में राष्ट्रीय नंबर आठ अंकों के होते हैं और कोई trunk प्रीफ़िक्स नहीं है, इसलिए हटाने लायक कोई शुरुआती शून्य नहीं है: राष्ट्रीय रूप और +226 के बाद के अंक एक ही हैं। नंबर को E.164 में +226 और उसके बाद के आठ अंकों के रूप में स्टोर करें, और सेव करने से पहले यूज़र के इनपुट से स्पेस, डैश और अंतरराष्ट्रीय 00 हटाकर उसे नॉर्मलाइज़ करें। जिन बाज़ारों में trunk शून्य होता है, उनसे कॉपी किए गए वैलिडेशन नियम वैध +226 एंट्री को रिजेक्ट कर देंगे; यह लोकलाइज़ेशन का एक क्लासिक बग है, जिसके लिए रिग्रेशन टेस्ट रखना ठीक रहता है।

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

टीमें आम तौर पर यहाँ तब टेस्ट करती हैं जब वे फ़्रैंकोफ़ोन पश्चिम अफ़्रीका में लॉन्च कर रही हों, साइन-अप स्क्रीन की फ़्रेंच कॉपी जाँच रही हों, या पेमेंट और मोबाइल-मनी प्रोडक्ट के लिए कस्टमर ऑनबोर्ड कर रही हों; इस पैटर्न का वर्णन fintech ऑनबोर्डिंग पेज पर है।

नंबर पर कोड न पहुँचे तो क्या आज़माएँ?

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

रिट्राई डिज़ाइन पर और गहराई से जानकारी OTP डिलीवरी फेल होने को कम करना गाइड में है।

क्या बुर्किना फासो का लंबे समय वाला नंबर मिलता है, और बिलिंग कैसे चलती है?

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

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

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

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

हाँ। OTP Gateway पर +226 नंबर ऑर्डर करें, अपने ऐप से SMS ट्रिगर करें और कोड डैशबोर्ड में या API से पढ़ें। पैसे तभी लगते हैं जब कोड आ जाए।

OTP Route API में बुर्किना फासो की country id क्या है?

वह bf है। prices या activations endpoint कॉल करते समय उसे GET /api/v1/services से मिली सर्विस id के साथ जोड़ें।

क्या +226 नंबर शून्य से शुरू होते हैं?

नहीं। बुर्किना फासो में कोई trunk प्रीफ़िक्स नहीं है, इसलिए नंबर E.164 रूप में बस +226 और आठ अंक होता है।

बुर्किना फासो का वेरिफिकेशन नंबर कितनी देर सक्रिय रहता है?

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

क्या कोड फ़्रेंच में आएगा?

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

क्या मैं +226 नंबर से किसी एक प्लेटफ़ॉर्म पर कई अकाउंट खोल सकता हूँ?

नहीं। OTP Route आपके अपने प्रोडक्ट की टेस्टिंग और वैध बिज़नेस अकाउंट चलाने के लिए है। बड़े पैमाने पर साइन-अप या गढ़ी हुई पहचान Acceptable Use Policy और प्लेटफ़ॉर्म की अपनी शर्तों का उल्लंघन है।

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

+226 साइन-अप की टेस्टिंग: बुर्किना फासो वेरिफिकेशन नंबर की चेकलिस्ट