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.

Creando una clave de licencia en el panel de control de Dodo Payments

Importar Claves de Licencia a través de la API

¿Ya tienes claves de licencia en otro sistema? Usa la API Crear Clave de Licencia para importarlas a Dodo Payments. Esto te permite migrar las claves existentes sin interrumpir a tus clientes.

Las claves de licencia creadas o actualizadas a través de la API no activan notificaciones por correo electrónico a los clientes. Si necesitas notificar a los clientes sobre su clave de licencia, debes gestionar esto por separado en tu aplicación.

import DodoPayments from 'dodopayments';

const client = new DodoPayments();

const licenseKey = await client.licenseKeys.create({
  customer_id: 'cust_123',
  product_id: 'prod_456',
  key: 'YOUR-EXISTING-LICENSE-KEY',
  activations_limit: 5,
  expires_at: '2026-12-31T23:59:59Z',
});

console.log(licenseKey.id);

También puedes usar este endpoint para crear programáticamente nuevas claves de licencia con valores personalizados, límites de activación y fechas de expiración — útil para aprovisionamiento masivo o flujos de trabajo de licencias empresariales.

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 gestionarlas y monitorearlas eficazmente.

Información Clave

Visualiza 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, expirado, deshabilitado)
Expiración y Límites: Fecha de expiración de la clave, número de activaciones restantes e instancias de activación actuales

Acciones Disponibles

Puedes realizar las siguientes acciones sobre las claves de licencia:

Deshabilitar Clave de Licencia: Deshabilitar inmediatamente una clave para evitar más uso
Habilitar Clave: Volver a habilitar una clave de licencia previamente deshabilitada
Ver Instancias de Activación: Ver todas las instancias de activación asociadas para una clave de licencia particular

Beneficios

Rastrea la actividad de las claves de licencia en tiempo real
Identifica posibles usos indebidos o activaciones no autorizadas
Simplifica el soporte al cliente proporcionando registros detallados de uso en caso de discrepancia

Gestión de API

Usa estas APIs para crear, 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 API. Esto te permite llamarlos directamente desde tus aplicaciones cliente, software de escritorio, o CLIs sin exponer tus credenciales API.

Lifecycle Operations

Activa, desactiva y valida acciones en las claves de licencia.

Activate License

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

Deactivate License

Revoca una activación previa para liberar capacidad.

Validate License

Verifica autenticidad, estado, y restricciones antes de conceder acceso.

License Key Management

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

Create License Key

Crea una nueva clave de licencia o importa una existente desde otro sistema.

List License Keys

Navega por todas las claves con detalles de estado y uso.

Get License Key

Recupera una clave específica y su metadata.

Update License Key

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

Activation Instances

Trabaja con activaciones individuales de dispositivos 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 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);

Crear una clave de licencia

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

const licenseKey = await client.licenseKeys.create({
  customer_id: 'cust_123',
  product_id: 'prod_456',
  key: 'MY-CUSTOM-KEY-001',
});

console.log(licenseKey.id);