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. Elle n’a rien à faire ailleurs que 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	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.