إرسال شحن الهاتف المحمول
شحن الهاتف
إرسال شحن الهاتف المحمول
إنشاء وإرسال طلب شحن هاتف محمول
POST
إرسال شحن الهاتف المحمول
نظرة عامة
إرسال شحن هاتف محمول فوري إلى جميع شبكات الهاتف الجزائرية (Mobilis وDjezzy وOoredoo وPixx) مع تتبع الحالة في الوقت الفعلي.متن الطلب
رمز الخطة من list-plans (مثلًا:
PREPAID_DJEZZY، MIX1000_OOREDOO)رقم الهاتف المحمول الجزائري بصيغة
0XXXXXXXXX (10 أرقام تبدأ بـ 05، 06، أو 07)مبلغ الشحن بالدينار الجزائري. مطلوب فقط للخطط الديناميكية (حيث
min_amount وmax_amount محددان). غير مطلوب للخطط الثابتة.مرجع داخلي فريد (معرّف طلبك). يُستخدم لمنع الطلبات المكررة والتحقق من الحالة لاحقًا.
استخدم
ref دائمًا إذا كنت ترسل طلبات من جانب الخادم. يمنع الخصم المزدوج إذا فشل طلب الشبكة.الاستجابة
يشير إلى نجاح الطلب
الأمثلة
خطة ديناميكية (يحدد المبلغ)
خطة ثابتة (لا مبلغ)
مثال على الاستجابة
استجابات الخطأ
400 - خطأ في التحقق
400 - خطأ في التحقق
400 - رقم هاتف غير صالح
400 - رقم هاتف غير صالح
403 - رصيد غير كافٍ
403 - رصيد غير كافٍ
403 - مرجع مكرر
403 - مرجع مكرر
إذا تلقيت هذا الخطأ، لا ترسل طلبًا جديدًا. بدلًا من ذلك، تحقق من حالة الطلب الموجود باستخدام
ref.500 - خطأ داخلي
500 - خطأ داخلي
منع الطلبات المكررة
يضمن حقل
ref معالجة الشحن مرة واحدة فقط حتى في حالات مشكلات الشبكة.نموذج تدفق كامل
تنسيق رقم الهاتف
تنسيقات صحيحة:- ✅
"0778037340"(نص مع صفر بادئ) - ✅
"0665983439" - ✅
"0556121212"
- ❌
778037340(الصفر البادئ مفقود) - ❌
0778037340(رقم بدل نص) - ❌
"+213778037340"(تنسيق دولي) - ❌
"0778 037 340"(يحتوي على مسافات)
دورة حياة الحالة
بعد إرسال الشحن، يمر بالحالات التالية:تعرّف على تتبع الحالة →
اختبار Sandbox
فعّل وضع Sandbox للاختبار دون معاملات حقيقية:التدفق الطبيعي
استخدم أي رقم عادي (مثل
0778037340) التدفق: PENDING (5ث) → HANDLING (15ث) → FULFILLEDاسترداد مع رسالة
استخدم:
0600000001 النتيجة: REFUNDED مع refund_messageعدم تطابق الخطة
استخدم:
0600000002 النتيجة: REFUNDED مع suggested_offersخطأ غير معروف
استخدم:
0600000003 النتيجة: حالة UNKNOWN_ERRORأفضل الممارسات
استخدم مراجع فريدة
قدّم دائماً
ref فريداً لمنع التكرار وتسهيل التتبعتحقق قبل الإرسال
تحقق من الخطة وتنسيق الهاتف والرصيد من جهة العميل لتقليل الأخطاء
اعمل بشكل غير متزامن
نفّذ طلبات API بشكل غير متزامن لتجنب إيقاف طلبات المستخدمين
نفّذ منطق إعادة المحاولة
أعد المحاولة عند فشل الطلبات مع تأخير أسي لأخطاء الشبكة
Endpoints ذات الصلة
قائمة الخطط
استعرض الخطط المتاحة
التحقق من الحالة بالمرجع
تتبع باستخدام مرجعك
التحقق من الحالة بالمعرّف
تتبع باستخدام topupId

