الانتقال إلى المحتوى الرئيسي

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.

​
مقدمة

ادمج وظيفة شحن الهاتف المحمول للمشغلين الجزائريين (Mobilis وDjezzy وOoredoo وPixx) في 4 خطوات بسيطة. تشرح هذه النظرة العامة سير عمل التكامل - والتنفيذ التفصيلي مع أمثلة الكود بلغات Node.js وPython وPHP وcURL موجود في الأدلة التفصيلية أدناه.

​
كيف يعمل النظام

​
عملية التكامل في 4 خطوات

1

تحميل الخطط

احصل على خطط الشحن المتاحة بالأسعار وخزّنها في الكاش محلياً.→ انظر الخطوة 1: تحميل الخطط
2

التحقق من المدخلات

تحقق من أرقام الهواتف (10 أرقام، بادئة المشغل الصحيحة) والمبالغ قبل الإرسال.→ انظر الخطوة 2: التحقق
3

إرسال الشحن

أرسل طلب الشحن بمرجع فريد للتتبع.→ انظر الخطوة 3: إرسال عمليات الشحن
4

تتبع الحالة

تحقق من حالة الطلب كل 5–10 ثوانٍ حتى يكتمل (FULFILLED أو REFUNDED أو UNKNOWN_ERROR).→ انظر الخطوة 4: تتبع الحالة

​
ما تحتاج معرفته

​
أنواع الخطط

تدعم API 3 أنواع من الخطط:
  • الخطط الديناميكية: مبالغ مرنة (مثل 50–5000 دينار لـ Djezzy مسبق الدفع)
  • الخطط الثابتة: مبالغ محددة (مثل Pixx 500 دينار)
  • خطط GetMenu: تجلب عروضاً مخصصة لرقم هاتف معين
→ مزيد من المعلومات في الخطوة 1

​
حالات الطلب

تتقدم الطلبات عبر هذه الحالات:
  • PENDING / HANDLING → استمر في التحقق
  • FULFILLED → نجاح! ✅
  • REFUNDED → فشل، تم الاسترداد ❌
  • UNKNOWN_ERROR → انتظر 24 ساعة قبل الاسترداد ⚠️
→ معالجة الحالات التفصيلية في الخطوة 4

​
صيغة رقم الهاتف

يجب أن تتكون أرقام الهواتف من 10 أرقام: 0[567][0-9]{8}
  • Mobilis: 06...
  • Djezzy: 07...
  • Ooredoo: 05...
→ كود التحقق في الخطوة 2

​
التسعير

تُعيد API أسعار الجملة. طبّق هامشك الربحي قبل عرضها للعملاء.مثال: cost: 0.98 لـ 1000 دينار → تدفع 980 دينار → تبيع بـ 1029 دينار (هامش 5%) → الربح: 49 دينار→ استراتيجيات التسعير في الخطوة 1

​
النقاط الأساسية

ولّد ref فريداً لكل طلب لمنع التكرار وتمكين التتبع.→ التنفيذ في الخطوة 3
نادراً ما تتغير الخطط. خزّنها في الكاش لتقليل استدعاءات API وتحسين السرعة.→ استراتيجية الكاش في الخطوة 1
لا تسترد المبلغ فوراً! انتظر حتى 24 ساعة حتى تُحسم الحالة.→ معالجة الأخطاء في الخطوة 4
اعرض حقل refund_message (بالعربية) للعملاء - يشرح ما حدث.→ معالجة الرسائل في الخطوة 4

​
مرجع API

للمواصفات الكاملة للـ endpoints:

سرد خطط الهاتف المحمول

GET /v3/mobile/plans

إرسال شحن

POST /v3/mobile/send

التحقق بالمرجع

GET /v3/mobile/check-ref/:ref

التحقق بالمعرّف

GET /v3/mobile/check-id/:id

​
الاختبار

استخدم وضع sandbox للاختبار بدون أموال حقيقية. اختبر بهذه الأرقام الخاصة:
  • أرقام عادية → سير نجاح
  • 0600000001 → سيناريو الاسترداد
  • 0600000002 → عروض مقترحة
  • 0600000003 → خطأ غير معروف
فعّل sandbox في إعدادات لوحة التحكم.

​
بدء التكامل

ابدأ بالخطوة 1: تحميل الخطط

ابدأ بتحميل وتخزين خطط الهاتف المحمول في الكاش مع أمثلة الكود

​
موارد إضافية

دليل البدء السريع

ابدأ في 5 دقائق

المصادقة

تعلّم كيفية مصادقة الطلبات

أفضل ممارسات الأمان

أمّن تكاملك

استراتيجيات Polling

حسّن التحقق من الحالة

Webhooks

إشعارات الحالة الفورية

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

احصل على مساعدة فريقنا