Erreurs - Mercy Pay

Une erreur se reconnaît toujours de la même façon : un code HTTP qui dit quoi, et un corps JSON qui dit pourquoi.

Codes HTTP

Code	Signification
`401`	Clé absente, invalide ou révoquée
`403`	Compte suspendu, ou clé live avant approbation du KYC
`404`	Ressource inconnue, ou appartenant à un autre marchand
`409`	Clé d’idempotence déjà utilisée avec un autre contenu
`422`	Données invalides
`429`	Trop de requêtes, voir Limites de débit

Format

{
  "message": "Le champ amount est obligatoire.",
  "errors": {
    "amount": ["Le champ amount est obligatoire."]
  }
}

errors n’apparaît que pour les erreurs 422. message est écrit pour un humain, autant l’afficher tel quel à votre utilisateur. Mais ne faites jamais dépendre votre logique de son texte exact : fiez-vous au code HTTP.

Erreurs métier fréquentes

Message	Cause
`Solde disponible insuffisant pour ce montant.`	Le solde du pays et de l’opérateur ne couvre pas le payout
`Opérateur Mobile Money invalide pour ce pays.`	Code opérateur incohérent avec le pays
`Cette devise ne figure pas dans la norme ISO 4217.`	Code devise inconnu
`Ce moyen de paiement n'est pas disponible pour le moment.`	Aucun taux de conversion disponible vers la devise de l’opérateur mobile money choisi
`Le montant minimum pour un paiement par carte est de 0.50 USD.`	Montant sous le minimum carte