> ## 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.

# Authentification

> Authentifiez chaque requête avec une clé API sandbox ou live.

Toutes les requêtes vers `/api/v1` doivent porter une clé API. Son préfixe seul suffit à identifier l'environnement : `mp_sandbox_9Kd2…` ne déplace jamais d'argent réel, `mp_live_…` oui, et seulement une fois votre KYC approuvé. Ne mettez jamais une clé live côté navigateur. Gardez-la sur votre serveur.

## Envoyer la clé

Deux en-têtes sont acceptés, au choix :

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# En-tête Authorization
curl https://mercy-pay.com/api/v1/account \
  -H "Authorization: Bearer mp_sandbox_XXXXXXXXXXXXXXXX"

# En-tête X-Api-Key
curl https://mercy-pay.com/api/v1/account \
  -H "X-Api-Key: mp_sandbox_XXXXXXXXXXXXXXXX"
```

## Erreurs d'authentification

| Statut | `error.code` | Message | Cause |
| - | - | - | - |
| `401` | `api_key_missing` | `Clé API manquante.` | Aucune clé fournie |
| `401` | `api_key_invalid` | `Clé API invalide ou révoquée.` | Clé inconnue ou révoquée |
| `403` | `merchant_suspended` | `Ce compte marchand est suspendu.` | Marchand suspendu |
| `403` | `live_mode_requires_kyc` | `Le mode live nécessite un KYC approuvé…` | Clé live avant approbation du KYC |

## Révoquer une clé

Ouvrez l'onglet **Clés API** de la [console Développeurs](https://docs.mercy-pay.com/developers/console.md). L'effet est immédiat : la requête suivante avec cette clé reçoit un `401`.


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