Vue d’ensemble
La première étape de l’intégration des recharges mobiles consiste à récupérer la liste des forfaits disponibles depuis l’API. Les forfaits incluent tous les opérateurs (Mobilis, Djezzy, Ooredoo, Pixx) avec des options de montants dynamiques et fixes.Les forfaits sont stables et changent rarement. Mettez-les en cache dans votre base de données pour réduire les appels API et améliorer les performances.
Référence API
Consultez la documentation API complète pour l’endpoint GET /v3/mobile/plans
Comprendre les types de forfaits
Forfaits dynamiques
Les forfaits dynamiques permettent des montants variables dans une plage min/max :- Recharges prépayées (crédit)
- Paiements de factures postpayées (facture)
- Crédit d’appels internationaux
Forfaits fixes
Les forfaits fixes ont des montants prédéterminés :- Offres promotionnelles spéciales
- Packs data
- Activations de services
Forfaits GetMenu
Forfaits spéciaux qui récupèrent les offres disponibles pour un numéro spécifique :suggested_offers avec tous les forfaits disponibles pour ce numéro spécifique.
Récupérer les forfaits depuis l’API
Requête de base
Structure de la réponse
Comprendre le champ Cost
Le champcost représente votre multiplicateur de prix de gros :
- Fonctionnement
- Calculer le prix de vente
- Note importante
Exemple : cost = 0.98Pour une recharge de 1000 DZD :
- Valeur nominale : 1000 DZD (ce que l’utilisateur reçoit)
- Votre coût : 1000 × 0,98 = 980 DZD (ce que vous payez)
- Votre marge : 1000 - 980 = 20 DZD (2 %)
Mettre les forfaits en cache dans la base de données
Comme les forfaits changent rarement, mettez-les en cache localement avec vos tarifs :Schéma de base de données
Fonction de synchronisation
Servir les forfaits aux utilisateurs
Lorsque les utilisateurs demandent des forfaits, servez-les depuis votre base de données avec vos tarifs :Filtrer les forfaits
Par opérateur
Par numéro de téléphone
Bonnes pratiques
Mettre en cache localement
Mettre en cache localement
Mettez toujours les forfaits en cache dans votre base de données. Les forfaits changent rarement et le cache améliore considérablement les performances.
Masquer les coûts de gros
Masquer les coûts de gros
N’exposez jamais le champ
cost aux utilisateurs finaux. N’affichez que vos tarifs de détail.Synchroniser régulièrement
Synchroniser régulièrement
Mettez en place une tâche cron quotidienne pour synchroniser les forfaits. Cela garantit que vous disposez des dernières offres et disponibilités.
Vérifier isEnabled
Vérifier isEnabled
Vérifiez toujours
isEnabled avant d’afficher les forfaits. Les forfaits désactivés peuvent être temporairement indisponibles en raison de problèmes avec l’opérateur.Ajouter une marge bénéficiaire
Ajouter une marge bénéficiaire
Calculez votre prix de vente en ajoutant une marge bénéficiaire raisonnable (généralement 3 à 10 %) au coût de gros.
Indexer votre base de données
Indexer votre base de données
Créez des index sur les champs fréquemment interrogés (operator, code, isEnabled) pour des recherches rapides.
Étapes suivantes
Étape 2 : Validation
Apprenez à valider les numéros de téléphone et les saisies utilisateur
Référence API des forfaits
Documentation API complète pour GET /v3/mobile/plans
API de solde du compte
Apprenez à vérifier le solde de votre compte
Guide des tarifs
Comprendre la tarification et la structure des coûts de l’API
Format de réponse
En savoir plus sur les structures de réponse de l’API
Référence des modèles
Voir tous les modèles de données et schémas

