Como funciona a atribuição de chave de licença no POS
Quando o caixa submete o e-mail do cliente no balcão, o endpoint do POS cria o registro de Compra e chama assignLicenseKeysForPurchase imediatamente. Uma chave é puxada do pool marcado para esse produto, anexada à compra e incluída no e-mail de entrega que o Alva envia segundos depois. Sem fila antifraude, sem período de retenção — o pagamento é o único portão.
E-mail de entrega do Alva renderizado em uma tela de celular, mostrando uma chave de licença em um bloco de código acima do link de download. Use uma chave fictícia como XXXX-YYYY-ZZZZ. Sem dados reais de cliente visíveis.
Configure um produto POS com chave de licença
1. Envie suas chaves de licença
No admin do Alva, abra Chaves de licença. Envie um CSV de códigos pré-gerados (um por linha) ou use o gerador automático para criar chaves com prefixo e comprimento escolhidos. Veja Adicione chaves de licença via upload de CSV para o passo a passo completo.
2. Marque o lote
Aplique uma tag às chaves que você acabou de enviar — por exemplo pos-software-2026. A tag é a junção entre um pool de chaves e o produto do Shopify que deve reivindicar dele.
3. Mapeie a tag a um produto do Shopify
Abra o produto do Shopify no admin do Alva, escolha Mapear tag de chave de licença e selecione a tag do passo 2. Compras online e POS desse produto agora reivindicam do mesmo pool — sem catálogo POS separado.
4. Confirme que a extensão POS do Alva está instalada
A extensão POS do Alva é instalada automaticamente quando o Alva está na loja. No dispositivo POS, abra Configurações → Smart grid e confirme que Alva Digital Downloads é acessível no menu de ações pós-compra. Para detalhes da configuração inicial, veja Venda produtos digitais no Shopify POS.
Página de mapeamento de produto do admin do Alva. Destaque o dropdown "Tag de chave de licença" com uma tag como "pos-software-2026" selecionada. Mostre o resto do mapeamento de produto para contexto. Sem dados reais de cliente visíveis.
O que os clientes veem na loja
O recibo do Shopify mostra os itens de linha do pedido como sempre — sem chave impressa em papel. O caixa toca no tile do Alva, lê de volta o endereço de e-mail do cliente para pegar erros de digitação e confirma. Em segundos o cliente recebe o e-mail de entrega do Alva com a chave de licença no corpo. O recibo e a chave são dois artefatos separados: um impresso no balcão, um entregue na caixa de entrada.
Ressalvas honestas
Pedidos POS não passam pela fila antifraude, e a atribuição automática de chave de licença não pode ser pausada para vendas em loja. Se um produto precisa de revisão estilo antifraude antes de as chaves saírem (códigos enterprise de alto valor, por exemplo), deixe sua tag de chave de licença não mapeada — o cliente ainda recebe o e-mail de download e você atribui a chave manualmente pelo admin do Alva uma vez que o pedido é revisado. Para o raciocínio, veja Por que pedidos POS pulam a fila antifraude.
FAQ
O cliente vê a chave de licença no recibo do POS?
Não. O recibo do Shopify mostra apenas os itens de linha do pedido. A chave de licença chega no e-mail de entrega do Alva depois que o caixa captura o e-mail do cliente no balcão.
O que acontece se o pool de chaves de licença estiver vazio quando uma venda POS é finalizada?
O Alva cria um registro PendingLicenseKeyAssignment e envia o e-mail de download sem uma chave. Assim que mais chaves são enviadas com a tag correspondente, o Alva atribui uma e a envia ao cliente automaticamente.
Posso bloquear a atribuição automática de chave de licença POS para revisão?
Não seletivamente. Pedidos POS contornam a fila antifraude por design. Se um produto específico precisa de revisão antes de as chaves saírem, deixe sua tag de chave de licença não mapeada e atribua chaves manualmente pelo admin do Alva após cada venda.
Veja também
Foi útil?
Última atualização 2026-05-06