Gestion des erreurs

Codes de statut HTTP

Code	Statut	Description
`200`	OK	Requête réussie
`201`	Created	Ressource créée avec succès
`400`	Bad Request	Paramètres de requête invalides
`401`	Unauthorized	Clé API invalide ou manquante
`403`	Forbidden	Permissions insuffisantes
`404`	Not Found	Ressource inexistante
`429`	Too Many Requests	Limite de requêtes dépassée
`500`	Internal Server Error	Erreur côté serveur

Codes d’erreur de paiement

Lorsqu’un paiement échoue, l’API renvoie des codes d’erreur spécifiques pour vous aider à comprendre ce qui s’est passé :

Code	Description
`LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWED`	Le client n’a pas assez de fonds, a atteint sa limite de transaction, ou la transaction n’est pas autorisée par l’opérateur
`TIMEOUT`	Le client n’a pas confirmé le paiement à temps (n’a pas entré son code PIN)

Exemple de réponse d’erreur

{
  "error": {
    "message": "LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWED",
    "code": "LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWED"
  }
}

Bonnes pratiques

Gérez toujours les erreurs gracieusement - N’exposez jamais les messages d’erreur bruts aux utilisateurs finaux

Journalisez les erreurs pour le débogage - Stockez les détails d’erreur pour le dépannage

Implémentez une logique de retry - Pour les limites de taux et les échecs temporaires

Validez avant d’envoyer - Vérifiez les paramètres côté client pour réduire les erreurs

Si vous rencontrez des erreurs persistantes, contactez support@yabetoopay.com avec les détails de l’erreur.

Documentation API

Session de paiement

Intention de paiement

Décaissement

Transfert

Lien de paiement

Webhook

Codes de statut HTTP

Codes d’erreur de paiement

Exemple de réponse d’erreur

Bonnes pratiques

​Codes de statut HTTP

​Codes d’erreur de paiement

​Exemple de réponse d’erreur

​Bonnes pratiques

Codes de statut HTTP

Codes d’erreur de paiement

Exemple de réponse d’erreur

Bonnes pratiques