Authentification

Deux modes : session marchand (cookie) pour le dashboard, et clé API Bearer pour /v1.

Clé API (recommandée pour l’intégration)

Passez votre clé secrète dans l’en-tête Authorization :

Authorization: Bearer sk_test_…
  • Sandbox — préfixe sk_test_
  • Production — préfixe sk_live_ (après activation)

Scopes

Les nouvelles clés reçoivent typiquement payments:write, payments:read et *. Les routes vérifient le scope requis.

Exemple

POST/v1/payments
cURL
curl -X POST http://localhost:4000/v1/payments \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: auth-demo-1" \
  -H "Content-Type: application/json" \
  -d '{"amount": 10000, "sandboxScenario": "SUCCESS"}'

Session marchand (dashboard)

Le dashboard utilise un cookie de session aifi_session. Les mutations nécessitent aussi le header CSRF x-csrf-token (valeur alignée sur le cookie aifi_csrf).

POST/api/merchant/auth/login
Body
{
  "email": "marchand@exemple.mg",
  "password": "••••••••"
}