Een API-key is een unieke code die je Mollie-account verbindt met een website of integratie. Voorheen afzonderlijk vermeld als "API-keys" en "toegangstokens voor organisaties," zijn deze nu samengevoegd op één pagina met de naam API-keys in je dashboard.
Sla je key direct op zodra je deze aanmaakt. API-keys en toegangstokens worden slechts één keer getoond, op het moment van aanmaken. Nadat je de pagina verlaat, is het secret niet meer zichtbaar en kan het niet worden teruggehaald. Als je geen toegang meer hebt, moet je je sleutel roteren.
Test en Live API-keys.
Bij ons kun je gebruikmaken van 2 verschillende soorten API keys: een Test API key en een Live API key:
- Test API key: met deze API key test je de verbinding tussen je website en Mollie. Er zijn geen transactiekosten van toepassing.
- Live API key: deze API key gebruik je om echte transacties te verwerken. Jouw klanten kunnen echte betalingen doen zodra deze sleutel actief is.
Waar vind/maak ik de API key?
Momenteel heb je alleen via de
Web App toegang tot de pagina API-keys. Deze is niet beschikbaar
op mobiel.
Je moet er ook voor zorgen dat je de juiste
rol
hebt om deze pagina te openen: alleen Admin- en Developer-rollen hebben op dit moment toegang.
Je kunt je API-keys maken en beheren in je Mollie Web App > selecteer in het linkernavigatiemenu Developers > de pagina API-keys.
Klik hier op + Toegangstoken aanmaken. Je wordt gevraagd om te kiezen tussen de volgende twee types:
- Standaard API key – een vooraf geconfigureerde key gekoppeld aan een profiel, beschikbaar in Test- of Live-modus. Dit is de juiste keuze voor de meeste integraties.
- Geavanceerde toegangstoken – een aangepaste token waarbij je zelf de specifieke rechten en reikwijdte kiest. Gebruik dit wanneer je meer gedetailleerde controle nodig hebt (deze vervangt de eerdere "organisatie toegangstokens").
Zodra je een API-sleutel hebt aangemaakt, moet je deze veilig opslaan, want nadat je de pagina hebt verlaten, zijn de sleutels niet meer zichtbaar in de UI en kun je ze niet meer kopiëren.
Als je geen toegang meer hebt tot je keys, moet je je keys roteren en de nieuwe keys bij aanmaak opslaan.
Je API key roteren
Je kunt nu meerdere API-keys per profiel aanmaken, waardoor je veilig kunt roteren zonder onderbreking:
- Maak een tweede API key aan voor hetzelfde profiel
- Werk je integratie bij om de nieuwe sleutel te gebruiken
- Verwijder de oude sleutel zodra je zeker weet dat alles werkt
Ik heb iets aangepast in mijn websiteprofiel. Heb ik nu een nieuwe API-key nodig?
Nee, als je iets wijzigt in je websiteprofiel, hoef je geen nieuwe API key aan te maken. Je live API-keys blijven geldig en de link tussen je Mollie account en je webshop blijft hetzelfde.