Chaves de Licença

Emita chaves exclusivas para o seu software ou bens digitais, controle ativações e revogue acessos quando necessário. Chaves de licença funcionam bem com assinaturas e compras avulsas.

O Que São Chaves de Licença?

Chaves de licença são tokens únicos que autorizam o acesso ao seu produto. Elas são ideais para:

Licenciamento de software: Aplicativos de desktop, plugins e CLIs
Controles por usuário: Limitar ativações por usuário ou dispositivo
Bens digitais: Restringir downloads, atualizações ou recursos premium

Principais Benefícios

Controle de acesso: Defina limites de expiração e ativação
Visibilidade operacional: Rastreie uso, dispositivos e histórico
Segurança e suporte: Desative, reative e audite rapidamente

Criando Chaves de Licença

Create a License Key

Acesse o painel do Dodo Payments e abra a seção de Chaves de Licença. Selecione a opção para criar uma nova chave.

Configure License Key Settings

Defina como suas chaves de licença serão emitidas e utilizadas especificando estes campos:

License Key Expiry Date: Determine por quanto tempo a chave permanece válida. Escolha uma duração específica (por exemplo, 30 dias ou 1 ano), ou selecione “no expiry” para uma chave perpétua.
Activation Limit: Estabeleça o número máximo de ativações simultâneas por chave. Use um número específico para cenários como usuário único (1) ou licenças para equipe (5), ou selecione “unlimited” para não aplicar limite de ativações.
Activation Instructions: Forneça etapas de ativação claras para seus clientes, que também serão enviadas por e-mail junto com a chave de licença. Exemplos: “Cole a chave em Settings → License” ou “Execute: mycli activate <key>”.

Review and Save

Verifique todos os detalhes inseridos. Quando estiver pronto, salve a configuração da chave de licença para concluir a criação da chave.

Use instruções realistas e inclua links de suporte para reduzir tickets de ativação.

Criando uma chave de licença no painel do Dodo Payments

Importar Chaves de Licença via API

Já tem chaves de licença em outro sistema? Use a API Create License Key para importá-las no Dodo Payments. Isso permite migrar chaves existentes sem interromper seus clientes.

Chaves de licença criadas ou atualizadas via API não acionam notificações por email para os clientes. Se precisar notificar os clientes sobre sua chave de licença, é necessário gerenciar isso separadamente em sua aplicação.

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

Você também pode usar este endpoint para criar programaticamente novas chaves de licença com valores personalizados, limites de ativação e datas de expiração — útil para provisionamento em massa ou fluxos de trabalho de licenciamento corporativo.

Gerenciar e Monitorar

A Seção de Chaves de Licença fornece uma visão abrangente de todas as atividades de chaves de licença e permite que você gerencie e monitore as licenças de forma eficaz.

Informações da Chave

Visualize informações detalhadas para cada chave de licença:

Detalhes da Chave: Valor da chave de licença, nome do produto associado, detalhes do cliente (customer_id) e data da compra
Atividade de Uso: Número de ativações, datas e horários de ativação e status (ativo, expirado, desativado)
Expiração e Limites: Data de expiração da chave, contagem de ativações remanescentes e instâncias de ativação atuais

Ações Disponíveis

Você pode realizar as seguintes ações em chaves de licença:

Desativar Chave de Licença: Desativar imediatamente uma chave para evitar uso posterior
Ativar Chave: Reativar uma chave de licença anteriormente desativada
Visualizar Instâncias de Ativação: Ver todas as instâncias de ativação associadas a uma chave de licença específica

Benefícios

Acompanhe a atividade das chaves de licença em tempo real
Identifique possíveis usos indevidos ou ativações não autorizadas
Simplifique o suporte ao cliente fornecendo registros de uso detalhados em caso de discrepância

Gerenciamento de API

Use essas APIs para criar, ativar, validar, listar e atualizar chaves de licença e suas instâncias de ativação.

Endpoins Públicos: Os endpoints de ativação, desativação e validação de licença são públicos e não requerem uma chave API. Isso permite chamá-los diretamente de suas aplicações cliente, software desktop ou CLIs sem expor suas credenciais de API.

Lifecycle Operations

Acione ações de ativação, desativação e validação em chaves de licença.

Activate License

Crie ou registre uma instância de ativação para uma chave de licença.

Deactivate License

Revogue uma ativação anterior para liberar capacidade.

Validate License

Verifique a autenticidade, status e restrições antes de conceder acesso.

License Key Management

Crie, liste, recupere e atualize chaves de licença com suas configurações e status.

Create License Key

Crie uma nova chave de licença ou importe uma existente de outro sistema.

List License Keys

Navegue por todas as chaves com detalhes de status e uso.

Get License Key

Recupere uma chave específica e seus metadados.

Update License Key

Modifique a data de expiração, os limites de ativação ou ative/desative uma chave.

Activation Instances

Trabalhe com ativações de dispositivos individuais para cada chave.

List Instances

Retorne todas as instâncias de ativação para uma chave específica.

Get Instance

Busque detalhes para uma única instância de ativação.

Update Instance

Revogue ou atualize as informações do dispositivo para uma instância.

Exemplos de Integração

Ativar uma licença

Estes endpoints não requerem uma chave API e podem ser chamados diretamente de suas aplicações 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 uma licença

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

Criar uma chave de licença

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