Chiavi di Licenza

Rilascia chiavi uniche per il tuo software o beni digitali, controlla le attivazioni e revoca l’accesso quando necessario. Le chiavi di licenza si abbinano bene ad abbonamenti e acquisti una tantum.

Cosa Sono le Chiavi di Licenza?

Le chiavi di licenza sono token unici che autorizzano l’accesso al tuo prodotto. Sono ideali per:

Licenze software: App desktop, plugin e CLI
Controlli per utente: Limita le attivazioni per utente o dispositivo
Beni digitali: Regola download, aggiornamenti o funzionalità premium

Vantaggi Chiave

Controllo accessi: Definisci scadenze e limiti di attivazione
Visibilità operativa: Monitora utilizzo, dispositivi e cronologia
Sicurezza e supporto: Disabilita, riabilita e audita rapidamente

Creazione di Chiavi di Licenza

Create a License Key

Vai al tuo cruscotto Dodo Payments e apri la sezione License Keys. Seleziona l’opzione per creare una nuova chiave di licenza.

Configure License Key Settings

Imposta come verranno rilasciate e usate le tue chiavi di licenza specificando questi campi:

License Key Expiry Date: Definisci per quanto tempo la chiave rimane valida. Scegli una durata specifica (per esempio, 30 giorni o 1 anno), oppure seleziona “no expiry” per una chiave perpetua.
Activation Limit: Imposta il numero massimo di attivazioni contemporanee per chiave. Usa un numero specifico per scenari come licenze mono-utente (1) o per team (5), oppure seleziona “unlimited” per non avere limiti di attivazione.
Activation Instructions: Fornisci istruzioni di attivazione chiare per i tuoi clienti, che saranno inviate via email insieme alla chiave di licenza. Esempi: “Incolla la chiave in Impostazioni → Licenza” oppure “Esegui: mycli activate <key>”.

Review and Save

Controlla tutti i dettagli inseriti. Quando sei pronto, salva la configurazione della chiave di licenza per completare la creazione.

Usa istruzioni realistiche e includi link di supporto per ridurre i ticket di attivazione.

Creazione di una chiave di licenza nel cruscotto di Dodo Payments

Gestisci e Monitora

La Sezione Chiavi di Licenza fornisce una vista completa di tutte le attività delle chiavi di licenza e ti consente di gestire e monitorare le licenze in modo efficace.

Informazioni Chiave

Visualizza informazioni dettagliate per ogni chiave di licenza:

Dettagli della Chiave: Valore della chiave di licenza, nome del prodotto associato, dettagli del cliente (customer_id) e data di acquisto
Attività di Utilizzo: Numero di attivazioni, date e orari di attivazione e stato (attivo, scaduto, disabilitato)
Scadenza e Limiti: Data di scadenza della chiave, conteggio delle attivazioni rimanenti e istanze di attivazione attuali

Azioni Disponibili

Puoi eseguire le seguenti azioni sulle chiavi di licenza:

Disabilita Chiave di Licenza: Disabilita immediatamente una chiave per prevenire ulteriori utilizzi
Abilita Chiave: Riabilita una chiave di licenza precedentemente disabilitata
Visualizza Istanze di Attivazione: Vedi tutte le istanze di attivazione associate a una particolare chiave di licenza

Vantaggi

Monitora l’attività delle chiavi di licenza in tempo reale
Identifica potenziali abusi o attivazioni non autorizzate
Semplifica il supporto clienti fornendo registri dettagliati di utilizzo in caso di discrepanza

Gestione API

Utilizza queste API per attivare, convalidare, elencare e aggiornare le chiavi di licenza e le loro istanze di attivazione.

Public Endpoints: gli endpoint di attivazione, disattivazione e validazione delle licenze sono pubblici e non richiedono un’API key. Questo ti permette di chiamarli direttamente dalle tue applicazioni client, dal software desktop o dalle CLI senza esporre le tue credenziali API.

Lifecycle Operations

Avvia azioni di attivazione, disattivazione e validazione sulle chiavi di licenza.

Activate License

Crea o registra un’istanza di attivazione per una chiave di licenza.

Deactivate License

Revoca un’attivazione precedente per liberare capacità.

Validate License

Verifica autenticità, stato e vincoli prima di concedere l’accesso.

License Key Management

Elenca, recupera e aggiorna le chiavi di licenza con le rispettive impostazioni e stato.

List License Keys

Esplora tutte le chiavi con dettagli su stato e utilizzo.

Get License Key

Recupera una chiave specifica e i suoi metadata.

Update License Key

Modifica la scadenza, i limiti di attivazione o abilita/disabilita una chiave.

Activation Instances

Lavora con le singole attivazioni dei dispositivi per ciascuna chiave.

List Instances

Restituisci tutte le istanze di attivazione per una chiave specifica.

Get Instance

Recupera i dettagli di una singola istanza di attivazione.

Update Instance

Revoca o aggiorna le informazioni del dispositivo per un’istanza.

Esempi di Integrazione

Attiva una licenza

Questi endpoint non richiedono un’API key e possono essere chiamati direttamente dalle tue applicazioni client.

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.activate({ 
  license_key: 'license_key', 
  name: 'Device Name' 
});

console.log(response.id);

Convalida una licenza

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.validate({ 
  license_key: '2b1f8e2d-c41e-4e8f-b2d3-d9fd61c38f43' 
});

console.log(response.valid);