Licenciamento

As versões de lançamento do HandyCafe exigem uma conta HandyCafe verificada antes da configuração do servidor local ou da entrada da equipe. O seu plano determina o número de conexões simultâneas de PCs clientes e consoles que o servidor aceita. Ele também controla o acesso aos recursos específicos de cada plano.

Ativação da Licença

Inicie o HandyCafe Server.
O HandyCafe verifica se já existe uma licença de conta ativada neste servidor.
Quando não houver nenhuma licença de conta ativada, aparece a tela Faça login para ativar. Informe seu e-mail e sua senha ou selecione Entrar com o HandyCafe para aprovar o login no navegador sem digitar a senha no PC da lan house.
Selecione Crie uma gratuitamente quando precisar de uma conta. Informe apenas o seu endereço de e-mail.
Abra o link seguro de registro enviado por e-mail. Crie sua senha e conclua o registro no navegador.
Volte ao HandyCafe Server e entre com a nova conta.
O HandyCafe ativa a licença da lan house para a conta. Quando a conta tem várias lan houses, escolha a sua em Selecione um cibercafé.
O Assistente de Primeira Configuração é executado quando o servidor ainda não tem um Admin. Caso contrário, aparece a tela de login de Admin ou de operador de caixa.

Consulte Conta HandyCafe para ver o login pelo navegador, a seleção da lan house e a regra de um servidor por lan house.

Uma conta verificada nova inicia o teste de 14 dias automaticamente quando ativa uma lan house pela primeira vez. Uma chave de licença HC- neutra em relação ao plano continua sendo usada internamente. A chave não contém o nome do plano atual e mantém a mesma identidade quando o plano muda. Os usuários da versão GA não precisam digitar nem copiar essa chave.

O aplicativo não pede a senha da conta de novo a cada inicialização.

A tela de ativação da conta é o primeiro passo obrigatório do lançamento. O Assistente de Primeira Configuração local e a tela de login de Admin ou de operador de caixa só são carregados depois que a ativação da conta é bem-sucedida. A tela de conta da versão de lançamento não pode ser pulada por uma prévia de demonstração.

Selecione o botão de senha esquecida ao lado do campo de senha (Esqueci minha senha ou não consigo entrar) para pedir um link de redefinição. O HandyCafe sempre mostra a mesma confirmação após o envio. Isso impede que a tela revele se o e-mail está cadastrado.

Teste Gratuito

Uma conta elegível pode experimentar o HandyCafe Genesis Pro gratuitamente por 14 dias. Nenhum cartão é necessário. O teste começa automaticamente quando uma conta nova ativa uma lan house pela primeira vez. Uma conta elegível já existente pode iniciá-lo no Dashboard do HandyCafe, em Meu plano, com Iniciar teste. Consulte Conta HandyCafe.

Enquanto o teste está em andamento, o HandyCafe Server mostra VERSÃO DE TESTE na barra superior e o plano Teste de 14 dias. O teste inclui 5 PCs e 5 consoles, com os recursos de Nuvem e Cafeteria liberados. Os dias restantes são exibidos. Perto do fim, o selo muda para TESTE EXPIRANDO. Selecione Escolher um plano ou Gerenciar plano antes do término para que a lan house continue funcionando sem interrupção.

O teste é oferecido uma vez por conta e não é oferecido a uma conta que já teve uma licença. O teste também é permitido apenas uma vez por computador.

Quando o teste termina sem um plano, a licença é bloqueada. Os registros continuam no servidor. A lan house continua com a mesma licença depois que um plano é comprado.

HandyCafe Genesis Pro

O HandyCafe Genesis Pro é o produto do HandyCafe. Ele é cobrado por PC e inclui todos os recursos desta documentação. Isso abrange o Construtor de Relatórios, funções de operador de caixa personalizadas e de gerente, tíquetes em lote, manutenção do banco de dados e Acesso Remoto e capturas de tela locais ilimitados. Nuvem e Cafeteria são complementos separados. Consulte Conta HandyCafe para comprar ou alterar um plano.

Quando um plano expira, termina após um cancelamento ou tem um pagamento recusado, a licença é bloqueada. Os registros continuam no servidor. O acesso volta com a mesma licença depois do pagamento. Uma licença revogada ou desativada por segurança encerra todo o acesso de clientes e consoles.

Planos Genesis de Prazo Fixo

Um plano Genesis pode ser atribuído diretamente a uma lan house por um prazo fixo, sem assinatura com pagamento recorrente. O Dashboard do HandyCafe mostra isso como o plano atual da lan house em Dashboard, Meu plano e Faturamento. Ele exibe a data final fixa em vez de uma data de renovação.

Um plano de prazo fixo não tem renovação automática nem cancelamento pelo Stripe. Os controles de cancelamento de assinatura, reativação e troca de plano por autoatendimento continuam indisponíveis para esse plano. Entre em contato com o suporte do HandyCafe quando o plano atribuído precisar mudar antes da data final.

Transição do Plano Anual Legacy

Uma compra Legacy anual ativa feita antes de 1 de julho de 2026 pode migrar para o Genesis sem perder o período Legacy já pago. O HandyCafe confirma o pagamento Legacy bem-sucedido antes de oferecer a transição. Um preço ou identificador de assinatura armazenado não é aceito sozinho como comprovante de pagamento. O HandyCafe escolhe o menor pacote Genesis que cobre o limite de clientes do Legacy. O acesso ao Genesis é liberado imediatamente. O acesso incluído termina no mesmo instante em que termina o período Legacy existente.

Abra Meu plano e localize a licença Legacy elegível. Selecione Migrar para o Genesis e revise a confirmação. A confirmação mostra cobrança zero hoje. Ela também mostra o valor anual exato do Genesis e a data do primeiro pagamento. O Stripe verifica e salva o cartão. Em seguida, o HandyCafe agenda a nova assinatura anual do Genesis para começar quando o período Legacy pago terminar. Essa transição não cria um período de teste.

A renovação Legacy existente só é desativada depois que o agendamento da futura assinatura Genesis é criado com sucesso. Uma configuração que falha restaura a definição de renovação Legacy anterior. O HandyCafe também reconcilia uma configuração interrompida antes de permitir um novo checkout. Isso evita uma lacuna de faturamento, uma cobrança futura invisível ou duas renovações ativas.

Selecione Cancelar renovação agendada para interromper a cobrança futura do Genesis. O acesso ao Genesis incluído continua até a data final do período Legacy pago. Depois dessa data, a licença é bloqueada. Um primeiro pagamento do Genesis recusado também bloqueia a licença. Os registros continuam no servidor.

Renovações Legacy pelo PayPal precisam de ajuda do suporte antes da transição por autoatendimento. O HandyCafe não agenda uma segunda cobrança recorrente enquanto uma renovação existente do PayPal ainda pode estar ativa.

Configurações da Conta

Abra Configurações, depois selecione Conta para gerenciar a conta HandyCafe vinculada ao servidor. A página mostra a pessoa de contato e o e-mail, a lan house, o país, o plano atual, a cota de PCs, a cota de consoles ativos e a exigência de conexão online. Os pacotes de Nuvem e de Cafeteria ativos aparecem como cartões separados na seção Complementos, abaixo do plano. Selecione Dashboard para abrir o Dashboard do HandyCafe vinculado no navegador do sistema.

No caso de uma assinatura Stripe com renovação automática, a página rotula o limite real do período de cobrança como data de renovação. Se a renovação automática estiver inativa, ela informa isso e exibe a data final de acesso da licença. A data final de acesso pode ser posterior ao limite do período de cobrança porque o HandyCafe inclui uma pequena margem de reconciliação para webhooks de pagamento atrasados. O acesso à Nuvem ou à Cafeteria concedido por um administrador aparece como pacote ativo, sem inventar uma data de renovação.

Selecione Atualizar para solicitar o status assinado mais recente da conta e do plano. Selecione Gerenciar plano para abrir a seleção de planos e o fluxo de checkout seguro.

Somente o operador de caixa Admin local pode selecionar Sair. O HandyCafe pede confirmação antes de remover a conta do servidor. Sair desconecta a Cloud Live Link e o relay da cafeteria, apaga a credencial compartilhada da nuvem e devolve o servidor à tela obrigatória de entrada na conta HandyCafe. Uma licença quebrada ou em modo somente leitura ainda pode ser apagada pela tela de recuperação de bloqueio quando a entrada como Admin local não está disponível.

Estados da Licença

Estado	Descrição
missing_key	Nenhuma chave de licença foi inserida
inactive	Chave inserida mas ainda não validada
active	Licença válida e operacional
offline_grace	Um servidor pago não consegue alcançar o serviço de licenciamento mas continua dentro do período de tolerância configurado
offline_locked	Período de tolerância expirou. Servidor bloqueado até a conectividade ser restaurada.
expired	A licença passou da data de expiração
revoked	A licença foi revogada pela autoridade de licenciamento
over_limit	Mais clientes estão conectados do que a licença permite

Limite de PCs

Sua licença especifica o número máximo de conexões simultâneas de PCs clientes e consoles.

Quando o limite é atingido, novas conexões de clientes são rejeitadas.
O servidor exibe uma notificação de limite traduzida. Ele não expõe um código de erro interno.

Se você precisa de mais PCs, altere seu plano em Meu plano no Dashboard do HandyCafe.

Modo Somente Leitura

Quando o limite de PCs está definido como 0 (ou quando a licença está em certos estados restritos), o servidor entra em modo somente leitura:

Você pode visualizar todos os dados e relatórios
Você não pode iniciar novas sessões
Você não pode fazer alterações em configurações que afetam operações de clientes
O Painel de Administração exibe uma sobreposição de licença indicando a restrição

Internet e Comportamento Offline

O HandyCafe Genesis Pro usa o período de tolerância offline configurado. O padrão é 48 horas. Se o servidor não conseguir alcançar o serviço de licenciamento:

A licença entra no estado offline_grace.
Você tem até o prazo de tolerância configurado para restaurar a conectividade com a internet.
Durante o período de tolerância, todos os recursos funcionam normalmente.
Passado o prazo, a licença entra no estado offline_locked e o servidor é restringido.

O HandyCafe Server aceita o estado de licença vindo da Nuvem apenas quando a resposta traz uma assinatura HandyCafe válida vinculada à instalação e à requisição atuais. Respostas sem assinatura, alteradas, desatualizadas, repetidas ou de outra instalação são rejeitadas. O acesso operacional continua bloqueado até chegar uma resposta válida.

Dica: Certifique-se de que seu PC servidor tenha uma conexão de internet estável que permita tráfego WebSocket seguro até a Nuvem do HandyCafe. O heartbeat usa largura de banda mínima.

Sobreposição de Licença

Quando há um problema de licença, a sobreposição de licença apresenta a ação necessária. Esta sobreposição:

Mostra o status atual da licença
Exibe o limite de PCs
Exibe o limite de consoles ativos
Fornece instruções para resolver o problema
Bloqueia o uso operacional quando a licença exige uma ação

Próximos Passos

Conta HandyCafe: Login, seleção da lan house, planos e faturamento
Painel de Controle: Entenda a interface principal
Configurações: Configure sua instalação