Une clé API est un code unique qui connecte votre compte Mollie à un site web ou à une intégration. Précédemment répertoriés séparément comme "Clés API" et "jetons d’accès à l’organisation," ils sont désormais regroupés sur une seule page appelée Clés API dans votre tableau de bord.
Stockez votre clé immédiatement lors de sa création. Les clés API et les jetons d’accès ne sont affichés qu’une seule fois, au moment de leur création. Après avoir quitté la page, la clé secrète n'est plus visible et ne peut pas être récupérée. Si vous perdez l'accès, il sera nécessaire de remplacer votre clé.
Clés API test et live.
Vous pouvez utiliser deux types de clé API, la clé API test et la clé API live.
- Clé API test : cette clé API vous permet de tester la connexion entre votre page internet et Mollie. Aucun frais de transaction ne s'applique.
- Clé API live : utilisez cette clé API pour réaliser des transactions réelles. Vos clients peuvent effectuer de véritables paiements une fois que cette clé est active.
Où puis-je trouver/créer les clés API ?
Actuellement vous pouvez uniquement accéder à la page des
Clés API via l’application Web. Elle n'est pas disponible
sur mobile.
Vous devez également vous assurer de disposer du bon
rôle
pour accéder à cette page : seuls les rôles Administrateur et Développeur peuvent y accéder pour le moment.
Vous pouvez créer et gérer vos Clés API dans votre application Web Mollie > dans le menu de navigation de gauche sélectionnez Développeurs > la page Clés API.
À partir d'ici, cliquez sur + Créer un jeton d'accès. Il vous sera demandé de choisir entre les deux types suivants :
- Clé API standard – une clé préconfigurée associée à un profil, disponible en mode Test ou Live. C'est le bon choix pour la plupart des intégrations.
- Jeton d'accès avancé – un jeton personnalisé pour lequel vous choisissez les autorisations spécifiques et la portée. Utilisez ceci lorsque vous avez besoin d'un contrôle plus granulaire (cela remplace les anciens « jetons d'accès organisationnels »).
Une fois que vous avez créé une clé API, vous devez ensuite la stocker en toute sécurité, car après avoir quitté la page, les clés ne seront plus visibles dans l’interface utilisateur et vous ne pourrez pas les copier.
Si vous avez perdu l’accès à vos clés, vous devez les faire tourner et enregistrer les nouvelles clés lors de leur création.
Rotation de votre clé API
Vous pouvez maintenant créer plusieurs Clés API par profil, ce qui permet une rotation sécurisée des clés sans interruption :
- Créez une deuxième clé API pour le même profil
- Mettez à jour votre intégration pour utiliser la nouvelle clé
- Une fois son bon fonctionnement vérifié, supprimez l'ancienne clé
J'ai modifié le profil de mon site Web. Ai-je besoin d'une nouvelle clé API ?
Non, lorsque vous apportez des modifications à votre profil du site, il n'est pas nécessaire d'obtenir une nouvelle clé API. Votre clé API en direct reste valide et le lien entre votre compte Mollie et votre boutique en ligne restera le même.