حل المشاكل الشائعة

الطلبات لا تصل التطبيق

• تحقق من Integration Center → Health Monitor. لو يقول "No successful API requests yet"، الموقع لم يرسل أي طلب بعد.
• تأكد أن الـ API Key الصحيح ومضبوط على متغير بيئة (مش في الـ frontend).
• تأكد أن Branch ID صحيح ومُمَرَّر في هيدر X-OrderGer-Branch-ID.
• افتح API Logs (في حساب الأدمن) للبحث عن أخطاء 401 / 402 / 404 / 429.

الإنذار لا يعمل

• افتح التطبيق → Settings → Test Alarm. لو ما طلع صوت، اسمح للتطبيق بالإشعارات + رفع مستوى الصوت.
• على Android: امنح التطبيق إذن "Display over other apps" + "Run in background" + ضع البطارية على "No restrictions".
• تأكد أن جهازك نشط ومسجّل (Integration Center → Active Devices > 0).

WordPress / WooCommerce

• WooCommerce → OrderGer → اضغط "Test Connection". لو فشل، تحقق من API Key.
• اضغط "Send Test Order". لو لم يصل، تحقق من Health Monitor.
• لو الـ Webhook لا يحدّث حالة WooCommerce: تأكد أن الـ Webhook Secret في WooCommerce = الذي في OrderGer دقيقاً.

API Key Invalid

الموقع يرسل الطلبات باستخدام API Key غير صحيح. أنشئ مفتاحاً جديداً وحدّثه داخل موقعك، ثم عطّل القديم.

Insufficient Balance

الرصيد فارغ. الطلبات الجديدة موقوفة لحين شحن الرصيد. الطلبات التجريبية (test: true) ما زالت تعمل.

Webhook فشل

• تأكد أن رابط الـ Webhook يعمل ويرد HTTP 200 خلال 10 ثوانٍ.
• تأكد من التوقيع: X-OrderGer-Signature: sha256=<hex> مطابق لـ HMAC-SHA256 على البودي.
• راجع Webhook Logs لمعرفة آخر استجابة وسبب الفشل.
• استخدم زر "Retry" لإعادة المحاولة يدوياً.