Envoyer une Recharge Mobile
Recharges mobiles
Envoyer une Recharge Mobile
Créer et envoyer une demande de recharge mobile
POST
Envoyer une Recharge Mobile
Vue d’Ensemble
Envoyez des recharges mobiles instantanées aux opérateurs algériens (Mobilis, Djezzy, Ooredoo, Pixx) avec suivi du statut en temps réel.Recommandé : Utilisez le paramètre
ref unique pour prévenir les commandes en double et faciliter le suivi.Corps de la Requête
string
requis
Code de forfait depuis l’endpoint
/mobile/plans (ex. : PREPAID_DJEZZY, PIXX_500)string
requis
Numéro de téléphone au format
0[567][0-9]{8} (doit être une chaîne, pas un nombre)
Exemples : "0778037340", "0665983439", "0556121212"integer
Montant de recharge en DZD (requis pour les forfaits dynamiques, ignoré pour les forfaits fixes)
Doit être compris entre
min_amount et max_amount des détails du forfaitstring
Votre référence de commande unique pour le suivi (générée automatiquement si non fournie)
Important : Prévient les requêtes en double si la même référence est soumise deux fois
Réponse
boolean
requis
Indique si la requête a été soumise avec succès
object
requis
object
requis
Exemples
Réponse de Succès
Réponses d’Erreur
400 - Erreurs de Validation
400 - Erreurs de Validation
Corps ou paramètres de requête invalidesErreurs de validation courantes :
plan_codeouMSSIDNmanquant- Format de numéro de téléphone invalide
amountrequis pour les forfaits dynamiquesamounthors plage min/max- MSSIDN ne correspond pas à l’opérateur du forfait
403 - Solde Insuffisant
403 - Solde Insuffisant
Solde insuffisant pour l’opération
403 - Référence en Double
403 - Référence en Double
Référence déjà utiliséeSolution : Vérifiez le statut de la recharge existante en utilisant la même référence
500 - Erreur Interne
500 - Erreur Interne
Erreur serveur (rare)Action : Contactez le support avec le
requestId. Ne remboursez PAS avant investigation.Prévention des Requêtes Dupliquées
Le champ
ref garantit que la recharge est traitée une seule fois, même en cas de problèmes réseau.Format du Numéro de Téléphone
Formats valides :- ✅
"0778037340"(chaîne avec zéro initial) - ✅
"0665983439" - ✅
"0556121212"
- ❌
778037340(zéro initial manquant) - ❌
0778037340(type nombre au lieu de chaîne) - ❌
"+213778037340"(format international) - ❌
"0778 037 340"(contient des espaces)
Cycle de Vie du Statut
Après l’envoi d’une recharge, elle passe par ces états :1
PENDING
Commande créée et mise en file d’attente pour traitement Durée : 2 à 15 secondes (typique)
2
HANDLING
Actuellement en cours de traitement par l’opérateur Durée : 3 à 8 secondes (typique)
3
État Final
FULFILLED : Complété avec succès ✅ REFUNDED : Échoué et remboursé
❌ UNKNOWN_ERROR : État incertain (se résout en 24h) ⚠️
Flux d’Intégration Recommandé
1
Créer la Commande dans Votre BD
2
Déduire le Solde Utilisateur
3
Retourner la Commande à l'Utilisateur
4
Async : Envoyer à l'API
5
Interroger le Statut et Mettre à Jour
Tests en Sandbox
Activez le mode sandbox pour tester sans transactions réelles :Flux Normal
Utilisez n’importe quel numéro normal (ex. :
0778037340) Flux : PENDING (5s) → HANDLING
(15s) → FULFILLEDRemboursement avec Message
Utilisez :
0600000001 Retourne : REFUNDED avec refund_messageNon-correspondance de Forfait
Utilisez :
0600000002 Retourne : REFUNDED avec suggested_offersErreur Inconnue
Utilisez :
0600000003 Retourne : statut UNKNOWN_ERRORBonnes Pratiques
Utiliser des Références Uniques
Fournissez toujours un
ref unique pour prévenir les doublons et faciliter le suiviValider Avant Soumission
Vérifiez le forfait, le format du téléphone et le solde côté client pour réduire les erreurs
Gérer de Manière Asynchrone
Traitez les appels API de manière asynchrone pour éviter de bloquer les requêtes utilisateur
Implémenter une Logique de Nouvelle Tentative
Réessayez les requêtes échouées avec un backoff exponentiel pour les erreurs réseau
Endpoints Associés
Lister les Forfaits
Obtenir les forfaits disponibles
Vérifier par Référence
Suivre avec votre référence
Vérifier par ID
Suivre avec l’ID de recharge

