Passer au contenu principal
Attribuez des clés uniques à votre logiciel ou à vos biens numériques, contrôlez les activations et révoquez l’accès en cas de besoin. Les clés de licence s’accordent parfaitement aux abonnements et aux achats ponctuels.

​
Qu’est-ce que les clés de licence ?

Les clés de licence sont des jetons uniques qui autorisent l’accès à votre produit. Elles sont idéales pour :
  • Licences de logiciel : Applications de bureau, plugins et CLIs
  • Contrôles par utilisateur : Limitez les activations par utilisateur ou appareil
  • Biens numériques : Restreindre les téléchargements, mises à jour ou fonctionnalités premium

​
Avantages clés

  • Contrôle d’accès : Définissez des limites d’expiration et d’activation
  • Visibilité opérationnelle : Suivez l’utilisation, les appareils et l’historique
  • Sécurité et support : Désactivez, réactivez et auditez rapidement

​
Création de clés de licence

1

Create a License Key

Accédez à votre tableau de bord Dodo Payments et ouvrez la section Clés de licence. Choisissez l’option permettant de créer une nouvelle clé de licence.
2

Configure License Key Settings

Définissez la manière dont vos clés de licence seront émises et utilisées en précisant les champs suivants :
  • Date d’expiration de la clé de licence : Déterminez combien de temps la clé reste valide. Choisissez une durée spécifique (par exemple, 30 jours ou 1 an), ou sélectionnez « sans expiration » pour une clé perpétuelle.
  • Limite d’activation : Indiquez le nombre maximal d’activations simultanées par clé. Utilisez un nombre précis pour des scénarios comme une licence mono-utilisateur (1) ou une licence d’équipe (5), ou choisissez « illimité » pour aucune limite d’activation.
  • Instructions d’activation : Fournissez des étapes d’activation claires pour vos clients, qui seront également envoyées par e-mail avec la clé de licence. Exemples : « Collez la clé dans Paramètres → Licence » ou « Exécutez : mycli activate <key> ».
3

Review and Save

Vérifiez toutes les informations saisies. Lorsque vous êtes prêt, enregistrez la configuration de la clé de licence pour terminer la création de la clé.
Utilisez des instructions réalistes et incluez des liens d’assistance pour réduire les tickets d’activation.
Création d’une clé de licence dans le tableau de bord Dodo Payments

​
Gérer et surveiller

La section Clés de licence fournit une vue d’ensemble complète de toute l’activité des clés de licence et vous permet de gérer et de surveiller les licences efficacement.

​
Informations clés

Consultez des informations détaillées pour chaque clé de licence :
  • Détails de la clé : Valeur de la clé de licence, nom du produit associé, détails du client (customer_id) et date d’achat
  • Activité d’utilisation : Nombre d’activations, dates et heures d’activation, et statut (actif, expiré, désactivé)
  • Expiration et limites : Date d’expiration de la clé, nombre d’activations restantes et instances d’activation actuelles
Détails de la clé de licence

​
Actions disponibles

Vous pouvez effectuer les actions suivantes sur les clés de licence :
  • Désactiver la clé de licence : Désactivez immédiatement une clé pour empêcher toute utilisation ultérieure
  • Activer la clé : Réactivez une clé de licence précédemment désactivée
  • Voir les instances d’activation : Consultez toutes les instances d’activation associées à une clé de licence particulière
Actions de la clé de licence

​
Avantages

  • Suivez l’activité des clés de licence en temps réel
  • Identifiez les abus potentiels ou les activations non autorisées
  • Simplifiez le support client en fournissant des enregistrements d’utilisation détaillés en cas de divergence

​
Gestion de l’API

Utilisez ces API pour activer, valider, lister et mettre à jour les clés de licence et leurs instances d’activation.
Points de terminaison publics : les points de terminaison d’activation, de désactivation et de validation des licences sont publics et ne nécessitent pas de clé API. Cela vous permet de les appeler directement depuis vos applications clientes, logiciels de bureau ou CLI sans exposer vos identifiants API.

​
Exemples d’intégration

​
Activer une licence

Ces points de terminaison ne requièrent pas de clé API et peuvent être appelés directement depuis vos applications clientes.
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);

​
Valider une licence

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);

​
Clés de licence dans l’URL de retour

Lorsque qu’un client termine un achat pour un produit avec les clés de licence activées, la clé de licence est automatiquement ajoutée à votre return_url en tant que paramètre de requête. Cela vous permet d’afficher la clé immédiatement sur votre page de réussite sans effectuer un appel API supplémentaire. 
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com
Si l’achat génère plusieurs clés de licence (par exemple, quantité > 1), elles sont séparées par des virgules : 
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com
Pour les abonnements, subscription_id est utilisé à la place de payment_id : 
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com
Analysez le paramètre license_key sur votre page de retour pour afficher immédiatement la clé aux clients, améliorant ainsi l’expérience post-achat.

​
Bonnes pratiques

  • Clarifiez les limites : Choisissez des valeurs par défaut raisonnables pour la durée de validité et les activations
  • Guideez les utilisateurs : Fournissez des instructions d’activation précises et une documentation en libre-service
  • Automatisez les vérifications : Validez les clés côté serveur avant d’accorder l’accès
  • Surveillez les événements : Utilisez des webhooks pour détecter les usages abusifs et automatiser les révocations