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>”.

Gerenciar & Monitorar
A Seção de Chaves de Licença fornece uma visão abrangente de toda a atividade das chaves de licença e permite que você gerencie e monitore licenças de forma eficaz.Informações da Chave
Veja 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 restantes e instâncias de ativação atuais

Ações Disponíveis
Você pode realizar as seguintes ações nas chaves de licença:- Desativar Chave de Licença: Desative imediatamente uma chave para impedir o uso adicional
- Reativar Chave: Reative uma chave de licença que foi desativada anteriormente
- Ver Instâncias de Ativação: Veja todas as instâncias de ativação associadas a uma chave de licença específica

Benefícios
- Rastreie a atividade da chave de licença em tempo real
- Identifique possíveis abusos ou ativações não autorizadas
- Simplifique o suporte ao cliente fornecendo registros detalhados de uso em caso de discrepância
Gerenciamento de API
Use essas APIs para ativar, validar, listar e atualizar chaves de licença e suas instâncias de ativação.Endpoints Públicos: Os endpoints de ativação, desativação e validação de licença são públicos e não exigem uma chave de API. Isso permite chamá-los diretamente de seus aplicativos cliente, softwares de desktop ou CLIs sem expor suas credenciais de API.
Lifecycle Operations
Lifecycle Operations
Dispare 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 autenticidade, status e restrições antes de conceder acesso.
License Key Management
License Key Management
Liste, recupere e atualize chaves de licença com suas configurações e status.
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 expiração, limites de ativação ou habilite/desabilite uma chave.
Activation Instances
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 de uma única instância de ativação.
Update Instance
Revogue ou atualize informações do dispositivo para uma instância.
Exemplos de Integração
Ativar uma licença
Esses endpoints não exigem uma chave de API e podem ser chamados diretamente de seus aplicativos cliente.
Validar uma licença
Chaves de Licença na URL de Retorno
Quando um cliente conclui uma compra de um produto com chaves de licença ativadas, a chave é automaticamente acrescentada ao seureturn_url como um parâmetro de consulta. Isso permite exibir a chave imediatamente na página de sucesso sem fazer uma chamada extra à API.
subscription_id é usado em vez de payment_id:
Melhores Práticas
- Mantenha os limites claros: Escolha padrões sensatos para expiração e ativações
- Oriente os usuários: Forneça instruções de ativação precisas e documentação de autoatendimento
- Automatize verificações: Valide chaves no lado do servidor antes de conceder acesso
- Monitore eventos: Use webhooks para detectar abusos e automatizar revogações