> ## 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. Elle n'a rien à faire ailleurs que sur votre serveur.

## Envoyer la clé

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

```bash theme={null}
# 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 | Message | Cause |
| - | - | - |
| `401` | `API key manquante.` | Aucune clé fournie |
| `401` | `API key invalide ou révoquée.` | Clé inconnue ou révoquée |
| `403` | `Ce compte marchand est suspendu.` | Marchand suspendu |
| `403` | `Le mode live nécessite un KYC approuvé…` | Clé live avant approbation du KYC |

## Révoquer une clé

Depuis **Clés API** dans votre tableau de bord. L'effet est immédiat : la requête suivante avec cette clé échoue déjà avec `401`, pas besoin d'attendre une quelconque propagation.


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