API-avain on yksilöllinen koodi, joka yhdistää Mollie-tilisi verkkosivustoon tai integraatioon. Aiemmin erikseen nimillä "API-avaimet" ja "Organisaation käyttöoikeustunnukset" luetellut ovat nyt yhdistetty yhdelle sivulle, jonka nimi on API-avaimet hallintapaneelissasi.
Tallenna avain välittömästi sen luomisen yhteydessä. API-avaimet ja käyttöoikeustunnukset näytetään vain kerran, niiden luomishetkellä. Kun poistut sivulta, salaisuus ei ole enää näkyvissä eikä sitä voi hakea takaisin. Jos menetät pääsyn, sinun täytyy vaihtaa avain.
Testi- ja live-API-avaimet.
Voit käyttää 2 erilaista API-avainta: Testi API-avainta ja Live API-avainta:
- Testi-API-avain: tällä API-avaimella voit testata yhteyttä verkkosivun ja Mollien välillä. Yhtään tapahtuman maksua ei peritä.
- Live-API-avain: voit käyttää tätä API-avainta käsitelläksesi oikeita tapahtumia. Asiakkaasi voivat tehdä todellisia maksuja, kun tämä avain on aktiivinen.
Mistä löydän/voin luoda API-avaimen?
Tällä hetkellä pääset API-avaimet-sivulle vain
Web Appin kautta. Se ei ole saatavilla
mobiililaitteella.
Sinun on myös varmistettava, että sinulla on oikea
rooli
käyttääksesi tätä sivua: vain Ylläpitäjä- ja Kehittäjä-roolit voivat käyttää sitä tällä hetkellä.
Voit luoda ja hallita API-avaimiasi Mollie Web Appissa > valitse vasemmasta navigointivalikosta Kehittäjät > API-avaimet-sivu.
Täällä napsauta + Luo access token. Sinulta pyydetään valitsemaan kahdesta vaihtoehdosta:
- Vakiomuotoinen API-avain – esiasetettu avain, jolla on tietty profiili ja joka on käytettävissä Testaus- tai Live-tilassa. Tämä on oikea valinta useimpiin integraatioihin.
- Edistynyt access token – mukautettu tunniste, jossa voit määrittää käyttöoikeudet ja laajuuden itse. Käytä tätä, kun tarvitset tarkempaa hallintaa (korvaa aiemmat "organisaation access tokenit").
Kun olet luonut API-avaimen, sinun tulee tallentaa se turvallisesti, sillä poistuttuasi sivulta avaimet eivät enää näy käyttöliittymässä etkä voi kopioida niitä.
Jos menetät pääsyn avaimiisi, sinun on kierrätettävä avaimet ja tallennettava uudet avaimet niiden luomisen yhteydessä.
API-avaimen kierrätys
Nyt voit luoda useita API-avaimia per profiili, mikä mahdollistaa avainten turvallisen kierrätyksen ilman käyttökatkosta:
- Luo toinen API-avain samalle profiilille
- Päivitä integraatiosi käyttämään uutta avainta
- Kun olet varmistanut, että se toimii, poista vanha avain
Muutin verkkosivustoprofiilini. Tarvitsenko uuden API-avaimen?
Ei, kun teet muutoksia verkkosivuprofiiliisi, sinun ei tarvitse hankkia uutta API-avainta. Live API-avaimesi pysyy voimassa ja yhteys Mollie-tilisi ja verkkokauppasi välillä pysyy samana.