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
CREATE TABLE mobile_plans ( id SERIAL PRIMARY KEY, code VARCHAR(100) UNIQUE NOT NULL, name VARCHAR(255) NOT NULL, operator VARCHAR(50) NOT NULL, type VARCHAR(20) NOT NULL, -- 'dynamic' or 'fixed' -- Cost info wholesale_cost DECIMAL(5,4) NOT NULL, sell_price_multiplier DECIMAL(5,4) NOT NULL, -- Amount limits min_amount INTEGER, max_amount INTEGER, fixed_amount INTEGER, -- Status is_enabled BOOLEAN DEFAULT true, is_visible BOOLEAN DEFAULT true, -- Metadata created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, last_synced_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP);CREATE INDEX idx_mobile_plans_operator ON mobile_plans(operator);CREATE INDEX idx_mobile_plans_enabled ON mobile_plans(is_enabled);CREATE INDEX idx_mobile_plans_code ON mobile_plans(code);
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
N’exposez jamais le champ cost aux utilisateurs finaux. N’affichez que vos tarifs de détail.
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é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
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
Créez des index sur les champs fréquemment interrogés (operator, code, isEnabled) pour des recherches rapides.