استقبال رموز OTP لنيبال: التحضير والخطوات والحلول لاختبارات +977

قبل البدء: ما الذي تحتاج إلى تجهيزه قبل طلب رقم نيبالي؟

تُوفر جولة تحضير قصيرة كثيرًا من الحيرة في تصحيح الأخطاء لاحقًا. قبل أول طلب تأكد من أن لديك:

1. بيانات الاعتماد. أنشئ مفتاح or_live_ في وحدة تحكم المطورين وأرسله كرمز Bearer. تجعل المفاتيح المنفصلة للتطوير المحلي وCI وأدوات الإنتاج تدويرها سهلًا.
2. معرّفا الدولة والخدمة. معرّف نيبال هو np؛ ابحث عن معرّف الخدمة عبر GET /api/v1/services.
3. رصيد أو sandbox. افحص GET /api/v1/balance، أو اطلب نقل حساب التطوير إلى sandbox لتختبر أرقام ورموز محاكاة التكامل مجانًا.
4. خيار التسليم. قرّر بين نقطة webhook والاستعلام الدوري قبل أن تكتب حزمة الاختبار، لا في منتصفها.
5. عرض صندوق وارد يدعم Unicode. تصل الرموز من القوالب النيبالية بالديفاناغاري، وينبغي أن تعرضها سجلاتك بصورة صحيحة.

إن كان هذا النموذج جديدًا عليك فإن ما هي بوابة OTP يقدم الخلفية في دقائق.

أي التطبيقات تستطيع تسليم رموز إلى خط +977؟

يمكن حاليًا توجيه أكثر من 1,700 خدمة إلى نيبال. ومن الشائعة Viber وWhatsApp وFacebook وInstagram وTikTok وTelegram وGoogle (Gmail & YouTube) وMicrosoft & Outlook وDiscord وSignal وimo وAmazon وClaude.

هذه القائمة لقطة وليست وعدًا. يتغير التوفر خلال اليوم، ولهذا يعيد GET /api/v1/prices?country=np&service=<id> السعر والتوفر الحيين للزوج الذي يحتاجه اختبارك بالتحديد.

خطوة بخطوة: استقبال رمز OTP لنيبال عبر API

بعد اكتمال قائمة التحضير، يتطلب تدفق API لـ OTP في نيبال خمسة استدعاءات على الأكثر:

1. أكّد السعر الحي لـ np وخدمتك.
2. أنشئ التفعيل عبر POST /api/v1/activations بالجسم {"service": "<id>", "country": "np"}. احتفظ بمعرّف التفعيل المُعاد؛ فهو مفتاح كل ما يلي.
3. أدخل رقم +977 في التدفق قيد الاختبار وفعّل إرسال الرسالة.
4. اجمع الرمز من webhook الحدث activation.sms_received، أو استعلم دوريًا عن GET /api/v1/activations/{id} بفاصل معقول بين الاستدعاءات.
5. ألغِ عبر POST /api/v1/activations/{id}/cancel إذا توقف الاختبار مبكرًا.

من جهة webhook، تحقق من X-OTPRoute-Signature قبل الوثوق بالطلب: ابنِ <t>.<raw body> ووقّعه بـ HMAC-SHA256 باستخدام سر نقطة النهاية، وقارنه بقيمة v1، وارفض الطوابع القديمة. ثم نفّذ upsert بمعرّف التفعيل كي لا يضر الحدث المعاد إرساله. يعرض التقاط OTP عبر webhook النمط الكامل.

تفضّل النقر على البرمجة؟ في لوحة تحكم OTP Route اختر نيبال ثم الخدمة، واقبل السعر المعروض فيظهر الرقم مع مؤقت؛ ويظهر الرمز على الشاشة نفسها.

فحوص التنسيق لأرقام الجوال النيبالية

أرقام الجوال النيبالية من عشرة أرقام وتبدأ بالرقم 9، وغالبًا 98 أو 97. داخل البلد تُطلب أرقام الهاتف الأرضي ببادئة الخط الرئيسي 0 مع رمز المنطقة، لكن هذا الصفر لا مكان له في الصيغة الدولية. لذا ينبغي أن يبدو سجل الاختبار هكذا +97798xxxxxxxx.

أمور تستحق أن تؤكدها في اختبارات التحقق لديك:

• المستخدم الذي يكتب الرقم بصفر في البداية ينتهي برقم بعد حذف الصفر خلف +977.
• يُقبل رقم الجوال ذو الأرقام العشرة دون أي بادئة ويُوحَّد إلى E.164.
• تُنظَّف المسافات والشرطات التي يلصقها المستخدمون من بطاقات الاتصال قبل التخزين.

ويستحق محتوى SMS فحصًا أيضًا. تُكتب النيبالية بالديفاناغاري، وتُرسل رسالة الديفاناغاري بترميز Unicode الذي يتيح أحرفًا أقل بكثير في كل جزء من النص اللاتيني العادي. إن كان قالب التحقق لديك مُوطَّنًا فتأكد من أن الرمز ما زال يصل في جزء واحد وأن الكلمات المحيطة لا تدفعه إلى الانقسام. وكثير من الخدمات ترسل ببساطة قوالب إنجليزية، فاختبر الحالتين.

لماذا تبني الفرق وتختبر لسوق نيبال

تهم نيبال منتجات أكثر مما يوحي حجمها. فجزء كبير من العمال النيباليين يعيش في الخارج، ولذلك تحتاج منتجات التحويلات والمحافظ والمراسلة التي تخدم الخليج وماليزيا وممرات أخرى إلى التحقق من مستخدمين ما زالوا يحتفظون برقم +977. وتطبيقات المراسلة مثل Viber وWhatsApp جزء من التواصل اليومي هناك.

تطلب الفرق رقم +977 للاختبار حين:

• تطلق تدفق تسجيل للمستخدمين النيباليين وتحتاج إلى إثبات ظهور الدولة في المنتقي بالقناع الصحيح.
• تفحص النصوص النيبالية في شاشات التهيئة والاسترداد.
• تعيد إنتاج بلاغ عميل مغترب بأن رمز الدخول لم يصل أبدًا.

توضح صفحة التحقق في تطبيقات الجوال كيف تنظم فرق التطبيقات هذا النوع من تغطية الدول.

استكشاف الأخطاء: الرمز لم يصل

للرموز المفقودة بضعة أسباب معتادة، وقلّما يكون الحل بالطلب مجددًا فورًا.

• الصبر أولًا. امنح التفعيل مهلته الكاملة البالغة 20 دقيقة؛ فالرسائل المتأخرة في الطابور تصل فعلًا أحيانًا.
• سياسات الأرقام الافتراضية. ترفض بعض الخدمات الأرقام الافتراضية. وحينها تنتهي مهلة التفعيل ببساطة ويصل الاسترداد إلى المحفظة.
• اختيار المسار. جرّب لاحقًا، أو استخدم مسارًا مختلفًا للخدمة نفسها بدل الإلحاح على مسار واحد.
• انضباط المعدل. إعادة الطلب في حلقة سريعة تستهلك حد 300 طلب في الدقيقة وقلّما تفيد.
• تطبيقك أنت. تأكد أن طلب الرسالة أُرسل فعلًا؛ افحص الطلب الصادر في سجلاتك.

الحدث activation.expired هو الإشارة الواضحة إلى أن شيئًا لم يصل ولم يُخصم شيء.

الخطوط طويلة الأمد والدفع لمسارات نيبال

لا يقدم OTP Route رقمًا نيباليًا طويل الأمد بالخدمة الذاتية. الأرقام المخصصة (Dedicated Numbers) موجودة في الولايات المتحدة وكندا فقط، بدءًا من $1.95/month. وإن كان فريقك يحتاج خط +977 دائمًا فراسل [email protected]؛ وما يمكن ترتيبه يعتمد على القواعد المحلية، ولا شيء مضمون.

الدفع حسب الاستخدام من محفظة واحدة مسبقة الدفع بالدولار، تُشحن بالبطاقة أو بعملتي USDT أو USDC، مع فاتورة PDF تصلك بالبريد عن كل عملية شحن ودون رسوم شهرية. راجع الأسعار لمعرفة كيف تُعرض الرسوم، وسجّل لإنشاء حساب برمز بريد إلكتروني أو عبر Google.

الأسئلة الشائعة

هل أستطيع استقبال رمز OTP نيبالي دون شريحة نيبالية؟

نعم. تصدر OTP Gateway رقم +977 لعملية تحقق واحدة، وتقرأ الرمز في لوحة التحكم أو عبر API.

ما رمز الدولة الذي تتوقعه API لنيبال؟

أرسل np كدولة في طلبات الأسعار والتفعيل.

هل أحتفظ بالصفر في البداية عند تخزين رقم نيبالي؟

لا. احذف صفر الخط الرئيسي وخزّن الرقم بصيغة E.164 بعد +977.

هل ستظهر الرموز المكتوبة بالنيبالية بصورة صحيحة في لوحة التحكم؟

تُعرض الرسالة كما وصلت؛ تأكد من أن سجلاتك وتأكيدات الاختبار تتعامل مع نص الديفاناغاري كي يمكن استخراج الرمز بموثوقية.

ماذا يحدث لأموالي إذا لم يصل رمز نيبال أبدًا؟

لا يُخصم شيء: التفعيل الذي لا يرى أي رسالة خلال 20 دقيقة، أو الذي تلغيه، يُسترد كاملًا إلى المحفظة دون أي طلب منك.

هل أستطيع استخدام رقم +977 نفسه لتسجيل دخول لاحق؟

لا، فكل رقم من OTP Gateway يغطي رمزًا واحدًا. أما الحسابات التي يجب أن تسجل الدخول مجددًا لاحقًا فيناسبها رقم مخصص (Dedicated Number)، لكنه متاح في الولايات المتحدة وكندا فقط.

هل توجد قواعد استخدام لأرقام التحقق في نيبال؟

نعم. احترم شروط كل خدمة وسياسة الاستخدام المقبول، واستخدم الأرقام فقط لاختبار منتجاتك وحساباتك المشروعة أو تشغيلها.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.