Como funciona a entrega de pedidos
O Alva Digital Downloads é notificado no momento em que o Shopify marca um pedido como pago. Assim que a notificação de pagamento chega, o Alva registra o pedido e coloca o e-mail de entrega na fila. Toda a sequência normalmente é concluída em menos de 30 segundos. As entregas são armazenadas em buffer para garantir a confiabilidade: em caso de lentidão momentânea, a notificação aguarda e é reenviada até que o pedido seja registrado com sucesso.
Marcador de diagrama: fluxo simples mostrando pagamento no Shopify → notificação ao Alva → pedido registrado → e-mail de entrega enviado. Use as cores verde-azulado/azul da marca Alva. Sem nomes de fornecedores. Sem dados reais de clientes.
Razões comuns para atraso
Alto volume de pedidos
Durante promoções relâmpago, o Alva pode estar processando milhares de pedidos ao mesmo tempo. Cada pedido é tratado em sequência, então um pedido feito no final de uma fila movimentada pode levar até dois minutos para aparecer.
Checagem antifraude segurando o e-mail
Quando as verificações de fraude estão ativadas, o pedido é colocado em espera para revisão e a entrega fica pausada até que a API de risco do Shopify responda. A maioria das verificações é resolvida em segundos; pedidos encaminhados para revisão manual ficam aguardando até que você os aprove. Chaves de licença nunca são atribuídas antes da aprovação antifraude.
Regeneração de ZIP de pack grande
Se o produto for um pacote e um dos seus arquivos tiver sido alterado desde a última criação do bundle, o Alva regenera o arquivo de download antes de enviar o e-mail. Pacotes com vários gigabytes podem levar alguns minutos.
Configuração de e-mail por produto mudada no meio do voo
Se você alterar um modelo de e-mail por produto ou desativar e-mails para um produto enquanto um pedido está sendo processado, o Alva relê as configurações de e-mail do produto na próxima tentativa de processamento. O pedido ainda é concluído — o e-mail simplesmente usa a nova regra.
Retentativas de webhook do Shopify
O Shopify retenta um webhook falho até 19 vezes ao longo de cerca de 48 horas, com backoff entre tentativas. Se a primeira entrega bateu no Alva durante um deploy, o pedido pode não aparecer até a próxima retentativa ter sucesso — geralmente em 5 a 10 minutos.
O que fazer se já passaram mais de 5 minutos
Cinco minutos cobre a vasta maioria dos casos. Passado essa janela, percorra esta checklist:
- Confirme se o pedido está marcado como Pago no Shopify — pedidos pendentes ou apenas autorizados não acionam a entrega.
- Abra a lista de pedidos do admin do Alva. Retido significa que a antifraude está bloqueando a entrega; Processando significa que o worker ainda está nele.
- Confira Configurações → E-mail para confirmar que a entrega de e-mail está habilitada e que um remetente verificado está configurado.
- Se o pedido está faltando completamente, recorra a Encontre o link de download de um cliente para redisparar a entrega manualmente.
Perguntas frequentes
O sistema de entrega do Alva armazena notificações em buffer durante atualizações, indisponibilidades e picos de tráfego, de forma que um pedido pago nunca é perdido. Cada notificação só é marcada como concluída após o pedido ser totalmente registrado.
Não. A página de agradecimento usa um token de download provisório da extensão de checkout, então os arquivos aparecem instantaneamente, mesmo antes que a notificação de pagamento seja totalmente processada.
Até 19 vezes ao longo de cerca de 48 horas, com backoff exponencial. Desde que o Alva eventualmente retorne sucesso, o pedido processa normalmente.
Veja também
Foi útil?
Última atualização 2026-05-06