Estados de chave no Alva
Cada chave de licença carrega um de quatro status, refletindo onde está em seu ciclo de vida:
- AVAILABLE — no pool, aguardando ser atribuída.
- ASSIGNED — anexada a uma linha
PurchaseLicenseKeyem um pedido de cliente. - REVOKED — manualmente retirada do pool, nunca reemitida.
- RETURNED — foi atribuída, depois liberada antes de o cliente visualizá-la; a chave subjacente volta para
AVAILABLEcom uma trilha de auditoria na linha da compra.
AVAILABLE → ASSIGNED (paid order, fraud-approved)
ASSIGNED → REVOKED (Revoke — terminal)
ASSIGNED → AVAILABLE (Return — only if not viewed)Revogue uma chave de um pedido
Revogar é uma ação dura: a chave passa para REVOKED, recebe um carimbo revokedAt na linha da compra e nunca é oferecida a outro pedido. A cópia da string da chave do cliente permanece inalterada — se seu sistema downstream verifica um registro central na ativação, a chave falhará lá.
- Abra o pedido em Pedidos e role até a seção Chaves de licença.
- Na linha da chave atribuída, clique em Revogar.
- Confirme no modal. A linha é atualizada para Revogada e desaparece da página de conta do cliente no próximo recarregamento.
Página de detalhes do pedido no admin do Alva. Mostre o card Chaves de licença com uma chave listada, o código da chave parcialmente mascarado e o botão Revogar destacado com uma caixa vermelha. Sem dados reais de cliente visíveis.
Retorne uma chave sem revogar
Use Retornar quando o cliente disser que a chave não funcionou e você quiser uma chave nova no pedido sem queimar a antiga. O Alva move a original de volta para AVAILABLE, registra um carimbo returnedAt e o próximo pedido na fila a reivindica. Retornar só está habilitado enquanto o cliente ainda não visualizou a chave.
- Abra o pedido e role até Chaves de licença.
- Clique em Retornar na linha da chave afetada e confirme.
- Clique em Atribuir nova chave para reivindicar a próxima chave disponível, depois reenvie o e-mail de entrega.
Página de detalhes do pedido no admin do Alva. Mostre o card Chaves de licença com a ação Retornar visível ao lado de Revogar. Inclua um pequeno selo "Ainda não visualizada" na linha da chave para deixar a precondição óbvia.
O que os clientes veem
Chaves revogadas desaparecem da página de conta do cliente e da página de download do status do pedido no próximo carregamento — apenas os links de arquivos permanecem. Chaves retornadas também são removidas, já que a linha de atribuição é removida. Nenhuma das duas ações envia uma notificação: combine Revogar com um e-mail de reembolso e combine Retornar com uma nova atribuição mais um reenvio manual.
Perguntas frequentes
Não. Revogar é permanente — a chave não pode voltar para Available. Se você revogou por engano, envie uma chave nova ao mesmo grupo e atribua manualmente ao pedido.
Retornar só está disponível enquanto o cliente ainda não visualizou a chave. Uma vez que o cliente abre o e-mail de entrega ou a página de downloads e a chave é marcada como visualizada, apenas Revogar permanece disponível.
Nenhum e-mail automático sai para uma reatribuição manual. Use a ação Reenviar e-mail do pedido depois de atribuir a chave de substituição para que o cliente receba o novo código.
Veja também
Foi útil?
Última atualização 2026-05-06