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

# Vue d'ensemble de l'intégration des recharges Internet

> Apprenez à intégrer la recharge de cartes internet ADSL et 4G LTE

## Introduction

Intégrez la vente de cartes de recharge internet ADSL et 4G LTE en 5 étapes simples. Cette vue d'ensemble explique le flux de travail-l'implémentation détaillée avec des exemples de code se trouve dans les guides étape par étape ci-dessous.

<Info>
  Les cartes internet sont livrées numériquement avec des codes et des numéros de transaction une fois exécutées.
</Info>

## Comment ça fonctionne

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

## Processus d'intégration en 5 étapes

<Steps>
  <Step title="Charger les produits">
    Obtenez les cartes ADSL et 4G disponibles avec les tarifs et le statut du stock.

    → [Voir Étape 1 : Chargement des produits](/fr/internet-topup-guides/1-loading-products)
  </Step>

  <Step title="Valider le numéro">
    Vérifiez le format du numéro de téléphone (ADSL : 9 chiffres, 4G : 12 chiffres) avant de commander.

    → [Voir Étape 2 : Validation](/fr/internet-topup-guides/2-validation)
  </Step>

  <Step title="Envoyer la recharge">
    Soumettez la commande avec le type de service, le numéro et la valeur de la carte.

    → [Voir Étape 3 : Envoi des recharges](/fr/internet-topup-guides/3-sending-topups)
  </Step>

  <Step title="Suivre le statut">
    Interrogez le statut de la commande toutes les 5 à 10 secondes jusqu'à FULFILLED, QUEUED ou REFUNDED.

    → [Voir Étape 4 : Suivi du statut](/fr/internet-topup-guides/4-status-tracking)
  </Step>

  <Step title="Livrer la carte">
    Récupérez et livrez en toute sécurité le code de carte et le numéro de transaction.

    → [Voir Étape 5 : Livraison de la carte](/fr/internet-topup-guides/5-card-delivery)
  </Step>
</Steps>

## Ce que vous devez savoir

### Types de service

* **ADSL** : Internet fixe (numéros à 9 chiffres commençant par 0)
* **4G LTE** : Internet mobile (numéros à 12 chiffres commençant par 213)

→ [Formats de numéros à l'Étape 2](/fr/internet-topup-guides/2-validation)

### Statut de commande

* `HANDLING` → Continuez à interroger (3 à 45 secondes)
* `FULFILLED` → Carte prête ! Récupérez `card_code` et `num_trans` ✅
* `QUEUED` → Livraison programmée (12 à 48 heures) ⏰
* `REFUNDED` → Échec, remboursement émis ❌

→ [Gestion des statuts à l'Étape 4](/fr/internet-topup-guides/4-status-tracking)

### Commandes QUEUED

**QUEUED n'est pas un échec !** Cela signifie que la carte sera livrée dans les 12 à 48 heures. Enregistrez la commande et revérifiez plus tard.

→ [Gestion de QUEUED à l'Étape 4](/fr/internet-topup-guides/4-status-tracking)

### Tarification

Appliquez votre marge sur les prix de gros avant d'afficher aux clients.

Exemple : 980 DA en gros → Vendez à 1029 DA (5% de marge) → Profit : 49 DA

→ [Tarification à l'Étape 1](/fr/internet-topup-guides/1-loading-products)

## Points clés

<CardGroup cols={2}>
  <Card title="Toujours valider" icon="circle-check">
    Utilisez `/check-number` avant de soumettre des commandes

    → [Étape 2](/fr/internet-topup-guides/2-validation)
  </Card>

  <Card title="Vérifier le stock" icon="boxes-stacked">
    Vérifiez `available: true` avant d'afficher les cartes

    → [Étape 1](/fr/internet-topup-guides/1-loading-products)
  </Card>

  <Card title="Gérer QUEUED" icon="calendar">
    Ne traitez pas QUEUED comme un échec-planifiez des revérifications

    → [Étape 4](/fr/internet-topup-guides/4-status-tracking)
  </Card>

  <Card title="Livraison sécurisée" icon="lock">
    Chiffrez les codes de carte en stockage et en transmission

    → [Étape 5](/fr/internet-topup-guides/5-card-delivery)
  </Card>
</CardGroup>

## Référence API

<CardGroup cols={2}>
  <Card title="Lister les produits" icon="list" href="/fr/api-reference/internet/list-products">
    GET /v3/internet/products
  </Card>

  <Card title="Valider le numéro" icon="check" href="/fr/api-reference/internet/validate-number">
    GET /v3/internet/check-number
  </Card>

  <Card title="Envoyer la recharge" icon="paper-plane" href="/fr/api-reference/internet/send-topup">
    POST /v3/internet/send
  </Card>

  <Card title="Vérifier le statut" icon="magnifying-glass" href="/fr/api-reference/internet/check-by-id">
    GET /v3/internet/check-id/:id
  </Card>
</CardGroup>

## Tests

Utilisez le **mode sandbox** pour tester sans transactions réelles. Tous les numéros de téléphone fonctionnent en sandbox et les commandes s'exécutent instantanément avec des codes de carte de test.

Activez le sandbox dans les [paramètres du tableau de bord](https://app.oneclickdz.com/#/settings).

## Commencer l'intégration

<Card title="Commencer avec l'Étape 1 : Chargement des produits" icon="play" href="/fr/internet-topup-guides/1-loading-products" color="#0D9373">
  Commencez par charger les cartes disponibles avec des exemples de code
</Card>

## Ressources supplémentaires

<CardGroup cols={2}>
  <Card title="Guide de démarrage rapide" icon="rocket" href="/fr/quickstart">
    Démarrez en 5 minutes
  </Card>

  <Card title="Authentification" icon="key" href="/fr/authentication">
    Apprenez à authentifier les requêtes
  </Card>

  <Card title="Meilleures pratiques de sécurité" icon="shield" href="/fr/security-best-practices">
    Sécurisez votre intégration
  </Card>

  <Card title="Contacter le support" icon="headset" href="/fr/contact">
    Obtenez l'aide de notre équipe
  </Card>
</CardGroup>