Passer au contenu principal
L’API Yabetoo utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l’échec d’une requête API.

​
Codes de statut HTTP

CodeStatutDescription
200OKRequête réussie
201CreatedRessource créée avec succès
400Bad RequestParamètres de requête invalides
401UnauthorizedClé API invalide ou manquante
403ForbiddenPermissions insuffisantes
404Not FoundRessource inexistante
429Too Many RequestsLimite de requêtes dépassée
500Internal Server ErrorErreur 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é :
CodeDescription
LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWEDLe 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
TIMEOUTLe 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

  1. Gérez toujours les erreurs gracieusement - N’exposez jamais les messages d’erreur bruts aux utilisateurs finaux
  2. Journalisez les erreurs pour le débogage - Stockez les détails d’erreur pour le dépannage
  3. Implémentez une logique de retry - Pour les limites de taux et les échecs temporaires
  4. Validez avant d’envoyer - Vérifiez les paramètres côté client pour réduire les erreurs
Si vous rencontrez des erreurs persistantes, contactez [email protected] avec les détails de l’erreur.