নাইজেরিয়া (+234) SMS ভেরিফিকেশন API: QA, ফিনটেক ও লঞ্চ টিমের জন্য

নাইজেরিয়ান OTP পেতে কোন এন্ডপয়েন্টগুলো কল করব?

সবকিছু https://otproute.com/api/v1-এর অধীনে থাকে এবং or_live_ দিয়ে শুরু হওয়া একটি Bearer কী দিয়ে অথেনটিকেট হয়। নাইজেরিয়ার country id হলো ng। একটি সাধারণ ইন্টিগ্রেশনে চারটি কল লাগে:

1. অর্ডার করার আগে বর্তমান দাম নিশ্চিত করতে GET /api/v1/prices?country=ng&service=<id>।
2. +234 নম্বর রিজার্ভ করতে POST /api/v1/activations, বডি {"service": "<id>", "country": "ng"}। ফেরত আসা activation id সংরক্ষণ করুন; পরের প্রতিটি কল ও ওয়েবহুক ইভেন্ট এই id দিয়েই চিহ্নিত হয়।
3. স্ট্যাটাস এবং কোড এসে গেলে তা পড়তে GET /api/v1/activations/{id}।
4. আপনার টেস্ট আপস্ট্রিমে ব্যর্থ হলে এবং নম্বরটি আর দরকার না হলে POST /api/v1/activations/{id}/cancel।

CI-তে প্রি-ফ্লাইট চেক হিসেবে GET /api/v1/balance কাজে লাগে, ফলে ওয়ালেটে টাকা কম থাকলে নাইটলি স্যুট দ্রুত ফেল করে। একই ক্রম এরর হ্যান্ডলিংসহ OTP API ইন্টিগ্রেশন গাইড-এ দেখানো আছে।

লাগোসের টেস্ট স্যুটে পোলিং করব, নাকি ওয়েবহুক?

হাতে গোনা কয়েকটি ম্যানুয়াল রানের জন্য পোলিংই যথেষ্ট। তবে পাইপলাইন একসঙ্গে একাধিক +234 নম্বর অর্ডার করতে শুরু করলে ওয়েবহুক বেশি পরিচ্ছন্ন। ডেভেলপার কনসোলে আপনার পাঁচটি এন্ডপয়েন্টের একটি নিবন্ধন করুন এবং activation.sms_received, activation.expired ও activation.cancelled ইভেন্টে সাবস্ক্রাইব করুন।

প্রতিটি রিকোয়েস্টে X-OTPRoute-Signature: t=<unix>,v1=<hex> হেডার থাকে। এন্ডপয়েন্টের সিক্রেট দিয়ে টাইমস্ট্যাম্প, একটি ডট ও র বডির ওপর HMAC-SHA256 আবার হিসাব করুন, কনস্ট্যান্ট টাইমে তুলনা করুন, আর টাইমস্ট্যাম্প পুরনো হলে রিকোয়েস্ট বাতিল করুন। প্রসেস করা 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... খুশিমনে মেনে নেবে, আর প্রোডাকশনে সেন্ড ব্যর্থ হওয়ার একটি পরিচিত কারণ এটিই।

ড্যাশবোর্ড থেকেই কি নাইজেরিয়ান নম্বর অর্ডার করা যায়?

হ্যাঁ। ইমেইল কোড বা Google দিয়ে সাইন আপ করুন, ওয়ালেটে টাকা যোগ করুন, OTP Gateway খুলে নাইজেরিয়া ও সার্ভিস বেছে নিন, এবং দেখানো দাম নিশ্চিত করুন। নম্বর সঙ্গে সঙ্গে তৈরি হয় এবং কোড এলে অর্ডারের পাশেই দেখা যায়।

কোড না এলে 20 মিনিটের উইন্ডো শেষ হতে দিন; কোড এলেই কেবল আপনি টাকা দেন, আর মেয়াদ শেষ হওয়া বা বাতিল করা অর্ডার স্বয়ংক্রিয়ভাবে রিফান্ড হয়। তারপর কিছুক্ষণ পরে নতুন অর্ডার দিন, আপনার টেস্টে সম্ভব হলে ঘানা-র মতো অন্য রুট চেষ্টা করুন, এবং সার্ভিসটি ভার্চুয়াল নম্বর প্রত্যাখ্যান করে কি না দেখুন। দ্রুত লুপে একের পর এক নতুন অর্ডার পাঠাবেন না।

দীর্ঘমেয়াদি নাইজেরিয়ান লাইন, বিলিং ও স্যান্ডবক্সের কী অবস্থা?

OTP Route-এ নাইজেরিয়ার জন্য নিজে কিনে নেওয়ার মতো দীর্ঘমেয়াদি নম্বর নেই। Dedicated Number শুধু যুক্তরাষ্ট্র ও কানাডার জন্য বিক্রি হয়, মাসে $1.95 থেকে। স্থায়ী +234 লাইন দরকার হলে [email protected]এ ইমেইল করুন; তা দেওয়া সম্ভব কি না স্থানীয় নিয়মকানুনের ওপর নির্ভর করে।

খরচ কাটা হয় একটিমাত্র প্রিপেইড USD ওয়ালেট থেকে, কোনো প্ল্যান বা মাসিক ফি নেই। কার্ড বা USDT/USDC দিয়ে টপ-আপ করুন এবং প্রতিটি টপ-আপের জন্য PDF ইনভয়েস পান। সাপোর্টকে বলে একটি ডেভেলপমেন্ট অ্যাকাউন্ট স্যান্ডবক্স মোডে নিন; তখন আপনার ইন্টিগ্রেশন সিমুলেটেড নম্বর ও কোড পাবে, ফলে ওয়ালেটের টাকা খরচ না করেই পুরো ওয়েবহুক পথ টেস্ট করতে পারবেন।

সাধারণ জিজ্ঞাসা

স্থানীয় সিম ছাড়া কি আমার অ্যাপের নাইজেরিয়ান সাইন-আপ ফ্লো টেস্ট করা যায়?

হ্যাঁ। OTP Gateway থেকে একটি +234 নম্বর অর্ডার করুন এবং কোডটি ড্যাশবোর্ডে বা API দিয়ে পড়ুন।

OTP Route API-তে নাইজেরিয়ার country id কী?

প্রাইস লুকআপ ও অ্যাক্টিভেশন রিকোয়েস্টে country মান হিসেবে ng ব্যবহার করুন।

নাইজেরিয়া SMS OTP পেতে কত খরচ হয়?

প্রতি কোড $0.20 থেকে; সঠিক অঙ্ক সার্ভিসের ওপর নির্ভর করে এবং prices এন্ডপয়েন্ট তা ফেরত দেয়।

SMS না এলে কি আমাকে টাকা দিতে হয়?

না। 20 মিনিটের মধ্যে কিছু না এলে, বা আপনি বাতিল করলে, পুরো অঙ্ক ওয়ালেটে ফেরত যায়।

0803 123 4567-এর মতো নম্বর কীভাবে সংরক্ষণ করব?

শুরুর শূন্য বাদ দিয়ে স্পেস ছাড়া E.164 রূপে +2348031234567 হিসেবে সংরক্ষণ করুন।

যেকোনো অ্যাকাউন্টের জন্য কি এই নম্বর ব্যবহার করা চলে?

শুধু আপনার নিজের বৈধ প্রোডাক্ট ও অ্যাকাউন্টের জন্য। প্রতিটি সার্ভিসের শর্তাবলি এবং OTP Route-এর Acceptable Use Policy মেনে চলুন; কিছু সার্ভিস ভার্চুয়াল নম্বর সরাসরি প্রত্যাখ্যান করে।

সার্ভিসের নামগুলো সংশ্লিষ্ট মালিকদের ট্রেডমার্ক। OTP Route তাদের সঙ্গে সম্পর্কিত নয়। নম্বর আইনসম্মতভাবে ব্যবহার করুন এবং প্রতিটি সার্ভিসের শর্ত ও আমাদের গ্রহণযোগ্য ব্যবহার নীতি মেনে চলুন।