Codes principaux et signification
Erreurs métiers (probable de rencontrer dans les cas de bad request)
Bonnes pratiques liées aux codes HTTP
Ne pas confondre HTTP et erreurs métier
HTTP 200 peut contenir un state: FAILED dans la réponse JSON si la
transaction a échoué. Les champs state,
response, et error doivent
toujours être vérifiés après une réponse HTTP 200.Gérer les erreurs réseau et serveur
Si l’API retourne une erreur 500 dans le cas d’un paiement (erreur interne
du serveur), il est recommandé de relancer automatiquement la requête après
un délai, en augmentant progressivement le temps d’attente entre chaque
tentative (backoff progressif). Dans le cas d’un transfert, il recommandé de
faire une vérification manuel avant de relancer la transaction.
Valider les entrées avant l'envoi
Vérifier les paramètres requis avant l’envoi de la requête surtout le
service_id et votre api_key.Journaliser les erreurs HTTP
Conserver le transaction_id, le code HTTP et le message de la réponse pour
faciliter les réclamations.
Les codes HTTP indiquent l’état de la requête HTTP, pas nécessairement le
résultat de la transaction. Toujours vérifier le champ
state dans la réponse
JSON pour connaître le statut réel de la transaction.