Obtenez votre clé API

Chaque requête vers Cosmos Pay est authentifiée par une clé API. Vous créez et gérez les clés dans le tableau de bord développeur. Une clé porte deux choses importantes : l'environnement auquel elle appartient (qui détermine testnet ou mainnet, sur tous les réseaux) et les portées qu'elle est autorisée à utiliser.

Créer une clé

1. Connectez-vous à la plateforme développeur sur dev.cosmospay.lat et ouvrez le Tableau de bord.
2. Choisissez l'environnement avec le commutateur Test / Production du tableau de bord :
   • Test délivre des clés dv_… qui s'exécutent sur le testnet ; utilisez-les pendant le développement.
   • Production délivre des clés prod_… qui s'exécutent sur le mainnet ; utilisez-les pour passer en production.
3. Allez dans API Keys → Create.
4. Donnez à la clé un nom (et une description facultative) pour pouvoir la reconnaître plus tard.
5. Choisissez un rôle :
   • User : limité. Sélectionnez exactement les permissions dont elle a besoin dans la matrice (par ressource : lecture et/ou écriture pour les paiements, webhooks, produits, clients et analyses).
   • Admin : accès complet ; il contourne la matrice de portées. À utiliser avec parcimonie.
6. Créez, puis copiez la clé immédiatement.

Utiliser la clé

Gardez la clé sur votre serveur et transmettez-la au SDK (ou envoyez-la comme jeton Bearer à l'API REST) :

import { Client } from '@cosmosapp/pay_sdk';

// Reads e.g. COSMOS_PAY_API_KEY from your server environment; never hard-code it.
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });

Authorization: Bearer dv_xxxxxxxxxxxxxxxxxxxxxxxx

Bonnes pratiques

• Une clé par environnement / service. Ne réutilisez pas une clé prod_ en test, et faites tourner les clés par service afin de pouvoir en révoquer une sans interrompre le reste.
• N'envoyez jamais une clé au navigateur. Le client web signe les transactions avec le portefeuille de l'utilisateur et n'a pas besoin de votre clé.
• Faites tourner en cas d'exposition. Si une clé fuite, faites-la tourner dans le tableau de bord : l'ancienne valeur cesse de fonctionner immédiatement.

Étapes suivantes