> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs

> Codes HTTP et format des réponses d'erreur de l'API.

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](/resources/rate-limits) |

## Format

```json theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.