کیمین جزائر کے verification نمبرز کے لیے Pre-Flight چیک لسٹ

Pre-flight چیک لسٹ: +1 345 نمبر آرڈر کرنے سے پہلے کیا تیار ہونا چاہیے؟

یہ فہرست ایک بار دیکھ لیں تو پہلی کیمین activation عموماً بے مسئلہ گزرتی ہے:

• اکاؤنٹ اور سیکیورٹی۔ ای میل ایڈریس اور 6 ہندسوں کے ای میل کوڈ (یا Google سائن ان) سے سائن اپ کریں، پھر ہر اس شخص کے لیے TOTP two-factor آن کریں جو والیٹ سے خرچ کر سکتا ہے۔
• والیٹ میں فنڈز۔ prepaid USD والیٹ کو کارڈ یا USDT/USDC سے ٹاپ اپ کریں۔ چننے کے لیے کوئی پلان نہیں اور ماہانہ فیس نہیں۔
• API key۔ Developer console میں key بنائیں؛ یہ or_live_ سے شروع ہوتی ہے اور Bearer header میں جاتی ہے۔ ایک اکاؤنٹ 10 keys تک رکھ سکتا ہے۔
• Webhook endpoint۔ ایک URL رجسٹر کریں اور اس کا secret ایسی جگہ رکھیں جہاں آپ کا handler اسے پڑھ سکے۔ فی اکاؤنٹ زیادہ سے زیادہ پانچ endpoints۔
• فون parsing کی ترتیب۔ یقینی بنائیں کہ آپ کی نمبر لائبریری area code 345 کو کیمین جزائر سے جوڑتی ہے، نہ کہ ہر +1 نمبر کو ڈیفالٹ طور پر امریکہ سمجھتی ہے۔
• Sandbox، اگر ڈرائی رن چاہیے۔ سپورٹ سے کہیں کہ ڈیولپمنٹ اکاؤنٹ کو sandbox موڈ پر کر دے تاکہ simulated نمبر اور کوڈ والیٹ کے فنڈز کو چھوئے بغیر آپ کے انٹیگریشن کو چلائیں۔

جوابات میں نظر آنے والی ہر field API ریفرنس میں درج ہے۔

+1 کو امریکہ سمجھنے والا کوڈ کیمین نمبر پر کیوں اٹک جاتا ہے؟

کیمین جزائر North American Numbering Plan کے اندر ہیں، اس لیے ملک کوڈ 1 امریکہ، کینیڈا اور بہت سے کیریبین علاقوں کے ساتھ مشترک ہے۔ کیمین لائن کو جو چیز پہچانتی ہے وہ area code 345 ہے۔ مکمل نمبر ملک کوڈ کے بعد دس ہندسوں کا ہوتا ہے، مقامی طور پر (345) NXX-XXXX لکھا جاتا ہے اور E.164 میں +1345 اور اس کے بعد سات ہندسے کے طور پر محفوظ ہوتا ہے۔

انجینئرز کے لیے تین عملی نتائج:

• خطے کی شناخت کو area code دیکھنا چاہیے۔ جو سائن اپ فارم صرف +1 prefix سے ملک کا اندازہ لگاتا ہے وہ کیمین صارف کو امریکی بتا دے گا اور غلط ٹائم زون، کرنسی یا consent متن چن سکتا ہے۔
• NANP میں ابتدائی 1 لمبی دوری کے trunk ہندسے کا کام بھی کرتا ہے، اس لیے صارفین کبھی 1 345... یا صرف 345... لکھ دیتے ہیں۔ محفوظ کرنے سے پہلے تینوں کو E.164 string میں normalize کریں۔
• نمبر بغیر خالی جگہوں، ڈیش یا قوسین کے محفوظ کریں اور فارمیٹ صرف دکھاتے وقت کریں۔

انگریزی سرکاری زبان ہے، اس لیے اس مارکیٹ کے کوڈ عموماً انگریزی میں آتے ہیں۔ البتہ درست الفاظ وہ سروس طے کرتی ہے جو پیغام بھیجتی ہے، روٹ نہیں۔

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

ملک ky کے لائیو snapshot میں اس وقت WhatsApp، Telegram، Google (Gmail & YouTube)، Microsoft & Outlook، LinkedIn، Amazon، Airbnb، Uber، Signal، Discord، ChatGPT (OpenAI)، Netflix اور eBay شامل ہیں۔ طویل فہرست کو گنیں تو یہ روٹ 600 سے زیادہ سروسز کو کور کرتا ہے، اور فہرست دن بھر بدلتی رہتی ہے، اسی لیے دستیابی ہمیشہ API سے پڑھی جاتی ہے، hard-code نہیں کی جاتی۔

ٹیموں کو ٹیسٹنگ کے لیے +1 345 نمبر عموماً اس لیے چاہیے ہوتا ہے کہ یہ جزائر ایک بڑا offshore مالیاتی مرکز اور مصروف سیاحتی مقام ہیں۔ فنڈ ایڈمنسٹریٹرز، انشورنس کمپنیاں، ٹریول پلیٹ فارمز اور پراپرٹی کاروبار مقامی صارفین کو آن بورڈ کرتے ہیں، اور ان کی پروڈکٹ ٹیمیں دیکھنا چاہتی ہیں کہ سائن اپ فلو ویسے ہی کام کرے جیسے کیمین کا رہائشی اسے محسوس کرے گا۔ fintech آن بورڈنگ کے نوٹس اس طریقے کو مزید تفصیل سے بتاتے ہیں۔

مرحلہ وار: کیمین جزائر OTP API کی کال ترتیب کیسے چلتی ہے؟

تمام کالز آپ کی Bearer key کے ساتھ https://otproute.com/api/v1 پر جاتی ہیں، 300 requests فی منٹ کی حد کے اندر۔

1. GET /api/v1/services ایک بار کال کریں اور اپنے ٹیسٹ سوٹ کو درکار service ids cache کر لیں۔
2. لائیو قیمت پڑھنے اور یہ تصدیق کرنے کے لیے کہ جوڑی اس وقت دستیاب ہے، GET /api/v1/prices?country=ky&service=<id> کال کریں۔
3. {"service": "<id>", "country": "ky"} جیسی body کے ساتھ POST /api/v1/activations بھیجیں۔ جواب میں activation id اور +1 345 نمبر ملتا ہے۔
4. وہ نمبر زیرِ ٹیسٹ ایپ میں درج کریں اور اس کا SMS مرحلہ چلائیں۔
5. اپنے webhook پر activation.sms_received کا انتظار کریں۔ پہلے X-OTPRoute-Signature header چیک کریں: endpoint secret کے ساتھ <t>.<raw body> پر HMAC-SHA256 نکالیں، اسے v1 سے ملائیں، اور پرانے timestamp رد کر دیں۔
6. webhook نہ ہو تو معقول وقفے سے GET /api/v1/activations/{id} پول کریں جب تک کوڈ نہ آ جائے یا ونڈو بند نہ ہو جائے۔
7. اگر ٹیسٹ ادھورا رہ جائے تو POST /api/v1/activations/{id}/cancel کال کریں تاکہ روکی گئی رقم والیٹ میں لوٹ آئے۔

HMAC webhook گائیڈ signature چیکس کو لائن بہ لائن سمجھاتی ہے۔

ڈیش بورڈ پسند کرنے والے ساتھیوں کے لیے مرحلہ وار طریقہ

سپورٹ اسٹاف اور اکاؤنٹ مینیجرز کو API کو چھونے کی ضرورت ہی نہیں:

1. ڈیش بورڈ میں OTP Gateway کا صفحہ کھولیں۔
2. ملک کے طور پر کیمین جزائر چنیں، پھر وہ سروس جسے آپ verify کر رہے ہیں۔
3. آرڈر سے پہلے دکھائی گئی قیمت دیکھیں اور تصدیق کریں۔
4. نمبر ایپ میں کاپی کریں، کوڈ منگوائیں، اور activation کا صفحہ کھلا رکھیں؛ SMS آتے ہی وہیں ظاہر ہو جاتا ہے۔

20 منٹ کی ونڈو اور ریفنڈ بالکل ویسے ہی لاگو ہوتے ہیں جیسے API کے ذریعے۔

مسئلہ حل: اگر +1 345 نمبر پر کوڈ نہ پہنچے تو کیا کریں؟

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

• ونڈو چلنے دیں۔ ڈیلیوری کا وقت سروس اور روٹ پر منحصر ہے، اس لیے دیر سے آنے والا کوڈ لازماً ناکام نہیں ہوتا۔
• سروس کی پالیسی دیکھیں۔ کچھ سروسز virtual نمبرز کو سرے سے رد کرتی ہیں، اور ریفنڈ ٹھیک اسی صورت کے لیے ہے۔
• بعد میں دوبارہ کوشش کریں یا روٹ بدلیں۔ انوینٹری دن بھر بدلتی ہے؛ ایک گھنٹے بعد دوسری کوشش، یا کیریبین کا کوئی پڑوسی ملک، مختلف نتیجہ دے سکتا ہے۔
• تیز لوپس سے بچیں۔ جو اسکرپٹ ہر چند سیکنڈ بعد منسوخ کر کے دوبارہ آرڈر دیتی ہے وہ آپ کی rate limit ضائع کرتی ہے اور شاذ و نادر ہی مدد کرتی ہے۔

ناکام ڈیلیوری کا playbook میں مزید تشخیصی طریقے ہیں۔ ہر نمبر صرف اپنی پروڈکٹ یا اپنے بزنس اکاؤنٹس کے لیے استعمال کریں، ہر سروس کی شرائط پر عمل کریں، اور یاد رکھیں کہ OTP Route کی Acceptable Use Policy لاگو ہوتی ہے۔

کیا میں کیمین لائن طویل مدت کے لیے رکھ سکتا ہوں، اور بلنگ کیسے ہوتی ہے؟

کیمین جزائر کے لیے کوئی self-serve طویل مدتی نمبر موجود نہیں۔ +1 ملک کوڈ کا مشترک ہونا اسے نہیں بدلتا: Dedicated Numbers صرف امریکہ اور کینیڈا کی پروڈکٹ ہیں، $1.95/month سے، جن میں آنے والے SMS، جانے والے SMS اور براؤزر کالنگ شامل ہیں۔ اگر آپ کی ٹیم کو مستقل 345 لائن چاہیے تو [email protected] پر ای میل کریں؛ دستیابی مقامی قوانین پر منحصر ہے اور اس کا وعدہ نہیں کیا جاتا۔

باقی سب کچھ ایک ہی prepaid USD والیٹ پر چلتا ہے۔ کارڈ یا USDT/USDC سے ہونے والے ہر ٹاپ اپ پر ای میل سے PDF انوائس ملتی ہے، اور قیمتوں کا صفحہ pay-as-you-go ماڈل کی وضاحت کرتا ہے۔

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

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

جی ہاں۔ OTP Gateway سے +1 345 نمبر آرڈر کریں، اسے اپنی ایپ میں درج کریں اور کوڈ ڈیش بورڈ یا API میں پڑھ لیں۔ آپ $0.20 فی کوڈ سے ادائیگی کرتے ہیں اور صرف تب جب کوڈ پہنچے۔

API کیمین جزائر کے لیے کون سا country id استعمال کرتی ہے؟

id ky ہے۔ GET /api/v1/prices یا POST /api/v1/activations کال کرتے وقت اسے country کی قدر کے طور پر دیں۔

اپنے ڈیٹا بیس میں کیمین فون نمبر کیسے محفوظ کروں؟

اسے E.164 شکل میں محفوظ کریں: +1345 اور اس کے بعد سات ہندسوں کا subscriber نمبر، بغیر خالی جگہ یا اوقاف کے۔ علاقے کی شناخت +1 prefix کے بجائے 345 area code سے کریں۔

کیا Dedicated Numbers کے لیے +1 345 نمبر امریکی نمبر شمار ہوتا ہے؟

نہیں۔ Dedicated Numbers صرف امریکہ اور کینیڈا کے لیے بکتے ہیں، اس لیے کیمین لائن صرف ایک کوڈ والی OTP Gateway activation کے طور پر دستیاب ہے۔

اگر SMS کبھی نہ آئے تو میرے پیسوں کا کیا ہوتا ہے؟

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

کیا میں والیٹ کے فنڈز خرچ کیے بغیر CI میں کیمین OTP ٹیسٹ چلا سکتا ہوں؟

سپورٹ سے کہیں کہ ڈیولپمنٹ اکاؤنٹ کو sandbox پر منتقل کرے۔ یہ simulated نمبر اور کوڈ واپس کرتا ہے، اس لیے آپ کی pipeline مکمل activation اور webhook فلو بغیر کسی خرچ کے چلا سکتی ہے۔

OTP Route کیمین جزائر کی کتنی سروسز کور کرتا ہے؟

تازہ ترین snapshot کے وقت 600 سے زیادہ۔ چونکہ انوینٹری دن بھر بدلتی ہے، لائیو دستیابی کے لیے GET /api/v1/services اور prices endpoint سے پوچھیں۔

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