Skip to main content

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 :
Cas d’usage :
  • 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 :
Cas d’usage :
  • 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 :
Retourne : Un tableau de 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 champ cost représente votre multiplicateur de prix de gros :
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

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.
N’exposez jamais le champ cost aux utilisateurs finaux. N’affichez que vos tarifs de détail.
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é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.
Calculez votre prix de vente en ajoutant une marge bénéficiaire raisonnable (généralement 3 à 10 %) au coût de gros.
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