Authentification

Chaque requête identifie votre compte avec une clé publique :

X-Public-Key: pk_your_public_key
Content-Type: application/json

La clé peut être incluse sans risque dans un bundle côté navigateur. Elle permet de créer des paiements et de lire un paiement à partir de son ID, mais elle ne peut pas déplacer de fonds, modifier vos wallets de règlement ni accéder aux données d’un autre marchand. Les lectures à l’échelle du compte utilisent à la place votre clé API et votre secret.

curl https://hub.stablezact.com/api/v1/networks \
  -H "X-Public-Key: pk_your_public_key"

Clé API et secret

Les lectures à l’échelle du compte, à savoir la liste des paiements (/payments/merchant/list) et les statistiques de paiement (/payments/merchant/stats), s’authentifient avec votre clé API et votre secret, disponibles dans Dashboard, Settings, API :

X-API-Key: your_api_key
X-API-Secret: your_api_secret
Content-Type: application/json

• Envoyez-les uniquement depuis votre serveur. Le secret ne doit jamais atteindre un navigateur.
• Envoyez ces deux en-têtes sans X-Public-Key. Lorsqu’une clé publique est présente, la requête est authentifiée avec la clé publique à la place.
• La clé et le secret lisent toujours les données du mode live.

curl https://hub.stablezact.com/api/v1/payments/merchant/stats \
  -H "X-API-Key: $STABLEZACT_API_KEY" \
  -H "X-API-Secret: $STABLEZACT_API_SECRET"

Les appels à ces deux routes avec une clé publique seule fonctionnent encore pour l’instant, et la réponse comporte un en-tête Deprecation: true. Passez-les à la clé API et au secret. Les intégrations qui envoient déjà la clé et le secret à chaque requête continuent de fonctionner.

Identifiants manquants ou invalides

{
  "error": "API credentials required. Use x-public-key header or x-api-key and x-api-secret headers."
}

Renvoyé avec 401.