Gérez correctement les erreurs de validation, d’authentification, de provider et de limites.

Gestion des erreurs

Votre intégration doit traiter les réponses d’erreur comme des signaux opérationnels, pas seulement comme des statuts HTTP.

Format d’erreur

{
  "message": "Error description",
  "errors": {
    "field": ["Error message"]
  }
}

Code	Signification
400	Requête invalide ou mal formée
401	Authentification absente ou invalide
403	Requête bloquée, y compris certains cas de limites
404	Ressource introuvable
422	Erreur de validation
500	Erreur interne
502	Erreur provider ou upstream

{
  "message": "No application found."
}

{
  "message": "Validation failed",
  "errors": {
    "amount": ["The amount must be at least 100"]
  }
}

Une initiation de paiement peut aussi échouer à cause des limites KYC ou AML.

Traitez ces cas comme des échecs métier nécessitant :

notification côté merchant

revue du compte

éventuelle escalade KYC

loggez toujours external_id, track_id et l’endpoint ensemble

distinguez validation et erreurs retryables

ne retryez que les erreurs transitoires

ne retryez pas aveuglément un refus dû au KYC ou aux limites

gardez la réconciliation séparée du flux request-response