> ## 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

<div dir="rtl">
  ## مقدمة

  ادمج بيع بطاقات شحن الإنترنت ADSL و4G LTE في 5 خطوات بسيطة. توضح هذه النظرة العامة سير العمل-يوجد التطبيق التفصيلي مع أمثلة الكود في الأدلة التفصيلية أدناه.

  <Info>
    تُسلَّم بطاقات الإنترنت رقميًا مع الرموز وأرقام المعاملات عند التنفيذ.
  </Info>

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

  ```mermaid theme={null}
  sequenceDiagram
      participant User
      participant YourApp
      participant API as OneClickDz API

      YourApp->>API: 1. Load available cards
      API-->>YourApp: Cards with pricing & stock
      
      User->>YourApp: Enter phone & select card
      YourApp->>API: 2. Validate number format
      API-->>YourApp: Validation result
      
      YourApp->>API: 3. Send top-up request
      API-->>YourApp: Order ID
      
      loop Until Complete
          YourApp->>API: 4. Check status
          API-->>YourApp: Status update
      end
      
      YourApp->>User: 5. Deliver card code
  ```

  ## عملية التكامل في 5 خطوات

  <Steps>
    <Step title="تحميل المنتجات">
      احصل على بطاقات ADSL و4G المتاحة مع التسعير وحالة المخزون.

      → [انظر الخطوة 1: تحميل المنتجات](/ar/internet-topup-guides/1-loading-products)
    </Step>

    <Step title="التحقق من الرقم">
      تحقق من تنسيق رقم الهاتف (ADSL: 9 أرقام، 4G: 12 رقمًا) قبل الطلب.

      → [انظر الخطوة 2: التحقق](/ar/internet-topup-guides/2-validation)
    </Step>

    <Step title="إرسال الشحن">
      قدّم الطلب مع نوع الخدمة والرقم وقيمة البطاقة.

      → [انظر الخطوة 3: إرسال الشحنات](/ar/internet-topup-guides/3-sending-topups)
    </Step>

    <Step title="تتبع الحالة">
      استطلاع حالة الطلب كل 5-10 ثوانٍ حتى FULFILLED أو QUEUED أو REFUNDED.

      → [انظر الخطوة 4: تتبع الحالة](/ar/internet-topup-guides/4-status-tracking)
    </Step>

    <Step title="تسليم البطاقة">
      استرداد وتسليم رمز البطاقة ورقم المعاملة بأمان.

      → [انظر الخطوة 5: تسليم البطاقة](/ar/internet-topup-guides/5-card-delivery)
    </Step>
  </Steps>

  ## ما تحتاج إلى معرفته

  ### أنواع الخدمة

  * **ADSL**: إنترنت أرضي (أرقام مكونة من 9 أرقام تبدأ بـ 0)
  * **4G LTE**: إنترنت محمول (أرقام مكونة من 12 رقمًا تبدأ بـ 213)

  → [تنسيقات الأرقام في الخطوة 2](/ar/internet-topup-guides/2-validation)

  ### حالة الطلب

  * `HANDLING` → استمر في الاستطلاع (3-45 ثانية)
  * `FULFILLED` → البطاقة جاهزة! احصل على `card_code` و`num_trans` ✅
  * `QUEUED` → تسليم مجدوَل (12-48 ساعة) ⏰
  * `REFUNDED` → فشل، تم إصدار الاسترداد ❌

  → [التعامل مع الحالات في الخطوة 4](/ar/internet-topup-guides/4-status-tracking)

  ### الطلبات QUEUED

  **QUEUED ليست فشلًا!** تعني أن البطاقة ستُسلَّم خلال 12-48 ساعة. خزّن الطلب وأعد الفحص لاحقًا.

  → [التعامل مع QUEUED في الخطوة 4](/ar/internet-topup-guides/4-status-tracking)

  ### التسعير

  طبّق هامش ربحك على أسعار الجملة قبل عرضها للعملاء.

  مثال: 980 دج بالجملة → البيع بـ 1029 دج (هامش 5%) → الربح: 49 دج

  → [التسعير في الخطوة 1](/ar/internet-topup-guides/1-loading-products)

  ## النقاط الرئيسية

  <CardGroup cols={2}>
    <Card title="التحقق دائمًا" icon="circle-check">
      استخدم `/check-number` قبل تقديم الطلبات

      → [الخطوة 2](/ar/internet-topup-guides/2-validation)
    </Card>

    <Card title="فحص المخزون" icon="boxes-stacked">
      تحقق من `available: true` قبل عرض البطاقات

      → [الخطوة 1](/ar/internet-topup-guides/1-loading-products)
    </Card>

    <Card title="التعامل مع QUEUED" icon="calendar">
      لا تعامل QUEUED كفشل-جدوِل عمليات إعادة الفحص

      → [الخطوة 4](/ar/internet-topup-guides/4-status-tracking)
    </Card>

    <Card title="تسليم آمن" icon="lock">
      شفّر رموز البطاقات في التخزين والنقل

      → [الخطوة 5](/ar/internet-topup-guides/5-card-delivery)
    </Card>
  </CardGroup>

  ## مرجع API

  <CardGroup cols={2}>
    <Card title="عرض المنتجات" icon="list" href="/ar/api-reference/internet/list-products">
      GET /v3/internet/products
    </Card>

    <Card title="التحقق من الرقم" icon="check" href="/ar/api-reference/internet/validate-number">
      GET /v3/internet/check-number
    </Card>

    <Card title="إرسال الشحن" icon="paper-plane" href="/ar/api-reference/internet/send-topup">
      POST /v3/internet/send
    </Card>

    <Card title="فحص الحالة" icon="magnifying-glass" href="/ar/api-reference/internet/check-by-id">
      GET /v3/internet/check-id/:id
    </Card>
  </CardGroup>

  ## الاختبار

  استخدم **وضع sandbox** للاختبار دون معاملات حقيقية. تعمل جميع أرقام الهاتف في وضع sandbox وتُنفَّذ الطلبات فورًا مع رموز بطاقات اختبارية.

  فعّل sandbox في [إعدادات لوحة التحكم](https://app.oneclickdz.com/#/settings).

  ## ابدأ التكامل

  <Card title="ابدأ بالخطوة 1: تحميل المنتجات" icon="play" href="/ar/internet-topup-guides/1-loading-products" color="#0D9373">
    ابدأ بتحميل البطاقات المتاحة مع أمثلة الكود
  </Card>

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

  <CardGroup cols={2}>
    <Card title="دليل البدء السريع" icon="rocket" href="/ar/quickstart">
      ابدأ خلال 5 دقائق
    </Card>

    <Card title="المصادقة" icon="key" href="/ar/authentication">
      تعلم كيفية مصادقة الطلبات
    </Card>

    <Card title="أفضل ممارسات الأمان" icon="shield" href="/ar/security-best-practices">
      أمّن تكاملك
    </Card>

    <Card title="التواصل مع الدعم" icon="headset" href="/ar/contact">
      احصل على مساعدة من فريقنا
    </Card>
  </CardGroup>
</div>