Clés API
Les clés API authentifient vos requêtes vers l’API Ikawaari.
Types de clés
| Préfixe | Environnement | Usage |
|---|---|---|
ik_test_ | Sandbox | Test et développement |
ik_live_ | Live | Transactions de production |
Créer une clé API
- Allez dans Developers → API Keys
- Cliquez sur Create API key
- Nommez votre clé et sélectionnez les scopes
- Copiez la clé complète — elle n’est affichée qu’une seule fois
attention
Stockez vos clés API de manière sécurisée. Ne les exposez jamais dans du code côté client, des dépôts publics ou des logs.
Scopes de clé
Contrôlez ce à quoi chaque clé API peut accéder :
| Scope | Description |
|---|---|
payments:read | Voir les paiements |
payments:write | Créer et gérer les paiements |
customers:read | Voir les clients |
customers:write | Créer et gérer les clients |
webhooks:read | Voir les webhooks |
webhooks:write | Créer et gérer les webhooks |
refunds:write | Émettre des remboursements |
reports:read | Voir les rapports |
Voir Scopes de clé API pour la liste complète.
Rotation d’une clé
Si une clé est compromise, faites une rotation pour en générer une nouvelle tout en révoquant l’ancienne :
- Allez dans Developers → API Keys
- Cliquez sur le menu ⋯ de la clé
- Sélectionnez Roll key
L’ancienne clé est immédiatement révoquée et une nouvelle est générée.
Limites de débit
Chaque clé API a une limite de débit configurable (par défaut : 100 requêtes/minute). Voir Rate Limits.