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

# Introduction

> API complète de services télécom pour l'Algérie - Recharge mobile, internet et cartes cadeaux

## OneClickDz Flexy API v3

OneClick est le distributeur officiel d'Algérie Télécom et de Djezzy, et la seule plateforme numérique en Algérie qui propose les recharges télécom, les cartes internet et les bons numériques internationaux (PlayStation, Steam, Xbox, etc.) sous une seule marque.
Notre API permet aux entreprises d'intégrer facilement ces services directement dans leurs sites web, applications ou systèmes de point de vente - avec une livraison instantanée et des paiements sécurisés.

**Conçue pour les développeurs** avec des réponses standardisées, une gestion complète des erreurs et une documentation détaillée.

## Navigation rapide

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

  <Card title="Recharges mobiles" icon="mobile" href="/fr/mobile-topup-guides/overview">
    Flux de recharge mobile complet
  </Card>

  <Card title="Recharges internet" icon="wifi" href="/fr/internet-topup-guides/overview">
    Guide de recharge ADSL et 4G
  </Card>

  <Card title="Cartes cadeaux" icon="gift" href="/fr/gift-card-guides/overview">
    Flux de livraison de produits numériques
  </Card>

  <Card title="Navio" icon="credit-card" href="/fr/ocpay-guides/overview">
    Intégration de la passerelle de paiement
  </Card>
</CardGroup>

## Nos services

### Recharges mobiles

Envoyez des recharges instantanées vers tous les opérateurs mobiles algériens avec un suivi en temps réel.

**Opérateurs pris en charge :**

* Mobilis (Prépayé, Postpayé, Fixe)
* Djezzy (Prépayé, Postpayé, Fixe)
* Ooredoo (Prépayé, Postpayé, Fixe)

**Fonctionnalités :**

* Forfaits à montant dynamique et fixe
* Recharges instantanées ou programmées
* Remboursements automatiques en cas d'échec
* Suivi des statuts avec des références uniques

[Voir la référence API Mobile →](/fr/api-reference/mobile/list-plans)

### Recharges internet

Rechargez instantanément les lignes internet ADSL et 4G LTE avec validation du numéro de téléphone.

**Services :**

* Recharge ADSL
* Recharge 4G LTE
* Plusieurs dénominations de cartes
* Disponibilité des stocks en temps réel

**Fonctionnalités :**

* Validation du numéro avant l'achat
* Recharge instantanée avec le seul numéro de téléphone
* Suivi des transactions

[Voir la référence API Internet →](/fr/api-reference/internet/list-products)

### Cartes cadeaux et produits numériques

Livrez des cartes cadeaux et des bons numériques instantanément grâce à un catalogue de produits complet.

**Catégories :**

* Cartes gaming (Freefire, Pubg, PSN, Xbox, Steam…)
* Services de streaming (Shahid…)
* Portefeuilles numériques (iTunes, Amazon…)
* Cartes de recharge mobile
* Et bien plus…

**Fonctionnalités :**

* Plus de 100 produits disponibles
* Vérification des stocks en temps réel
* Livraison numérique instantanée
* Support des commandes en volume

[Voir la référence API Cartes cadeaux →](/fr/api-reference/gift-cards/get-catalog)

### Navio - Passerelle de paiement

Acceptez les paiements en ligne de vos clients grâce à notre solution de passerelle de paiement intégrée.

**Méthodes de paiement :**

* CIB (cartes de crédit)
* eDahabia (carte de débit nationale)

**Fonctionnalités :**

* Création simple de liens de paiement
* Plusieurs méthodes de paiement en une seule intégration
* Suivi du statut de paiement en temps réel
* Vérification automatique des paiements
* Gestion sécurisée des transactions
* Support des montants personnalisés

**Cas d'usage :**

* Intégration de caisse e-commerce
* Paiements d'abonnements de services
* Collecte de paiements de factures
* Dons et collectes de fonds
* Vente de billets d'événements

[Voir la référence API Navio →](/fr/api-reference/ocpay/create-link)

## Pourquoi choisir notre API ?

<CardGroup cols={2}>
  <Card title="Réponses standardisées" icon="code">
    Structure JSON cohérente sur tous les endpoints avec les champs `success`, `data`, `meta` et `requestId`
  </Card>

  <Card title="Gestion complète des erreurs" icon="shield-check">
    Codes d'erreur clairs, messages détaillés et guidance actionnable pour chaque scénario
  </Card>

  <Card title="Suivi des requêtes" icon="fingerprint">
    Un `requestId` unique pour chaque requête permet un débogage et un support faciles
  </Card>

  <Card title="Sécurité des types" icon="lock">
    La validation complète du schéma prévient les requêtes invalides et assure l'intégrité des données
  </Card>

  <Card title="Tests en sandbox" icon="flask">
    Testez toutes les fonctionnalités sans affecter votre solde grâce au mode sandbox
  </Card>

  <Card title="Documentation interactive" icon="book-open">
    Essayez les appels API directement dans la documentation avec le playground intégré
  </Card>
</CardGroup>

## Tarification et modèle commercial

### Simple et à la consommation

* **Sans frais d'intégration** — Commencez à développer gratuitement
* **Sans abonnements mensuels** — Ne payez que ce que vous utilisez
* **Sans frais cachés** — Payez uniquement les transactions réussies
* **Remboursements automatiques** — Les transactions échouées sont remboursées instantanément

### Comment fonctionne la facturation

1. **Solde prépayé** : Maintenez un solde sur votre compte OneClickDz
2. **Déduction automatique** : Les transactions réussies déduisent de votre solde
3. **Tarification transparente** : Tous les prix en Dinar Algérien (DZD)

### Remises professionnelles

Nous offrons **les meilleures remises aux entreprises** qui souhaitent revendre nos services à des clients finaux. Notre structure tarifaire compétitive est conçue pour vous aider à bâtir des activités rentables de services télécom.

<Card title="Renseignez-vous sur les tarifs professionnels" icon="handshake" href="/fr/contact">
  Contactez-nous pour discuter des remises de volume et des partenariats professionnels
</Card>

## Premiers pas

Prêt à intégrer ? Suivez ces étapes simples :

<Steps>
  <Step title="Créer un compte">
    Inscrivez-vous sur [enterprise.oneclickdz.com](https://enterprise.oneclickdz.com) pour accéder à votre tableau de bord
  </Step>

  <Step title="Générer une clé API">
    Activez l'accès API dans les [paramètres](https://enterprise.oneclickdz.com/api-keys) et générez vos clés (sandbox + production)
  </Step>

  <Step title="Tester en sandbox">
    Utilisez le mode sandbox pour tester toutes les fonctionnalités sans affecter votre solde
  </Step>

  <Step title="Passer en production">
    Basculez vers la clé de production lorsque vous êtes prêt à traiter de vraies transactions
  </Step>
</Steps>

[Commencer avec le guide de démarrage rapide →](/fr/quickstart)

## Format de réponse de l'API

Tous les endpoints v3 retournent des réponses cohérentes et prévisibles :

<CodeGroup>
  ```json Réponse de succès theme={null}
  {
    "success": true,
    "data": {
      "balance": 50000
    },
    "meta": {
      "timestamp": "2025-10-29T00:00:00.000Z"
    },
    "requestId": "req_1234567890_abc123"
  }
  ```

  ```json Réponse d'erreur theme={null}
  {
    "success": false,
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Your balance is insufficient for this operation",
      "details": {
        "required": 1000,
        "available": 500
      }
    },
    "requestId": "req_1234567890_abc123"
  }
  ```
</CodeGroup>

[En savoir plus sur le format de réponse →](/fr/api-reference/response-format)

## Cas d'usage

<AccordionGroup>
  <Accordion icon="store" title="Plateformes e-commerce">
    Intégrez des services télécom dans votre marketplace. Laissez les clients acheter des recharges mobiles, des recharges internet et des cartes cadeaux avec vos produits.
  </Accordion>

  <Accordion icon="mobile-screen" title="Applications mobiles">
    Construisez des applications de recharge mobile pour iOS et Android. Offrez des recharges multi-opérateurs avec suivi en temps réel et livraison instantanée.
  </Accordion>

  <Accordion icon="building" title="Systèmes de point de vente">
    Ajoutez des services numériques à votre POS. Vendez du crédit mobile, des cartes internet et des cartes cadeaux dans vos points de vente.
  </Accordion>

  <Accordion icon="users" title="Marketing multi-niveaux">
    Créez des réseaux de revendeurs avec des systèmes de commission. Suivez les transactions, gérez les soldes et distribuez les profits automatiquement.
  </Accordion>

  <Accordion icon="chart-line" title="Services financiers">
    Intégrez des services télécom dans des applications bancaires, des plateformes de paiement et des portefeuilles numériques pour des solutions financières complètes.
  </Accordion>

  <Accordion icon="headset" title="Service client">
    Construisez des outils de support pour les équipes helpdesk afin d'assister rapidement les clients avec des recharges lors des appels de support.
  </Accordion>
</AccordionGroup>

## Ressources pour les développeurs

<CardGroup cols={3}>
  <Card title="Référence API" icon="code" href="/fr/api-reference/response-format">
    Documentation complète des endpoints
  </Card>

  <Card title="Authentification" icon="key" href="/fr/authentication">
    Sécurisez votre accès API
  </Card>

  <Card title="Gestion des erreurs" icon="triangle-exclamation" href="/fr/api-reference/error-handling">
    Gérez les erreurs comme un pro
  </Card>

  <Card title="Stratégies de polling" icon="rotate" href="/fr/polling-strategies">
    Optimisez la vérification de statut
  </Card>

  <Card title="Webhooks" icon="webhook" href="/fr/webhooks">
    Notifications en temps réel
  </Card>

  <Card title="Bonnes pratiques" icon="lightbulb" href="/fr/security-best-practices">
    Modèles prêts pour la production
  </Card>
</CardGroup>

## Besoin d'aide ?

<CardGroup cols={2}>
  <Card title="Support par e-mail" icon="envelope" href="mailto:support@oneclickdz.com">
    Contactez notre équipe support à [support@oneclickdz.com](mailto:support@oneclickdz.com)
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/oneclickdz">
    Parcourez les exemples de code et les SDKs
  </Card>
</CardGroup>

***

<Note>
  **Prêt à commencer ?** Rendez-vous sur le [Guide de démarrage rapide](/fr/quickstart) pour envoyer votre première recharge en moins de 5 minutes.
</Note>