Requires keys:write and verified MFA. Permissions cannot exceed creator rights; keys:write and team:write are forbidden. Secret shown once. Expires in 90 days.

En-têtes

AuthorizationBearer pos_key_…obligatoire: Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire: L’espace marchand concerné (mrc_…).

Corps

namestringobligatoire
permissionsliste de "payments:read" | "payments:write" | "refunds:write" | "connections:write" | "team:write" | "keys:write" | "audit:read"obligatoire

Réponses

201Créé
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
429Trop de demandes, réessayez plus tard
500Request rejected; no success is implied.

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.

Requête

curl -X POST "$PAYMENT_OS_API/v1/api-keys" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -d '{ "name": "…", "permissions": [] }'