Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
نظرة عامة
بعد إرسال طلب الشحن، استطلع endpoint الحالة حتى تصل المعاملة إلى حالة نهائية. تُعالج API الطلبات عادةً في غضون 5-30 ثانية، وتمر بالحالات PENDING → HANDLING → FULFILLED/REFUNDED.API التحقق بالمرجع
GET /v3/mobile/check-ref/:ref - التتبع باستخدام مرجعك
API التحقق بالمعرّف
GET /v3/mobile/check-id/:id - التتبع باستخدام معرّف الشحن
قيم الحالة
فهم كل حالة أمر بالغ الأهمية للتعامل الصحيح:راجع مرجع API التحقق بالمعرّف للاطلاع على أوصاف تفصيلية للحالات وحالات الاستخدام.
| الحالة | المعنى | المدة | الإجراء |
|---|---|---|---|
| PENDING | في قائمة الانتظار للمعالجة | 2-15 ثانية | استمر في الاستطلاع |
| HANDLING | قيد المعالجة | 3-8 ثواني | استمر في الاستطلاع |
| FULFILLED | اكتمل بنجاح ✅ | نهائي | ضع علامة مكتمل، أشعر المستخدم |
| REFUNDED | فشل وتم الاسترداد ❌ | نهائي | استرد المبلغ للمستخدم، اعرض الخطأ |
| UNKNOWN_ERROR | حالة غير مؤكدة ⚠️ | تُحسم خلال 1-24 ساعة | انتظر، لا تسترد المبلغ بعد |
التطبيق الأساسي للاستطلاع
التعامل مع حالات الحالة المختلفة
استطلاع الحالة في الخلفية
للحصول على أداء أفضل، استطلع الحالة في مهام الخلفية:إعادة الفحص المجدولة لـ UNKNOWN_ERROR
أنشئ مهمة cron يومية لإعادة فحص الطلبات غير المؤكدة:استراتيجية الاستطلاع المُحسَّنة
استخدم فترات استطلاع ذكية:أفضل الممارسات
لا تسترد UNKNOWN_ERROR فوراً
لا تسترد UNKNOWN_ERROR فوراً
انتظر حتى تُحسم الحالة إلى FULFILLED أو REFUNDED خلال 24 ساعة قبل معالجة الاستردادات.
استخدام مهام الخلفية
استخدام مهام الخلفية
استطلع الحالة بشكل غير متزامن لتجنب حجب طلبات المستخدمين وتحسين الأداء.
تطبيق حماية من انتهاء المهلة
تطبيق حماية من انتهاء المهلة
حدد حداً أقصى لمحاولات الاستطلاع (عادةً 60 = 5 دقائق) وأعد جدولة الفحوصات عند الحاجة.
تخزين الحالة في قاعدة البيانات
تخزين الحالة في قاعدة البيانات
احفظ الحالة في قاعدة بياناتك لتقليل استدعاءات API. استعلم API فقط عندما لا تكون الحالة نهائية.
عرض الرسائل باللغة العربية
عرض الرسائل باللغة العربية
اعرض دائماً
refund_message للمستخدمين كما هو. إنه باللغة العربية ويشرح المشكلة بوضوح.التعامل مع العروض المقترحة
التعامل مع العروض المقترحة
عند توفر
suggested_offers، اعرض هذه البدائل لتحسين معدل التحويل.الخطوات التالية
استراتيجيات الاستطلاع
تعلّم تقنيات تحسين الاستطلاع المتقدمة
Webhooks
إعداد إشعارات الحالة الفورية بدلاً من الاستطلاع
API قائمة الشحنات
اطلع على جميع معاملات الشحن الخاصة بك
معالجة الأخطاء
مرجع معالجة الأخطاء الكامل

