O que o cliente está vendo

Uma página completamente em branco com status 404 em um endereço da sua própria loja, como https://your-store.com/apps/alvadd/download?key=… ou /apps/alvadd/link?key=…. O e-mail chegou e qualquer chave de licença nele está correta. As ferramentas de desenvolvedor do navegador mostram Content-Length: 0 e nenhum redirecionamento.

É o Shopify, e não o Alva Digital Downloads, que está enviando essa página. Todo endereço em /apps/ de uma loja Shopify só é encaminhado para um app quando a instalação do app traz uma regra de roteamento chamada app proxy. Quando a regra está ausente ou aponta para outro lugar, o Shopify responde com um 404 vazio e a requisição nunca chega aos servidores do Alva.

1. Verifique o caminho do proxy do app no Shopify

No admin do Shopify, abra Configurações → Apps e canais de vendas → Alva Digital Downloads. Essa é a página de detalhes do app, não o app em si. Abaixo das permissões normalmente há uma seção URL do proxy do app com um botão Personalizar URL.

Se o caminho exibido for qualquer coisa diferente de /apps/alvadd, clique em Personalizar URL, defina o prefixo como apps e o subcaminho como alvadd e salve. A mudança vale imediatamente, e todo link que o Alva já enviou por e-mail passa a funcionar sem precisar de reenvio.

2. Confirme que o roteamento está ausente

Se a seção URL do proxy do app não aparecer de jeito nenhum, abra https://your-store.com/apps/anything-random em um navegador. O mesmo 404 em branco para qualquer endereço em /apps/ confirma que o Shopify criou a instalação do app sem o roteamento.

Isso é raro e acontece do lado do Shopify no momento da instalação. Nada na configuração dos seus produtos, links ou chaves de licença causa o problema, e nada nessas configurações o resolve.

3. Contate o suporte do Alva — não reinstale por conta própria

Escreva para digitaldownloads@alvaapps.com informando o endereço da sua loja. Desinstalar o app exclui seus grupos de chaves de licença, chaves, links de produto e histórico de pedidos, então o Alva Digital Downloads faz primeiro um backup completo, restaura o backup e orienta a reinstalação para que nada se perca.

Até o roteamento ser reparado, a chave de licença continua sendo entregue dentro do e-mail, na página de agradecimento e na conta do cliente. Apenas a página de download e os botões de link externo são afetados.