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.
مقدمة
ادمج بيع بطاقات شحن الإنترنت ADSL و4G LTE في 5 خطوات بسيطة. توضح هذه النظرة العامة سير العمل-يوجد التطبيق التفصيلي مع أمثلة الكود في الأدلة التفصيلية أدناه.تُسلَّم بطاقات الإنترنت رقميًا مع الرموز وأرقام المعاملات عند التنفيذ.
كيف يعمل النظام
عملية التكامل في 5 خطوات
تحميل المنتجات
احصل على بطاقات ADSL و4G المتاحة مع التسعير وحالة المخزون.→ انظر الخطوة 1: تحميل المنتجات
التحقق من الرقم
تحقق من تنسيق رقم الهاتف (ADSL: 9 أرقام، 4G: 12 رقمًا) قبل الطلب.→ انظر الخطوة 2: التحقق
إرسال الشحن
قدّم الطلب مع نوع الخدمة والرقم وقيمة البطاقة.→ انظر الخطوة 3: إرسال الشحنات
تتبع الحالة
استطلاع حالة الطلب كل 5-10 ثوانٍ حتى FULFILLED أو QUEUED أو REFUNDED.→ انظر الخطوة 4: تتبع الحالة
تسليم البطاقة
استرداد وتسليم رمز البطاقة ورقم المعاملة بأمان.→ انظر الخطوة 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 في إعدادات لوحة التحكم.ابدأ التكامل
ابدأ بالخطوة 1: تحميل المنتجات
ابدأ بتحميل البطاقات المتاحة مع أمثلة الكود
موارد إضافية
دليل البدء السريع
ابدأ خلال 5 دقائق
المصادقة
تعلم كيفية مصادقة الطلبات
أفضل ممارسات الأمان
أمّن تكاملك
التواصل مع الدعم
احصل على مساعدة من فريقنا