Una chiave API è un codice univoco che collega il tuo account Mollie a un sito web o a un'integrazione. In precedenza elencati separatamente come "Chiavi API" e "token di accesso dell'organizzazione," ora sono riuniti in un'unica pagina denominata Chiavi API nella tua dashboard.
Conserva subito la tua chiave quando la crei. Le chiavi API e i token di accesso vengono mostrati solo una volta, al momento della creazione. Dopo che lasci la pagina, il secret non è più visibile e non può essere recuperato. Se perdi l’accesso, dovrai ruotare la tua chiave.
Chiavi API Test e Live.
Puoi utilizzare 2 diversi tipi di chiavi API: una chiave Test API e una chiave Live API:
- Chiave API di test: con questa chiave API puoi testare la connessione tra un sito web e Mollie. Nessuna commissione di transazione verrà applicata.
- Chiave API live: puoi usare questa chiave API per elaborare transazioni reali. I tuoi clienti possono effettuare pagamenti reali una volta che questa chiave è attiva.
Dove posso trovare/creare la chiave API?
Al momento puoi accedere alla pagina Chiavi API solo tramite la
Web App. Non è disponibile
su mobile.
Devi anche assicurarti di avere il giusto
ruolo
per accedere a questa pagina: al momento solo i ruoli Admin e Sviluppatore possono accedervi.
Puoi creare e gestire le tue Chiavi API nella tua Mollie Web App > nel menu di navigazione a sinistra seleziona Sviluppatori > pagina Chiavi API.
Da qui, clicca su + Crea token di accesso. Ti verrà chiesto di scegliere tra i seguenti due tipi:
- Chiave API standard – una chiave preconfigurata limitata a un profilo, disponibile in modalità Test o Live. Questa è la scelta giusta per la maggior parte delle integrazioni.
- Token di accesso avanzato – un token personalizzato dove scegli tu le autorizzazioni specifiche e l’ambito. Usalo quando hai bisogno di un controllo più granulare (questo sostituisce i precedenti "token di accesso dell’organizzazione").
Una volta che hai creato una chiave API, devi conservarla in modo sicuro, perché dopo che lasci la pagina, le chiavi non saranno più visibili nell'interfaccia e non potrai copiarle.
Se hai perso l'accesso alle tue chiavi, devi ruotare le chiavi e salvare le nuove chiavi al momento della creazione.
Rotazione della chiave API
Ora puoi creare più chiavi API per profilo, il che consente una rotazione sicura delle chiavi senza alcun downtime:
- Crea una seconda chiave API per lo stesso profilo
- Aggiorna la tua integrazione per utilizzare la nuova chiave
- Quando ti assicuri che tutto funzioni, elimina la vecchia chiave
Ho cambiato il profilo del mio sito web. Ho bisogno di una nuova chiave API?
No, quando apporti modifiche al profilo del sito, non è necessario ottenere una nuova chiave API. La tua chiave Live API rimane valida e il collegamento tra il tuo account Mollie e il tuo webshop rimarrà lo stesso.