Skip to main content

Vue d’ensemble

Bonnes pratiques pour interroger les endpoints API afin de suivre efficacement le statut des commandes.

Modèle de base d’interrogation

Interrogation spécifique par service

Recharges mobiles (5 minutes max)

Recharges internet (5 minutes max)

Cartes cadeaux (10 minutes max)

Paiement de factures (5 minutes max)

Le Paiement de factures fonctionne sur https://api.oneclickdz.com et comporte deux phases : une découverte qui aboutit rapidement, et un paiement qui prend plus de temps. Interrogez la transaction par son identifiant.
UNKNOWN n’est pas un état final et n’est pas un échec — cela signifie que le résultat n’a pas encore été confirmé, et il se résout de lui-même en SUCCESS ou REFUNDED. L’examen est manuel et peut prendre jusqu’à 24 heures : interroger plus souvent n’y change rien. Ralentissez l’interrogation à environ 30 secondes tant qu’il dure, confiez-la à une tâche en arrière-plan si votre délai d’attente au premier plan expire, et ne remboursez jamais votre client ni ne renvoyez le paiement entre-temps.
Guide complet d’interrogation du Paiement de factures →

Bonnes pratiques

Définir des délais d'attente

Définissez toujours une durée d’interrogation maximale

Gérer les erreurs

Capturez et gérez les délais d’interrogation

Journaliser la progression

Suivez les tentatives d’interrogation pour le débogage

États finaux

Définissez des états terminaux clairs

Paramètres recommandés

Liens utiles

Guide Recharge Mobile

Workflow d’intégration mobile complet

Gestion des erreurs

Gérer correctement les erreurs

Webhooks

Notifications de statut en temps réel

Bonnes pratiques

Bonnes pratiques de sécurité