Codes d'erreur

Toutes les erreurs retournent un objet JSON avec les champs suivants :

{
  "statusCode": 400,
  "error": "BAD_REQUEST",
  "message": "Description lisible de l'erreur"
}

Codes HTTP

Code	Signification
200	Succès
201	Créé
400	Requête invalide (paramètres manquants ou incorrects)
401	Non authentifié (clé API manquante ou invalide)
403	Non autorisé (droits insuffisants)
404	Ressource introuvable
422	Entité non traitable (validation échouée)
429	Trop de requêtes (rate limiting)
500	Erreur serveur interne

Codes d'erreur métier

Code	HTTP	Message
INVALID_API_KEY	401	Clé API manquante ou invalide / révoquée
MERCHANT_SUSPENDED	403	Votre compte marchand est suspendu. Contactez le support.
TRANSACTION_NOT_FOUND	404	Transaction introuvable
OPERATOR_NOT_FOUND	404	Opérateur inconnu ou indisponible
OPERATOR_UNAVAILABLE	503	Opérateur temporairement indisponible
INSUFFICIENT_BALANCE	422	Solde insuffisant pour effectuer cette opération
DUPLICATE_MERCHANT_REF	409	Une transaction active existe déjà avec cette référence
AMOUNT_TOO_LOW	422	Le montant minimum pour {opérateur} est de {montant} {devise}
AMOUNT_TOO_HIGH	422	Le montant maximum pour {opérateur} est de {montant} {devise}
TRANSACTION_EXPIRED	410	Ce lien de paiement a expiré
RATE_LIMIT_EXCEEDED	429	Limite de requêtes dépassée