Skip to main content

Vue d’ensemble

Après l’envoi d’une demande de recharge, interrogez l’endpoint de statut jusqu’à ce que la transaction atteigne un état final. L’API traite généralement les demandes en 5 à 30 secondes, en passant par les états PENDING → HANDLING → FULFILLED/REFUNDED.
Critique : Gérez correctement toutes les valeurs de statut, en particulier UNKNOWN_ERROR. Ne remboursez jamais immédiatement en cas de statut inconnu !

API Vérification par référence

GET /v3/mobile/check-ref/:ref - Suivi avec votre référence

API Vérification par ID

GET /v3/mobile/check-id/:id - Suivi avec l’ID de recharge

Valeurs de statut

La compréhension de chaque statut est essentielle pour une gestion correcte :
Consultez la Référence API Vérification par ID pour des descriptions détaillées des statuts et leurs cas d’usage.

Implémentation de base de l’interrogation

Gérer les différents états

Interrogation de statut en arrière-plan

Pour de meilleures performances, interrogez le statut dans des tâches en arrière-plan :

Revérification planifiée pour UNKNOWN_ERROR

Configurez une tâche cron quotidienne pour revérifier les commandes incertaines :

Stratégie d’interrogation optimisée

Utilisez des intervalles d’interrogation intelligents :

Bonnes pratiques

Attendez que le statut se résolve en FULFILLED ou REFUNDED dans les 24 heures avant de traiter les remboursements.
Interrogez le statut de manière asynchrone pour éviter de bloquer les requêtes utilisateur et améliorer les performances.
Définissez un nombre maximum de tentatives d’interrogation (généralement 60 = 5 minutes) et replanifiez les vérifications si nécessaire.
Enregistrez le statut dans votre base de données pour minimiser les appels API. N’interrogez l’API que lorsque le statut n’est pas final.
Affichez toujours le refund_message tel quel aux utilisateurs. Il est en arabe et explique clairement le problème.
Lorsque suggested_offers est présent, affichez ces alternatives pour améliorer la conversion.

Étapes suivantes

Stratégies d'interrogation

Apprenez les techniques avancées d’optimisation de l’interrogation

Webhooks

Configurez des notifications de statut en temps réel au lieu d’interroger

API Liste des recharges

Consultez toutes vos transactions de recharge

Gestion des erreurs

Référence complète de gestion des erreurs