Passer au contenu principal

Vue d’ensemble

Une fois toutes les entrées validées, vous êtes prêt à envoyer la demande de recharge à l’API OneClickDz. Ce guide couvre la soumission des demandes, la gestion des réponses et la gestion de votre système de références.

Référence API

Consultez la documentation API complète pour l’endpoint POST /v3/mobile/send

Demande de recharge de base

Exemple simple

Réponse en cas de succès

Générer des références uniques

Fournissez toujours des références uniques pour éviter les doublons et permettre le suivi :

Vérifier le solde avant l’envoi

Vérifiez toujours que le solde est suffisant pour éviter les demandes échouées :

Référence API du solde

En savoir plus sur l’endpoint GET /v3/account/balance

Gestion des erreurs

ERR_VALIDATION ou INSUFFICIENT_BALANCE de /v3/mobile/send signifie que la recharge n’a pas été créée et que rien n’a été débité — remboursez votre client immédiatement. Ne remboursez jamais sur DUPLICATED_REF : cette ref appartient à une commande existante, vérifiez plutôt son statut. ERR_VALIDATION n’est pas toujours de votre faute : il est aussi renvoyé quand un forfait ou un opérateur est désactivé, que le réseau de l’opérateur est indisponible, ou que le type d’offre n’est pas activé pour votre compte. Affichez message (souvent en arabe) à votre client.
Gérez les erreurs API courantes :
Consultez la Référence de gestion des erreurs pour les codes d’erreur complets et les stratégies de traitement.

Intégration avec la base de données

Enregistrez les commandes avant et après les appels API :

Traitement asynchrone

Pour de meilleures performances, traitez les recharges de manière asynchrone :

Logique de nouvelle tentative

Implémentez des nouvelles tentatives pour les erreurs réseau :
En cas de timeout ou d’erreur réseau, réessayez avec la même ref. Si la nouvelle tentative répond DUPLICATED_REF, votre première requête a bien été reçue — ne renvoyez pas avec une nouvelle ref ; vérifiez son statut avec GET /v3/mobile/check-ref/{ref}.

Bonnes pratiques

Générez un ref unique pour chaque demande afin d’éviter les doublons et permettre le suivi.
Vérifiez que le solde est suffisant avant d’envoyer la demande pour éviter les échecs.
Encapsulez la création de commande et la déduction de solde dans des transactions pour la cohérence des données.
Utilisez des files d’attente pour de meilleures performances et une meilleure expérience utilisateur.
Réessayez les erreurs réseau avec un backoff exponentiel, mais pas les erreurs de validation.
Journalisez toutes les demandes et réponses à des fins de débogage et d’audit.

Étapes suivantes

Étape 4 : Interrogation du statut

Apprenez à interroger et suivre le statut des recharges

API de vérification par référence

Documentation API pour GET /v3/mobile/check-ref/:ref

API de vérification par ID

Documentation API pour GET /v3/mobile/check-id/:id

Référence de gestion des erreurs

Guide complet de gestion et de récupération des erreurs

Configuration des Webhooks

Configurez des notifications de statut en temps réel

Stratégies d'interrogation

Optimisez votre implémentation d’interrogation

API Historique des transactions

Consultez l’historique de vos transactions

API de solde

Endpoint de vérification du solde du compte