مشاكل تسجيل الدخول ورمز التحقق OTP

ما الذي يعنيه الخطأ#

هناك نوعان من المشكلات: تسجيل جديد يطلب رمز تحقق OTP من 5 أرقام فلا يصل أو يُرفض، وتسجيل دخول يفشل برسالة تحدد السبب في معظم الحالات.

من تخصّه هذه المشكلة#

• التاجر الذي يسجّل من صفحة التسجيل في موقع شركة التوصيل: يصله الرمز برسالة SMS.
• صاحب الشركة الجديد الذي يسجّل من صفحة تسجيل الشركات في النطاق (الدومين) الرئيسي: يصله الرمز بالبريد الإلكتروني.
• التاجر المستقل المسجّل من صفحة الانضمام (Join) للتجار المستقلين لا يمرّ بخطوة OTP: يُنشأ حسابه مفعّلاً ويُسجَّل دخوله تلقائياً ثم يُوجَّه مباشرة إلى صفحة الباقات (بحد خمس عمليات تسجيل لكل عنوان IP في اليوم).
• كل مستخدم عند تسجيل الدخول، ومنهم موظفو الشركة والمناديب.

الأسباب المحتملة#

رمز التحقق OTP

• الرمز 5 أرقام بالضبط، وصالح 10 دقائق، ويُسمح معه بخمس محاولات خاطئة، ويُستعمل مرة واحدة. بعد انتهاء المدة أو استنفاد المحاولات يُرفض حتى الرمز الصحيح؛ اطلب رمزاً جديداً.
• مع رمز من 5 أرقام تعرض صفحة الويب «Invalid OTP» في كل الحالات (رمز خاطئ أو منتهٍ أو محاولات مستنفدة أو جلسة مفقودة)، وصفحة التحقق نفسها بالإنجليزية. أما أي طول آخر فتظهر رسالة الحقل القياسية تحت خانة OTP. وتعيد واجهة الجوال البرمجية الرسالة المترجمة («OTP غير صحيح» بالعربية) مع HTTP 401.
• صفحة التحقق تقرأ رقم الهاتف (أو البريد الإلكتروني عند الشركات) من الجلسة. فإذا فتحتها من متصفح آخر أو بعد انتهاء الجلسة رُفض الرمز.
• الرمز لا يصل: يُرسَل SMS عبر مزوّد REVE أو Twilio فقط، وبشرط تفعيل أحدهما في إعدادات الرسائل. وإن لم يكن أي منهما مفعّلاً لا يُرسَل شيء، ومع ذلك تقول الصفحة إن الرمز أُرسل. ورمز الشركات يُرسَل بالبريد الإلكتروني ويلزمه إعداد بريد يعمل؛ فإن فشل إرسال البريد أثناء التسجيل فشل التسجيل نفسه برسالة «Something went wrong.» (بالإنجليزية) دون الوصول إلى صفحة OTP. أما «Resend Code!» فقد يعرض رسالة نجاح حتى لو فشل الإرسال.
• «Resend Code!» يصدر رمزاً جديداً يُلغي السابق ويصفّر عداد المحاولات. وهو يعمل لحساب لم يُفعَّل بعد فقط. ولا يوجد في مسار الويب حد لعدد مرات الإعادة، أما واجهة الجوال البرمجية (/api/v10) فتسمح بـ 3 طلبات إعادة و10 طلبات تحقق في الدقيقة.

تسجيل الدخول

• لا تظهر تفاصيل الحساب (موقوف أو غير مفعّل أو تابع لشركة أخرى) إلا إذا كانت كلمة المرور صحيحة، وإلا تظهر الرسالة الأولى.
• يقبل حقل الدخول البريد الإلكتروني أو رقم الهاتف المحمول. وإذا دخلت من النطاق الرئيسي بكلمة مرور صحيحة نقلك النظام إلى نطاق شركتك برابط يُستخدم مرة واحدة ويبقى صالحاً دقيقتين.
• القفل المؤقت: في نطاق شركتك، 5 محاولات فاشلة بالبريد الإلكتروني أو رقم الهاتف نفسه ومن عنوان IP نفسه تمنع الدخول نحو دقيقة (HTTP 429). أما كلمة المرور الخاطئة لحساب معروف إذا كُتبت في النطاق الرئيسي أو في نطاق شركة أخرى فتُرفض دون أن تُحتسب.
• «نسيت كلمة السر؟» يرسل رابطاً بالبريد الإلكتروني. والتاجر الذي سجّل من نموذج موقع الشركة ليس لديه بريد مسجّل، فلا يصله الرابط.
• تظهر للمندوب عند تسجيل الدخول عبر واجهة الجوال البرمجية الرسالة «رقم الدخول (أو الموبايل) أو كلمة المرور غلط.» (HTTP 401) عند خطأ الرقم أو كلمة المرور، أو «حساب المندوب موقوف — تواصل مع شركتك.» (HTTP 403). وإذا نقص أحد الحقلين أو قصرت كلمة المرور عن 6 أحرف فيعيد النظام HTTP 422 مع الرسالة «أوراق الاعتماد غير متطابقة» (Credentials not match بالإنجليزية)، وإذا غابت الترويسة apiKey أو كانت خاطئة فيعيد HTTP 400 مع «Invalid Api Key». والحد 10 محاولات في الدقيقة.

كيف تشخّص المشكلة#

• طابق نص الرسالة مع الجدول أعلاه، ولا تكرّر المحاولة قبل أن تعرف السبب حتى لا تستنفد المحاولات.
• في صفحة OTP تحقق من الرقم المقنَّع المعروض؛ فإن ظهرت نجوم فقط بلا أرقام (ورقم التاجر فارغ) فالجلسة فُقدت.

خطوات الحل#

1. اطلب رمزاً جديداً

   اضغط «Resend Code!» وأدخل أحدث رمز خلال 10 دقائق وفي حدود 5 محاولات.

2. ابق في المتصفح نفسه

   أكمل التحقق من المتصفح الذي سجّلت منه ولا تغلق الصفحة. إذا فُقدت الجلسة فتواصل مع الدعم.

3. تأكد من مكان وصول الرمز

   للتاجر: رسالة SMS على رقم الهاتف المكتوب في التسجيل. ولصاحب الشركة: رسالة بريد إلى البريد الإلكتروني المكتوب. وإن لم يصل بعد إعادة الإرسال فالمشكلة في إعداد الإرسال ويعالجها الدعم.

4. ادخل من النطاق الصحيح

   ادخل من نطاق (دومين) شركتك، وهو الذي تذكره رسالة «تابع لشركة تانية». وعند القفل المؤقت انتظر دقيقة ثم أعد المحاولة.

5. عالج حالة الحساب وكلمة المرور

   إذا كان الحساب موقوفاً أو غير مفعّل فتواصل مع مدير شركتك. وإن نسيت كلمة المرور فاستخدم «نسيت كلمة السر؟»، أو اطلب من موظف يملك صلاحية تعديل التجار أن يضع لك كلمة مرور جديدة من صفحة تعديل التاجر.

متى تتواصل مع الدعم#

• لا يصل الرمز رغم إعادة الإرسال، أو فُقدت الجلسة قبل إكمال التحقق، أو فشل تسجيل شركة برسالة «Something went wrong.».
• تظهر «الحساب لم يُفعَّل بعد» بعد أن أكملت التحقق، أو «تعذّر تسجيل الدخول لهذا الحساب على هذا الدومين.» بكلمة مرور صحيحة.
• أرسل رقم الهاتف أو البريد الإلكتروني المسجّل (دون كلمة المرور) ووقت المحاولة ونص الرسالة كاملاً واسم نطاق شركتك.