Authentification - Mercy Pay

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 :

# 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. L’effet est immédiat : la requête suivante avec cette clé reçoit un 401.