Logo GenukaGenuka Pay
Guides

Gérer les clés API

Gérez vos credentials d'application Genuka Pay de manière sécurisée depuis le dashboard et les workflows opérationnels.

Introduction

Genuka Pay est conçu pour être géré depuis le dashboard en priorité, pas en copiant-collant des credentials bruts dans des scripts ad hoc.

Révéler les credentials

Inspectez vos clés d'application actuelles depuis le flux protégé du dashboard.

Renouveler les clés

Générez une nouvelle clé secrète ; l'ancienne cesse aussitôt de fonctionner.

Gérer la visibilité

Masquez ou révélez votre secret_key pour éviter l'exposition accidentelle.

Où les gérer

Ouvrez la page API Keys depuis le dashboard.

Cette page est le point d'entrée opérationnel pour votre équipe.

Ce que vous pouvez faire

  • Voir le public_key - identifiez votre application
  • Révéler ou masquer le secret_key - contrôlez la visibilité
  • Copier les clés - utilisez-les dans vos intégrations
  • Renouveler - générez une nouvelle secret_key, qui remplace l'ancienne immédiatement

Bonnes pratiques pour les credentials

Stockage

  • ✅ Stockez le secret_key en tant que variable d'environnement côté serveur uniquement
  • ❌ Ne l'engagez jamais dans votre dépôt source
  • ❌ Ne l'envoyez jamais au navigateur ou à un client JavaScript
  • ❌ Ne le partagez jamais en texte brut par email ou chat

Rotation

Renouvelez votre clé régulièrement (tous les 3-6 mois), et immédiatement en cas de doute :

  1. Préparez le déploiement : la nouvelle clé devra être en place dans vos services sans délai
  2. Ouvrez la page API Keys et cliquez sur "Rotate"
  3. Une nouvelle secret_key est générée et remplace l'ancienne immédiatement : il n'y a pas de période de grâce, les requêtes signées avec l'ancienne échouent en 401 dès cet instant
  4. Mettez à jour vos services avec la nouvelle secret_key — la public_key, elle, ne change pas

Chaque environnement (SANDBOX, LIVE) a sa propre paire de clés et se renouvelle séparément. Les clés secrètes commencent par sk_test_ en sandbox et sk_live_ en live ; les clés publiques par pk_test_ et pk_live_.

Les endpoints /api/v1/application qu'utilise le dashboard n'acceptent que la session du dashboard : ils ne peuvent pas être appelés avec une clé API.

Utilisation

Toutes les requêtes authentifiées requirent :

X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATURE

Utilisez les SDKs officiels pour gérer automatiquement cette logique.

Scope des permissions

Actuellement, chaque application a accès complet à tous les endpoints. Les permissions granulaires par scope seront disponibles dans les futures versions.

How is this guide?

Last updated on