Passer au contenu principal

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

Intégrez la fonctionnalité de recharge mobile pour les opérateurs algériens (Mobilis, Djezzy, Ooredoo, Pixx) en 4 étapes simples. Cette vue d’ensemble explique le flux d’intégration - les implémentations détaillées avec des exemples de code en Node.js, Python, PHP et cURL sont dans les guides étape par étape ci-dessous.

​
Comment ça fonctionne

​
Processus d’intégration en 4 étapes

1

Charger les forfaits

Récupérez les forfaits de recharge disponibles avec la tarification et mettez-les en cache localement.→ Voir Étape 1 : Chargement des forfaits
2

Valider les entrées

Vérifiez les numéros de téléphone (10 chiffres, préfixe opérateur correct) et les montants avant d’envoyer.→ Voir Étape 2 : Validation
3

Envoyer la recharge

Soumettez la demande de recharge avec une référence unique pour le suivi.→ Voir Étape 3 : Envoi de recharges
4

Suivre le statut

Vérifiez le statut de la commande toutes les 5 à 10 secondes jusqu’à complétion (FULFILLED, REFUNDED ou UNKNOWN_ERROR).→ Voir Étape 4 : Suivi du statut

​
Ce que vous devez savoir

​
Types de forfaits

L’API prend en charge 3 types de forfaits :
  • Forfaits dynamiques : Montants flexibles (ex. 50–5000 DA pour Djezzy Prépayé)
  • Forfaits fixes : Montants spécifiques (ex. Pixx 500 DA)
  • Forfaits GetMenu : Récupère des offres personnalisées pour un numéro de téléphone
→ En savoir plus à l’Étape 1

​
Statuts de commande

Les commandes progressent à travers ces états :
  • PENDING / HANDLING → Continuez à vérifier
  • FULFILLED → Succès ! ✅
  • REFUNDED → Échec, remboursement effectué ❌
  • UNKNOWN_ERROR → Attendez 24h avant de rembourser ⚠️
→ Gestion détaillée des statuts à l’Étape 4

​
Format de numéro de téléphone

Les numéros de téléphone doivent comporter 10 chiffres : 0[567][0-9]{8}
  • Mobilis : 06...
  • Djezzy : 07...
  • Ooredoo : 05...
→ Code de validation à l’Étape 2

​
Tarification

L’API renvoie les prix en gros. Appliquez votre marge avant de les afficher aux clients. Exemple : cost: 0.98 pour 1000 DA → Vous payez 980 DA → Vendez à 1029 DA (5% de marge) → Profit : 49 DA → Stratégies de tarification à l’Étape 1

​
Points clés

Générez un ref unique pour chaque requête pour éviter les doublons et activer le suivi.→ Implémentation à l’Étape 3
Les forfaits changent rarement. Mettez-les en cache pour réduire les appels API et améliorer la vitesse.→ Stratégie de cache à l’Étape 1
Ne remboursez jamais immédiatement ! Attendez jusqu’à 24 heures que le statut se résolve.→ Gestion des erreurs à l’Étape 4
Affichez le champ refund_message (en arabe) aux clients - il explique ce qui s’est passé.→ Gestion des messages à l’Étape 4

​
Référence API

Pour les spécifications complètes des endpoints :

Lister les forfaits mobiles

GET /v3/mobile/plans

Envoyer une recharge

POST /v3/mobile/send

Vérifier par référence

GET /v3/mobile/check-ref/:ref

Vérifier par ID

GET /v3/mobile/check-id/:id

​
Tests

Utilisez le mode sandbox pour tester sans argent réel. Testez avec ces numéros spéciaux :
  • Numéros normaux → Flux de succès
  • 0600000001 → Scénario de remboursement
  • 0600000002 → Offres suggérées
  • 0600000003 → Erreur inconnue
Activez le sandbox dans les paramètres du tableau de bord.

​
Démarrer l’intégration

Commencer par l'Étape 1 : Chargement des forfaits

Démarrez en chargeant et mettant en cache les forfaits mobiles avec des exemples de code

​
Ressources supplémentaires

Guide de démarrage rapide

Démarrez en 5 minutes

Authentification

Apprenez à authentifier les requêtes

Bonnes pratiques de sécurité

Sécurisez votre intégration

Stratégies de polling

Optimisez la vérification du statut

Webhooks

Notifications de statut en temps réel

Contacter le support

Obtenez l’aide de notre équipe