کیپ ورڈی (+238) کے تصدیقی کوڈ اپنے ٹیسٹ اسٹیک میں لانا

+238 activation کن endpoints کو چھوتی ہے؟

کیپ ورڈی کے OTP API انٹیگریشن کو https://otproute.com/api/v1 کے تحت صرف چند کالز کی ضرورت ہوتی ہے۔ ہر درخواست or_live_ سے شروع ہونے والی Bearer key کے ساتھ جاتی ہے جو Developer console میں بنتی ہے۔ Cabo Verde کا country id cv ہے؛ service id اس ایپ کی api_service قدر ہے جسے آپ ٹیسٹ کر رہے ہیں۔

1. GET /api/v1/services اور GET /api/v1/countries کیٹلاگ لاتے ہیں؛ انہیں دن بھر کے لیے cache کر لیں۔
2. GET /api/v1/prices?country=cv&service=<id> موجودہ قیمت پڑھتا ہے اور بتاتا ہے کہ روٹ اس وقت کھلا ہے یا نہیں۔ انوینٹری دن میں بدلتی ہے، اس لیے ہر آرڈر سے پہلے اسے پوچھیں، کچھ بھی hard-code نہ کریں۔
3. {"service": "whatsapp", "country": "cv"} کے ساتھ POST /api/v1/activations activation id اور وہ +238 نمبر واپس کرتا ہے جو آپ کے سائن اپ فارم میں ڈالنا ہے۔
4. اگر آپ webhooks استعمال نہیں کر رہے تو GET /api/v1/activations/{id} سے کوڈ کے لیے پول کر سکتے ہیں۔
5. ٹیسٹ ادھورا چھوڑنا پڑے تو POST /api/v1/activations/{id}/cancel نمبر چھوڑ دیتا ہے، اور روکی گئی رقم والیٹ میں لوٹ آتی ہے۔

رن سے پہلے GET /api/v1/balance کی کال سوٹ کو بیچ راستے میں ناکام ہونے کے بجائے پہلے ہی رکنے دیتی ہے۔ حد فی اکاؤنٹ 300 requests فی منٹ ہے، اور API ریفرنس میں ہر field درج ہے۔

کیپ ورڈی کے کوڈ کے لیے signed webhook کیسے قبول کروں؟

ایک اسکرپٹ کے لیے polling ٹھیک ہے؛ جب کئی جابز متوازی چلیں تو webhook زیادہ صاف طریقہ ہے۔ Developer console میں ایک endpoint رجسٹر کریں (اکاؤنٹ میں پانچ ہو سکتے ہیں) اور activation.sms_received، activation.expired اور activation.cancelled کو subscribe کریں۔

ہر POST کے ساتھ X-OTPRoute-Signature header آتا ہے جس کی شکل t=<unix>,v1=<hex> ہے۔ <t>.<raw body> کی string دوبارہ بنائیں، اس endpoint کے secret سے HMAC-SHA256 کے ذریعے sign کریں، اور نتیجے کو v1 سے constant-time چیک کے ساتھ ملائیں۔ جس درخواست کا timestamp چند منٹ سے زیادہ پرانا ہو اسے رد کر دیں تاکہ پکڑی گئی درخواست دوبارہ نہ چلائی جا سکے۔ اس کے بعد اپنی پروسیسنگ activation id کی بنیاد پر کریں: اگر وہی event دو بار آئے تو دوسری کاپی سے کچھ نہ بدلے۔ ہمارا مضمون HMAC سے OTP webhooks کی حفاظت باریک نکات بیان کرتا ہے۔

آج کون سی ایپس کیپ ورڈی کے نمبر پر کوڈ بھیج سکتی ہیں؟

cv کا لائیو کیٹلاگ 800 سے زیادہ سروسز کو کور کرتا ہے۔ اس وقت کھلی مقبول سروسز میں WhatsApp، Facebook، Instagram، TikTok، Google (Gmail & YouTube)، Microsoft & Outlook، Amazon، Airbnb، Uber، Viber، Telegram اور Netflix شامل ہیں۔ اس فہرست کو snapshot سمجھیں: پارٹنر کی صلاحیت کے ساتھ روٹس کھلتے اور بند ہوتے ہیں، اور OTP routing کا مقصد یہی ہے کہ دستیابی کا وعدہ کرنے والے صفحے کے بجائے ایسی API ہو جو اسے real time میں بتائے۔

اگر ٹیم میں کوئی کوڈ نہیں لکھتا تو ڈیش بورڈ وہی کام کر دیتا ہے۔ سروس چنیں، Cabo Verde چنیں، اسکرین پر قیمت کی تصدیق کریں اور نمبر کاپی کریں۔ کوڈ آتے ہی activation کارڈ پر ظاہر ہو جاتا ہے۔

+238 نمبر محفوظ کرتے وقت کیسا نظر آتا ہے؟

کیپ ورڈی میں بند numbering plan ہے: سات ہندسوں کے قومی نمبر اور کوئی trunk prefix نہیں، اس لیے ہٹانے کے لیے کوئی ابتدائی صفر نہیں۔ E.164 میں نمبر بس +238 اور اس کے بعد وہ سات ہندسے ہوتا ہے۔ اس لیے normalisation آسان ہے، مگر مختصر لمبائی ان validators کو الجھا دیتی ہے جو فرض کرتے ہیں کہ ہر subscriber نمبر لمبا ہوتا ہے، اور یہی وجہ ہے کہ فارم بعض اوقات بالکل درست کیپ ورڈی اندراج رد کر دیتا ہے۔ E.164 string محفوظ کریں، UI میں جیسے چاہیں فارمیٹ کریں، اور اپنے فون فیلڈ کے unit tests میں +238 کا ایک کیس شامل کریں۔

پرتگالی سرکاری زبان ہے، جبکہ روزمرہ میں زیادہ تر لوگ کیپ ورڈین کریول بولتے ہیں، اس لیے دیکھ لیں کہ پرتگالی OTP ٹیمپلیٹ وہاں کے ہینڈ سیٹ پر کیسا دکھتا ہے۔ ٹیمیں عموماً +238 نمبر ٹیسٹنگ کے لیے diaspora کی وجہ سے لیتی ہیں: امریکہ، پرتگال اور یورپ کے دوسرے حصوں میں بسی کیپ ورڈین برادریاں اپنے اکاؤنٹس وطن کے نمبروں سے جوڑے رکھتی ہیں، اور remittance، سفر اور میسجنگ پروڈکٹس چاہتی ہیں کہ ان کے سائن اپس ٹھیک چلیں۔

اگر 20 منٹ میں SMS نہ آئے تو والیٹ کا کیا ہوتا ہے؟

ہر activation 20 منٹ کھلی رہتی ہے۔ اگر اس ونڈو میں کوڈ آ جائے تو چارج برقرار رہتا ہے؛ اگر ونڈو خالی بند ہو جائے، یا آپ پہلے منسوخ کر دیں، تو پوری رقم بغیر کسی سپورٹ ٹکٹ کے آپ کے والیٹ میں لوٹ آتی ہے۔ جب کچھ نہ آئے:

• ہر چند سیکنڈ بعد نیا آرڈر دینے کے بجائے ونڈو کو اپنا وقت پورا کرنے دیں؛ تیز retry لوپ صرف فنڈز روک دیتا ہے۔
• بعد میں دوبارہ کوشش کریں، یا اسی فلو کو کسی دوسرے سروس روٹ سے آزمائیں۔
• تصدیق کریں کہ ایپ virtual نمبر قبول بھی کرتی ہے؛ کچھ پالیسی کے تحت انہیں رد کرتی ہیں، اور ریفنڈ ٹھیک اسی صورت کے لیے ہے۔
• یقینی بنائیں کہ آپ کے فارم نے مکمل +238 نمبر جمع کرایا ہے، کٹا ہوا نہیں۔

تشخیص کی مزید تفصیل ناکام OTP ڈیلیوریز کم کرنے کی گائیڈ میں ہے۔

کیا میں بار بار لاگ ان کے لیے Cabo Verde کا نمبر رکھ سکتا ہوں؟

self-serve بنیاد پر نہیں۔ OTP Route کے Dedicated Numbers، یعنی آنے اور جانے والے SMS، براؤزر کالنگ اور webhook forwarding والی طویل مدتی لائنیں، امریکہ اور کینیڈا کی پروڈکٹ ہیں جو $1.95/month سے شروع ہوتی ہیں۔ +238 کی کوئی self-serve طویل مدتی لائن نہیں ہے۔ اگر آپ کی ٹیم کو واقعی اس کی ضرورت ہو تو [email protected] پر ای میل کریں؛ آیا اس کا انتظام ہو سکتا ہے یہ مقامی قوانین پر منحصر ہے اور یقینی نہیں۔ ایسے staging اکاؤنٹ کے لیے جسے بار بار سائن ان کرنا ہو، امریکی یا کینیڈین virtual number اکثر عملی حل ہوتا ہے۔

استعمال کی بلنگ کیسے ہوتی ہے اور لائیو جانے سے پہلے ٹیسٹ کیسے کریں؟

بلنگ ایک ہی prepaid USD والیٹ سے چلتی ہے، نہ ماہانہ فیس اور نہ کوئی پلان tier۔ کارڈ یا USDT/USDC stablecoins سے ٹاپ اپ کریں؛ ہر ٹاپ اپ پر ای میل سے PDF انوائس ملتی ہے، جو فنانس کی reconciliation آسان رکھتی ہے۔ production keys کے والیٹ کو چھونے سے پہلے اپنے ڈیولپمنٹ اکاؤنٹ کو sandbox پر منتقل کرنے کو کہیں: یہ simulated نمبر اور کوڈ واپس کرتا ہے، تاکہ آپ کے SMS verification API کلائنٹ کا آرڈر، webhook اور cancel والا راستہ CI میں بغیر کچھ خرچ کیے چل سکے۔ قیمتیں اور QA ٹیسٹنگ کا جائزہ دیکھیں۔ پورے دوران ہر سروس کی شرائط اور OTP Route کی Acceptable Use Policy پر عمل کریں۔

اکثر پوچھے گئے سوالات

کیا میں مقامی SIM کے بغیر اپنی ایپ کا Cabo Verde سائن اپ فلو ٹیسٹ کر سکتا ہوں؟

جی ہاں۔ OTP Gateway سے +238 نمبر آرڈر کریں، اسے اپنے سائن اپ فارم میں ڈالیں اور کوڈ ڈیش بورڈ، API یا webhook سے پڑھ لیں۔ ٹیم میں کسی کو جزائر پر ہونے کی ضرورت نہیں۔

OTP Route API میں Cabo Verde کا country id کیا ہے؟

یہ cv ہے۔ اسے POST /api/v1/activations اور prices کی query میں country کے طور پر دیں۔

کیا کیپ ورڈی کے نمبر سے پہلے 0 لگانا ضروری ہے؟

نہیں۔ Cabo Verde میں کوئی trunk prefix نہیں ہے، اس لیے بین الاقوامی شکل بس +238 اور اس کے بعد سات ہندسوں کا قومی نمبر ہے۔

Cabo Verde verification نمبر کی قیمت کتنی ہے؟

OTP Gateway کی قیمت $0.20 فی کوڈ سے شروع ہوتی ہے اور سروس کے مطابق بدلتی ہے؛ API اور ڈیش بورڈ آرڈر سے پہلے درست قیمت دکھاتے ہیں۔ چارج صرف تب ہوتا ہے جب کوڈ پہنچے۔

کیا ہر ایپ کیپ ورڈی کے virtual نمبر پر کوڈ بھیجے گی؟

نہیں۔ کچھ سروسز virtual نمبر رد کرتی ہیں، اور روٹس دن بھر بدلتے رہتے ہیں۔ اگر 20 منٹ میں کوئی کوڈ نہ آئے تو رقم والیٹ میں واپس کر دی جاتی ہے۔

کیا +238 انٹیگریشن کی جانچ کے لیے sandbox موجود ہے؟

جی ہاں، درخواست پر۔ ڈیولپمنٹ اکاؤنٹ کو sandbox موڈ پر منتقل کیا جا سکتا ہے، جو simulated نمبر اور کوڈ واپس کرتا ہے تاکہ والیٹ خرچ کیے بغیر انٹیگریشن شروع سے آخر تک چل سکے۔

سروسز کے نام اپنے اپنے مالکان کے ٹریڈ مارکس ہیں۔ OTP Route کا ان سے کوئی تعلق نہیں۔ نمبرز کو قانونی طور پر استعمال کریں اور ہر سروس کی شرائط اور ہماری قابلِ قبول استعمال کی پالیسی کی پابندی کریں۔