সৌদি লঞ্চের জন্য প্রোগ্রাম্যাটিকভাবে +966 ভেরিফিকেশন কোড গ্রহণ

API-তে একটি +966 অ্যাক্টিভেশন দেখতে কেমন?

কলগুলো দিয়েই শুরু করা যাক, কারণ এই পাতার অধিকাংশ পাঠক টেস্ট স্যুট বা অভ্যন্তরীণ টুলে SMS ভেরিফিকেশন API জুড়ছেন। সব এন্ডপয়েন্ট https://otproute.com/api/v1-এর অধীনে এবং Developer console-এ তৈরি or_live_ প্রিফিক্সের Bearer কী লাগে।

1. GET /api/v1/countries ও GET /api/v1/services থেকে id পাবেন। সৌদি আরব হলো sa।
2. GET /api/v1/prices?country=sa&service=<id> ওই জোড়ার লাইভ রেট দেয়; টেস্ট রানের পাশে এটি লগ করুন।
3. {"service": "<id>", "country": "sa"} সহ POST /api/v1/activations একটি অ্যাক্টিভেশন id ও একটি +966 নম্বর ফেরত দেয়।
4. আপনার টেস্ট নম্বরটি অ্যাপে বসায়, আর কোড আসে ইভেন্ট হিসেবে অথবা GET /api/v1/activations/{id}-এর মাধ্যমে।
5. টেস্ট ছেড়ে দিলে POST /api/v1/activations/{id}/cancel সেটি মুক্ত করে ওয়ালেটে টাকা ফেরত দেয়।

প্রি-ফ্লাইট চেক হিসেবে GET /api/v1/balance কাজের, যাতে রাতের জব রানের মাঝখানে না পড়ে শুরুতেই স্পষ্ট বার্তা দিয়ে ব্যর্থ হয়। পরিকল্পনায় রাখার সীমা: প্রতি অ্যাকাউন্টে 10টি কী, 5টি ওয়েবহুক এন্ডপয়েন্ট, প্রতি মিনিটে 300টি অনুরোধ।

আমাদের ওয়েবহুক রিসিভার সৌদি OTP ইভেন্ট কীভাবে সামলাবে?

একটি এন্ডপয়েন্ট রেজিস্টার করে activation.sms_received, activation.expired ও activation.cancelled-এ সাবস্ক্রাইব করুন। প্রতিটি অনুরোধে X-OTPRoute-Signature থাকে t=<unix>,v1=<hex> রূপে।

• সাইন করা স্ট্রিং <t>.<raw body> রূপে পুনর্গঠন করুন এবং ওই এন্ডপয়েন্টের সিক্রেট দিয়ে HMAC-SHA256 হিসাব করুন।
• v1-এর সঙ্গে constant-time ফাংশনে তুলনা করুন, আর যার টাইমস্ট্যাম্প বেশি পুরোনো তা প্রত্যাখ্যান করুন।
• প্রতিটি ইভেন্টকে অ্যাক্টিভেশন id-র ভিত্তিতে দেখুন, যাতে পুনর্বিতরণে কিছু দুবার আপডেট না হয়।
• দ্রুত 2xx দিয়ে উত্তর দিন এবং ধীর কাজ ব্যাকগ্রাউন্ড জবে করুন।

যেসব রানার ইনবাউন্ড কানেকশন নিতে পারে না তাদের জন্য পোলিং বৈধ বিকল্প হিসেবে থেকে যায়। আরও জানতে পড়ুন আমাদের লেখা ওয়েবহুক-ভিত্তিক OTP ক্যাপচার ও HMAC দিয়ে OTP ওয়েবহুক সুরক্ষিত করা।

প্রোডাক্ট টিম কেন +966 নম্বরে টেস্ট করে?

সৌদি আরব উপসাগরের বড় ডিজিটাল বাজারগুলোর একটি, আর টিমগুলো ব্যবহারিক কারণে এই পাতায় আসে: সৌদি বাসিন্দাদের জন্য অনবোর্ডিং তৈরি করা ফিনটেক, উপসাগরীয় বিক্রেতা যোগ করা মার্কেটপ্লেস, গ্রাহকের আঞ্চলিক সাইন-ইন যাচাই চাওয়া SaaS ভেন্ডর, কিংবা রিয়াদ বা জেদ্দা অফিসের বিজনেস অ্যাকাউন্ট সামলানো অপারেশন টিম। প্রতিটি ক্ষেত্রে কাউকে প্রমাণ করতে হয় যে একটি আসল সৌদি ভেরিফিকেশন নম্বরে ফ্লো কাজ করে, আর গেটওয়ের মাধ্যমে OTP রাউটিং ওই অঞ্চলে SIM কার্ড পাঠানোর ঝামেলা বাঁচায়। এই পরিস্থিতির আরও বিবরণ আছে ফিনটেক অনবোর্ডিং পাতায়।

সৌদি রুটে কোন সার্ভিসে কোড পাওয়া যায়?

সৌদি আরবের লাইভ স্ন্যাপশটে 1,000-এর বেশি সার্ভিস আছে। প্রায়ই ব্যবহৃত সার্ভিসের মধ্যে আছে Snapchat, WhatsApp, X (Twitter), Uber, TikTok, Instagram, Google (Gmail & YouTube), Telegram, Amazon, Microsoft & Outlook, LinkedIn, Discord ও Netflix। রাজ্যে Snapchat ও X-এর দর্শক বিশেষভাবে বড়, তাই লোকালাইজেশন চেকলিস্টে এ দুটি প্রায়ই থাকে। দিনের মধ্যে ইনভেন্টরি বদলায়, তাই রান করার সময় API কোয়েরি করুন।

+966 নম্বর কীভাবে ফরম্যাট করব এবং আরবি মেসেজ কীভাবে পার্স করব?

স্থানীয়ভাবে সৌদি মোবাইল নম্বর ট্রাঙ্ক 0 সহ লেখা হয়, সাধারণত 05 এবং তার পরে আটটি অঙ্ক। আন্তর্জাতিক রূপে ওই শূন্য বাদ যায়: +966 5 এবং বাকি আটটি অঙ্ক। এন্ট্রির সময়েই সবকিছু E.164-এ নরমালাইজ করুন, আর ব্যবহারকারী কান্ট্রি কোডের পরে শূন্য টাইপ করলে তা সরিয়ে দিন।

আরবি সরকারি ভাষা, তাই ভেরিফিকেশন টেক্সট আরবিতে, ইংরেজিতে বা দুটোতেই আসতে পারে। আরবি লেখা ডান থেকে বামে চলে, আর কিছু টেমপ্লেট পশ্চিমা সংখ্যার বদলে আরবি-ইন্ডিক অঙ্ক ব্যবহার করতে পারে। ম্যাচ করার আগে ওই অঙ্কগুলোকে ASCII-তে রূপান্তর করে এবং কাঁচা UTF-8 লগ করে এমন পার্সার এক ধরনের বিরক্তিকর ভুয়া ব্যর্থতা এড়ায়।

যাঁরা কোড লেখেন না তাঁদের জন্য কি ড্যাশবোর্ডের পথ আছে?

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

কোড না এলে কী হবে, আর দীর্ঘমেয়াদি লাইন ও বিলিং কেমন?

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

নিজে কিনে নেওয়ার মতো দীর্ঘমেয়াদি সৌদি নম্বর নেই। Dedicated Virtual Numbers শুধু যুক্তরাষ্ট্র ও কানাডায়, $1.95/month থেকে; দীর্ঘমেয়াদি +966 লাইনের জন্য [email protected]এ ইমেইল করুন, তবে মনে রাখবেন সম্ভব কি না তা স্থানীয় নিয়ম ঠিক করে।

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

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

API দিয়ে সৌদি SMS OTP কীভাবে পাব?

কান্ট্রি sa ও আপনার সার্ভিস id দিয়ে একটি অ্যাক্টিভেশন তৈরি করুন, তারপর activation.sms_received ওয়েবহুক থেকে বা অ্যাক্টিভেশন পোল করে কোড নিন।

কোড ব্যর্থ হলে কি টেস্টিংয়ের জন্য নেওয়া +966 নম্বরের বিল হয়?

না। কোড না এলে 20 মিনিটের উইন্ডো শেষ হলে বা আপনি বাতিল করলে পুরো টাকা ওয়ালেটে ফেরত যায়।

লোকাল SIM ছাড়া কি আমার অ্যাপের সৌদি সাইন-আপ ফ্লো টেস্ট করা যায়?

হ্যাঁ। OTP Gateway একটি কোডের জন্য একটি +966 নম্বর দেয়, যা আপনি অ্যাপে বসিয়ে ড্যাশবোর্ড বা API দিয়ে কোড পড়তে পারেন।

05XXXXXXXX আকারে লেখা সৌদি মোবাইল নম্বর কীভাবে সংরক্ষণ করব?

ট্রাঙ্ক শূন্য বাদ দিয়ে E.164-এ +966 5 এবং বাকি আটটি অঙ্ক হিসেবে সংরক্ষণ করুন।

পরবর্তী লগইনের জন্য কি একই সৌদি নম্বর রাখা যায়?

নিজে কিনে নেওয়ার পণ্য দিয়ে নয়, কারণ দীর্ঘমেয়াদি Dedicated Numbers শুধু যুক্তরাষ্ট্র ও কানাডার জন্য। সৌদি লাইন লাগলে টিমকে ইমেইল করুন, তবে তা দেওয়া যাবে এমন নিশ্চয়তা নেই।

আসল টাকা জড়ানোর আগে কি সৌদি ফ্লো মহড়া দেওয়া যায়?

হ্যাঁ। ওয়েবহুকসহ সিমুলেটেড নম্বর ও কোড পেতে ডেভেলপমেন্ট অ্যাকাউন্টে স্যান্ডবক্স মোডের অনুরোধ করুন।

OTP Route কোন ব্যবহার অনুমোদন করে?

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

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