License Keys

​

¿Qué son las claves de licencia?

• Licencias de software: aplicaciones de escritorio, plugins y CLIs.
• Controles por asiento: limita las activaciones por usuario o dispositivo.
• Productos digitales: restringe las descargas, actualizaciones o funciones premium.

​

Create a License Key Entitlement

1

Open Entitlements

Ve a Entitlements en el dashboard y haz clic en + para crear un entitlement.

2

Choose License Key

Selecciona License Keys, introduce un Name y configura el comportamiento de cada clave emitida:

• Fulfillment Mode: Automatic (la opción predeterminada) genera y envía por email cada clave. Manual te permite proporcionar cada clave personalmente. Consulta Manual Fulfillment.
• Activations Limit: el número máximo de activaciones activas por clave, por ejemplo 1 para un único usuario o 5 para una licencia de equipo. Selecciona Unlimited para no establecer un límite.
• License Length: durante cuánto tiempo sigue siendo válida una clave después de emitirse, por ejemplo 30 días o 1 año, o No expiration. Para productos de suscripción, selecciona No expiration: las claves emitidas para una suscripción no caducan y su validez sigue el estado de la suscripción.
• Activation Message: instrucciones opcionales dirigidas al cliente, de hasta 2.500 caracteres, incluidas en el email que entrega la clave. Por ejemplo: Paste the key in Settings → License o Run: mycli activate <key>.

3

Save the Entitlement

Haz clic en Create Entitlement. Ahora puedes asignar el entitlement a cualquier producto.

​

Attach to Products

​

How Keys Are Issued

​

Comportamiento de la cantidad

• Productos de suscripción emiten una clave por asiento (subscriptions.quantity).
• Productos one-time emiten una clave por unidad del artículo de línea del carrito (product_cart.quantity).
• Concesiones manuales mediante la API emiten exactamente una clave.

​

Fulfillment Mode

• auto (predeterminado, Automatic en el dashboard): Dodo Payments genera y envía por email la clave tras el pago o la suscripción. Este es el comportamiento de la tabla anterior y se aplica cuando se omite fulfillment_mode.
• manual (Manual en el dashboard): cada unidad comprada crea una concesión Pending sin clave, y tú proporcionas cada valor de clave. Consulta Manual Fulfillment.

​

Manual Fulfillment

​

Cuándo usarlo

• Usa tus propias claves: tu aplicación, un producto de escritorio o tu propio servidor de licencias genera la clave.
• Proveedores externos: revendes claves emitidas por un proveedor ascendente, como una clave de juego, una credencial de API o una licencia de una plataforma asociada.
• Inventario limitado: entregas códigos de un conjunto preasignado y los asignas de uno en uno.
• Revisión humana: quieres comprobar una compra antes de conceder el acceso.

​

Activar el fulfillment manual

// `client` is a DodoPayments instance created with your API key.
const entitlement = await client.entitlements.create({
  name: 'Pro License (Manual)',
  integration_type: 'license_key',
  integration_config: {
    fulfillment_mode: 'manual',
    activations_limit: 5,
    duration_count: 1,
    duration_interval: 'Year',
  },
});

curl -X POST https://test.dodopayments.com/entitlements \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro License (Manual)",
    "integration_type": "license_key",
    "integration_config": {
      "fulfillment_mode": "manual",
      "activations_limit": 5,
      "duration_count": 1,
      "duration_interval": "Year"
    }
  }'

​

Buscar concesiones pendientes de fulfillment

const pending = await client.customers.listEntitlementGrants('cus_abc123', {
  integration_type: 'license_key',
  status: 'Pending',
});

​

Entregar la clave

curl -X POST https://test.dodopayments.com/grants/entg_8VbC6JDZ/license-key \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "activations_limit": 5,
    "expires_at": "2027-05-01T00:00:00Z"
  }'

​

Activación, validación y desactivación

​

Activar una licencia

import DodoPayments from 'dodopayments';

// The license endpoints don't check the token, but the SDK requires a value.
// Never ship your secret API key in client software.
const client = new DodoPayments({ bearerToken: 'public', environment: 'test_mode' });

const response = await client.licenses.activate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  name: 'Device Name',
});

console.log(response.id);

from dodopayments import DodoPayments

# The license endpoints don't check the token, but the SDK requires a value.
client = DodoPayments(bearer_token="public", environment="test_mode")

response = client.licenses.activate(
    license_key="PRO-AAAA-BBBB-CCCC-DDDD",
    name="Device Name",
)
print(response.id)

curl -X POST https://test.dodopayments.com/licenses/activate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "name": "Device Name"
  }'

​

Validar una licencia

// Uses the client from the activation example.
const response = await client.licenses.validate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
});

console.log(response.valid);

curl -X POST https://test.dodopayments.com/licenses/validate \
  -H "Content-Type: application/json" \
  -d '{ "license_key": "PRO-AAAA-BBBB-CCCC-DDDD" }'

​

Desactivar una instancia de activación

await client.licenses.deactivate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  license_key_instance_id: 'lki_abc123',
});

​

Gestionar claves

const grants = await client.entitlements.grants.list('ent_license_key_id', {
  status: 'Delivered',
});

for (const grant of grants.items) {
  console.log(grant.license_key?.key, grant.license_key?.activations_used);
}

​

Importar claves de licencia existentes mediante la API

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

​

Diferencias de las claves según su origen

​

Claves de licencia en la URL de retorno

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001%2CLK-002&email=customer%40example.com

https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com

​

Gestión de la API

​

Webhooks

​

Claves de licencia heredadas

​

Prácticas recomendadas

• Elige límites de activación claros: selecciona valores predeterminados como 1 para aplicaciones de un solo usuario o 3–5 para licencias de equipo, y documenta estos valores para tus clientes.
• Escribe mensajes de activación precisos: los clientes los copian del email de la clave de licencia, por lo que las rutas y los comandos exactos evitan solicitudes de soporte.
• Valida las claves contra la API: para productos conectados a la red, llama a /licenses/validate en lugar de depender de una activación almacenada localmente en caché.
• Usa webhooks para la revocación: gestiona entitlement_grant.revoked para desactivar las funciones de la aplicación cuando un cliente cancela o recibe un reembolso.
• Prueba las suscripciones y las compras one-time: el comportamiento de las claves de licencia varía entre ambas, por ejemplo, las claves de suscripción no caducan, así que prueba las dos antes de ponerlas en producción.