مقدمة
ادمج بيع بطاقات شحن الإنترنت ADSL و4G LTE في 5 خطوات بسيطة. توضح هذه النظرة العامة سير العمل-يوجد التطبيق التفصيلي مع أمثلة الكود في الأدلة التفصيلية أدناه.تُسلَّم بطاقات الإنترنت رقميًا مع الرموز وأرقام المعاملات عند التنفيذ.
كيف يعمل النظام
عملية التكامل في 5 خطوات
1
تحميل المنتجات
احصل على بطاقات ADSL و4G المتاحة مع التسعير وحالة المخزون.→ انظر الخطوة 1: تحميل المنتجات
2
التحقق من الرقم
تحقق من تنسيق رقم الهاتف (ADSL: 9 أرقام، 4G: 12 رقمًا) قبل الطلب.→ انظر الخطوة 2: التحقق
3
إرسال الشحن
قدّم الطلب مع نوع الخدمة والرقم وقيمة البطاقة.→ انظر الخطوة 3: إرسال الشحنات
4
تتبع الحالة
استطلاع حالة الطلب كل 5-10 ثوانٍ حتى FULFILLED أو QUEUED أو REFUNDED.→ انظر الخطوة 4: تتبع الحالة
5
تسليم البطاقة
استرداد وتسليم رمز البطاقة ورقم المعاملة بأمان.→ انظر الخطوة 5: تسليم البطاقة
ما تحتاج إلى معرفته
أنواع الخدمة
- ADSL: إنترنت أرضي (أرقام مكونة من 9 أرقام تبدأ بـ 0)
- 4G LTE: إنترنت محمول (أرقام مكونة من 12 رقمًا تبدأ بـ 213)
حالة الطلب
HANDLING→ استمر في الاستطلاع (3-45 ثانية)FULFILLED→ البطاقة جاهزة! احصل علىcard_codeوnum_trans✅QUEUED→ تسليم مجدوَل (12-48 ساعة) ⏰REFUNDED→ فشل، تم إصدار الاسترداد ❌
الطلبات QUEUED
QUEUED ليست فشلًا! تعني أن البطاقة ستُسلَّم خلال 12-48 ساعة. خزّن الطلب وأعد الفحص لاحقًا.→ التعامل مع QUEUED في الخطوة 4التسعير
طبّق هامش ربحك على أسعار الجملة قبل عرضها للعملاء.مثال: 980 دج بالجملة → البيع بـ 1029 دج (هامش 5%) → الربح: 49 دج→ التسعير في الخطوة 1النقاط الرئيسية
التحقق دائمًا
استخدم
/check-number قبل تقديم الطلبات→ الخطوة 2فحص المخزون
تحقق من
available: true قبل عرض البطاقات→ الخطوة 1التعامل مع QUEUED
لا تعامل QUEUED كفشل-جدوِل عمليات إعادة الفحص→ الخطوة 4
تسليم آمن
شفّر رموز البطاقات في التخزين والنقل→ الخطوة 5
مرجع API
عرض المنتجات
GET /v3/internet/products
التحقق من الرقم
GET /v3/internet/check-number
إرسال الشحن
POST /v3/internet/send
فحص الحالة
GET /v3/internet/check-id/:id
الاختبار
استخدم وضع sandbox للاختبار دون معاملات حقيقية: لا يتم الاتصال بأي خط لدى اتصالات الجزائر، ولا تُستهلك أي بطاقة، ولا يُمسّ رصيدك. فعّل sandbox في إعدادات لوحة التحكم واستدعِ نفس النقاط باستخدام مفتاح sandbox.في وضع sandbox الرقم هو الذي يحدد النتيجة، فتستطيع إعادة إنتاج كل الحالات وقت ما تشاء:→ كل سيناريوهات sandbox في الخطوة 4
ابدأ التكامل
ابدأ بالخطوة 1: تحميل المنتجات
ابدأ بتحميل البطاقات المتاحة مع أمثلة الكود
موارد إضافية
دليل البدء السريع
ابدأ خلال 5 دقائق
المصادقة
تعلم كيفية مصادقة الطلبات
أفضل ممارسات الأمان
أمّن تكاملك
التواصل مع الدعم
احصل على مساعدة من فريقنا