Pular para o conteúdo principal
— Solução de problemas

Por que o Alva não enviou um e-mail de download de um pedido

O Alva Digital Downloads processa um pedido apenas quando o Shopify dispara o webhook ORDERS_PAID. Pedidos deixados em Authorized, checkouts que não passam e-mail e alguns checkouts de um clique de terceiros nunca disparam esse webhook — então nenhuma Purchase é escrita e nenhum e-mail é enviado.

Primeiro, confirme que o pedido nunca foi processado

O Alva Digital Downloads escreve uma linha Purchase e uma entrada no log de e-mail no momento em que processa um pedido. Abra o pedido no admin do Alva: se não houver Purchase e o log de e-mail estiver vazio, o pedido nunca disparou o processamento. Esse é o caso upstream que este artigo cobre — distinto de um e-mail que foi enviado mas nunca chegou.

O pedido não está marcado como pago no Shopify

O Shopify dispara ORDERS_PAID apenas quando o pagamento é capturado. Pedidos parados em Authorized, Payment pending ou não atendidos nunca o disparam, então o Alva nunca os vê. Capture o pagamento ou clique em Mark as paid no admin do Shopify — isso dispara o webhook e o handler existente entrega o e-mail.

A captura manual deixa os pedidos autorizados

As configurações de pagamento do Shopify — incluindo Automatically capture payment for orders definida como manual, ou “capturar apenas no atendimento” — deixam os pedidos autorizados até você capturá-los. Lojistas sob as regras de captura da UE e da Dinamarca muitas vezes precisam capturar manualmente. Uma automação do Shopify Flow que captura o pagamento ou marca o pedido como pago fecha a lacuna automaticamente.

Um checkout de um clique de terceiros contornou o Shopify

Alguns apps de checkout de um clique criam o pedido pela Shopify Admin API e nunca emitem o webhook padrão de pagamento. O Alva pode processar esses casos por um caminho separado, desligado por padrão. Se sua loja usa um checkout de um clique ou externo, escreva para o suporte com o domínio da sua loja para ser habilitado — pedidos antigos não podem ser recuperados automaticamente.

O pedido chegou sem e-mail do cliente

O Alva indexa cada cliente por um endereço de e-mail obrigatório. Alguns provedores de pagamento externos não passam e-mail, então o registro do cliente é ignorado e nenhum e-mail pode ser enviado. O dashboard do Alva sinaliza a loja quando isso acontece. Torne o e-mail obrigatório no checkout; para um pedido antigo afetado, obtenha o endereço, atualize o cliente e use o botão Resend email do pedido.

Percorra esta checklist

Trabalhe a lista em ordem. Os três primeiros itens resolvem quase todo não-envio upstream. Reserve o último para pedidos que genuinamente nunca chegaram ao Alva.

  • Confirme que o selo de status de pagamento no Shopify diz Paid, não Authorized ou Payment pending.
  • Se estiver autorizado, capture o pagamento ou clique em Mark as paid para disparar ORDERS_PAID.
  • Verifique se o pedido tem um endereço de e-mail do cliente — sem e-mail não há entrega.
  • Confirme que você não está esperando por latência normal: alguns minutos são esperados, conforme coberto em Por que um pedido leva alguns minutos para aparecer no Alva.
  • Para um checkout de um clique ou externo, entre em contato com o suporte do Alva para habilitar o caminho de processamento alternativo.

Perguntas frequentes

Como isso é diferente de um e-mail que foi enviado mas nunca chegou?

Este artigo cobre pedidos que nunca dispararam o processamento — nenhuma linha Purchase, nenhuma tentativa de e-mail, nada no log de e-mail. Se o pedido foi processado e o log de e-mail mostra uma linha Sent ou InactiveRecipient, o e-mail foi tentado e o problema é downstream — veja Por que seu cliente não recebeu o e-mail de download.

Como confirmo que um pedido está pago no Shopify?

Abra o pedido no admin do Shopify. O selo de status de pagamento deve dizer Paid. Authorized, Payment pending ou Partially paid significam que o pagamento não foi capturado, então ORDERS_PAID nunca disparou. Capture o pagamento ou use Mark as paid para disparar.

Marcar um pedido antigo como pago agora vai enviar o e-mail?

Sim. Marcar como pago um pedido anteriormente autorizado dispara ORDERS_PAID, e o Alva o processa exatamente como um pedido novo — escreve a Purchase e envia o e-mail de entrega, desde que o pedido tenha um e-mail do cliente e o produto esteja mapeado.

Meu cliente pagou por um app de checkout de um clique e nada aconteceu. Por quê?

Alguns checkouts de um clique de terceiros criam o pedido pela Shopify Admin API e nunca emitem o webhook padrão de pagamento. O Alva pode processar esses casos por um caminho separado que é desligado por padrão. Entre em contato com o suporte com o domínio da sua loja para ser habilitado.

O pedido não tem endereço de e-mail. Ainda posso entregar os arquivos?

Não automaticamente. O Alva indexa o registro do cliente por um e-mail obrigatório, então um pedido sem e-mail é ignorado e nenhum e-mail pode ser enviado. Obtenha o endereço, atualize o cliente e use Resend email no pedido. Torne o e-mail obrigatório no checkout para evitar isso.

Veja também

Foi útil?

Ainda travado? Escreva para nós.

Última atualização 2026-06-01