Claves de Licencia

Emite claves únicas para tu software o productos digitales, controla activaciones y revoca el acceso cuando sea necesario. Las claves de licencia combinan bien con suscripciones y compras únicas.

¿Qué Son las Claves de Licencia?

Las claves de licencia son tokens únicos que autorizan el acceso a tu producto. Son ideales para:

Licenciamiento de software: Aplicaciones de escritorio, plugins y CLIs
Controles por asiento: Limitar activaciones por usuario o dispositivo
Bienes digitales: Restringir descargas, actualizaciones o características premium

Beneficios Clave

Control de acceso: Define fechas de caducidad y límites de activación
Visibilidad operativa: Rastrear uso, dispositivos e historial
Seguridad y soporte: Desactivar, reactivar y auditar rápidamente

Creando Claves de Licencia

Create a License Key

Ve al panel de Dodo Payments y abre la sección Claves de licencia. Selecciona la opción para crear una nueva clave de licencia.

Configure License Key Settings

Establece cómo se emitirán y usarán tus claves de licencia especificando estos campos:

Fecha de caducidad de la clave de licencia: Define cuánto tiempo permanece válida la clave. Elige una duración específica (por ejemplo, 30 días o 1 año), o selecciona “sin caducidad” para una clave perpetua.
Límite de activaciones: Establece el número máximo de activaciones concurrentes por clave. Usa un número específico para escenarios como licencias de un solo usuario (1) o de equipo (5), o selecciona “ilimitado” para no tener un límite de activaciones.
Instrucciones de activación: Proporciona pasos claros de activación para tus clientes, que también se enviarán por correo electrónico junto con la clave de licencia. Ejemplos: “Pega la clave en Configuración → Licencia” o “Ejecuta: mycli activate <key>”.

Review and Save

Revisa todos los datos ingresados. Cuando estés listo, guarda la configuración de la clave de licencia para finalizar la creación de la clave.

Usa instrucciones realistas e incluye enlaces de soporte para reducir los tickets de activación.

Creación de una clave de licencia en el panel de Dodo Payments

Gestionar y Monitorear

La Sección de Claves de Licencia proporciona una vista completa de toda la actividad de las claves de licencia y te permite gestionar y monitorear las licencias de manera efectiva.

Información Clave

Ve información detallada para cada clave de licencia:

Detalles de la Clave: Valor de la clave de licencia, nombre del producto asociado, detalles del cliente (customer_id) y fecha de compra
Actividad de Uso: Número de activaciones, fechas y horas de activación, y estado (activo, caducado, deshabilitado)
Caducidad y Límites: Fecha de caducidad de la clave, conteo de activaciones restantes y instancias de activación actuales

Acciones Disponibles

Puedes realizar las siguientes acciones en las claves de licencia:

Deshabilitar Clave de Licencia: Deshabilita inmediatamente una clave para evitar su uso posterior
Habilitar Clave: Reactiva una clave de licencia que fue deshabilitada previamente
Ver Instancias de Activación: Ver todas las instancias de activación asociadas a una clave de licencia particular

Beneficios

Rastrear la actividad de la clave de licencia en tiempo real
Identificar posibles abusos o activaciones no autorizadas
Simplificar el soporte al cliente proporcionando registros de uso detallados en caso de discrepancias

Gestión de API

Utiliza estas APIs para activar, validar, listar y actualizar claves de licencia y sus instancias de activación.

Endpoints públicos: los endpoints de activación, desactivación y validación de licencias son públicos y no requieren una clave de API. Esto te permite llamarlos directamente desde tus aplicaciones cliente, software de escritorio o CLI sin exponer tus credenciales de API.

Lifecycle Operations

Activa, desactiva y valida acciones sobre claves de licencia.

Activate License

Crea o registra una instancia de activación para una clave de licencia.

Deactivate License

Revoca una activación anterior para liberar capacidad.

Validate License

Verifica la autenticidad, el estado y las restricciones antes de otorgar acceso.

License Key Management

Lista, recupera y actualiza claves de licencia con sus configuraciones y estado.

List License Keys

Explora todas las claves con detalles de estado y uso.

Get License Key

Recupera una clave específica y sus metadatos.

Update License Key

Modifica la caducidad, los límites de activación o habilita/deshabilita una clave.

Activation Instances

Trabaja con activaciones de dispositivos individuales para cada clave.

List Instances

Devuelve todas las instancias de activación para una clave específica.

Get Instance

Obtén detalles de una sola instancia de activación.

Update Instance

Revoca o actualiza la información del dispositivo para una instancia.

Ejemplos de Integración

Activar una licencia

Estos endpoints no requieren una clave de API y pueden ser llamados directamente desde tus aplicaciones cliente.

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

Validar una licencia

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