Quando os downloads WooCommerce ficam indisponíveis após a compra, comece por identificar o sintoma: pagamento confirmado sem ligação, ligação inválida, falha no ficheiro ou URL direto público. Cada situação pede uma verificação diferente; alterar o estado da encomenda não confirma um pagamento.
Neste artigo
Por onde começar nos downloads WooCommerce
Identifique primeiro o que o cliente consegue fazer e confirme a evidência correspondente. Uma ligação autorizada depende das permissões da compra; um URL direto aponta para o ficheiro e pode funcionar sem passar por essa verificação.

Diagnóstico por sintoma
| Sintoma | Evidência a verificar | Ação segura |
|---|---|---|
| Pagamento feito, sem ligação | Estado da encomenda, pagamento confirmado e permissões de download | Confirmar a compra e a configuração de concessão de acesso antes de alterar algo |
| Ligação inválida ou expirada | Ligação atual, conta usada e prazo ou limite de descargas | Verificar as permissões da encomenda sem expor dados do cliente |
| Ficheiro não abre ou falha | Método de entrega, localização e funcionamento do ficheiro | Testar uma cópia em ambiente de ensaio com acesso autorizado |
| URL direto acessível | Origem do ficheiro e resultado de acesso anónimo | Rever armazenamento e proteção do servidor antes de voltar a testar |
Na documentação oficial Digital/Downloadable Product Guide, encontra as condições de entrega, armazenamento e proteção dos ficheiros. O diagnóstico abaixo separa o acesso da encomenda, a entrega técnica e a proteção na origem.
Cliente pagou mas não recebeu ligação de download WooCommerce
Confirme o pagamento e as permissões separadamente. Em WooCommerce > Definições > Produtos > Produtos descarregáveis, a opção de conceder acesso após pagamento permite descarregar com a encomenda em processamento ou concluída. Sem essa opção, o acesso aguarda o estado concluído. Não altere o estado apenas para contornar um pagamento pendente, falhado ou não confirmado.

Confirmar o acesso à compra
- Confirmar o pagamento com o meio de pagamento e consultar o estado da encomenda.
- Verificar se a encomenda tem permissões de download; procurar em Opções do ecrã se estiverem ocultas.
- Confirmar o endereço de email da compra e testar a ligação atual sem divulgar dados do cliente.
- Verificar se a compra foi feita como convidado antes de exigir início de sessão.
O email e Minha conta > Downloads são vias de acesso distintas. Se o ficheiro aparece na conta mas falta no email recebido, investigue o modelo do email e as personalizações; se o email inteiro não chegou, investigue o envio e a entrega. A opção que exige início de sessão não se aplica a compras como convidado: para exigir conta a todos os compradores, é também necessário desativar o checkout como convidado. Numa ligação expirada, consulte os downloads restantes e a data de expiração na permissão da encomenda.
Se a ligação for rejeitada, peça ao cliente a ligação atual do email ou da conta, sem a divulgar publicamente. Confirme a correspondência entre encomenda, email de faturação e permissão do ficheiro; corrija um email errado antes de reconstruir permissões. Se faltar uma permissão, pode conceder acesso ao produto na encomenda depois de validar a compra. Regenerar permissões substitui as atuais pelas dos ficheiros atuais do produto: registe antes limites personalizados, expiração e histórico necessários. Após a reparação, reveja as permissões e use a ação de enviar detalhes da encomenda ao cliente para fornecer o acesso atual. Consulte o diagnóstico oficial de emails sem ligações de download; não faça regenerações em massa como primeira resposta.
Ficheiro descarregável WooCommerce não abre: o que verificar
Verifique se o ficheiro está íntegro, se a localização é acessível pelo método escolhido e se cumpre as regras de diretórios aprovados, quando ativas. Para armazenamento remoto, teste o URL específico com esse método.
No produto, confirme a opção Descarregável e pelo menos um ficheiro com nome e URL válidos. Virtual indica que não há envio físico; não substitui Descarregável. Se o ficheiro descarrega mas não abre, compare-o com a cópia original para separar um ficheiro corrompido de uma falha de entrega.
Escolher o método de entrega pelo sintoma
| Método | Quando investigar | Condição e limite |
|---|---|---|
| Force downloads | Descarga interrompida, sobretudo em ficheiros grandes | Entrega por PHP; podem ocorrer timeouts. Para ficheiros remotos, o alojamento deve verificar allow_url_fopen. |
| X-Accel-Redirect/X-Sendfile | Entrega de ficheiros pelo servidor em vez do PHP | Exige suporte e configuração no servidor; confirme com o alojamento antes de selecionar. |
| Redirect only (insecure) | O cliente é enviado diretamente ao URL do ficheiro | Expõe o URL e permite a sua partilha. Não é uma correção segura para ficheiros pagos que devam permanecer privados. |
WooCommerce não impõe um tamanho máximo de ficheiro, mas o servidor pode limitar o carregamento ou interromper a entrega. Distinga uma falha ao carregar o ficheiro no produto de uma falha ao descarregá-lo. Peça ao alojamento para verificar o limite e o método efetivamente usado, sem ativar redirecionamento inseguro apenas para fazer desaparecer o erro.
Diretórios aprovados não equivalem a ficheiros privados
Em WooCommerce > Definições > Produtos > Diretórios de download aprovados, confirme que a localização está abrangida por uma regra ativa. Uma regra desativada ou eliminada pode desativar o ficheiro no produto, marcado por um asterisco vermelho, e impedir o acesso de clientes antigos. Peça a um administrador para corrigir a localização ou a regra específica, em vez de desligar toda a proteção.
As regras distinguem http de https e abrangem subdiretórios. Validam o URL guardado no produto, não os destinos para onde esse URL redireciona: aprovar um fornecedor implica confiar nos seus redirecionamentos. Esta lista controla locais permitidos, não autentica compradores nem protege URLs públicos. Consulte as regras oficiais dos diretórios aprovados e teste o URL remoto com o método de entrega escolhido.

Ao substituir o ficheiro na linha existente do produto, as compras anteriores passam a usar o ficheiro atualizado, mantendo expiração e contagem. Adicionar uma nova linha não concede acesso retroativo: reveja o acesso das compras anteriores se a intenção era uma atualização para esses clientes.
Como proteger URL direto de ficheiros WooCommerce
Não confunda uma ligação de compra autorizada com proteção do ficheiro na origem. A biblioteca multimédia do WordPress é pública: quem conhece o URL direto pode aceder ao ficheiro. Carregue-o pela edição do produto e confirme que o servidor bloqueia o acesso direto ao diretório woocommerce_uploads.

Ficha de ensaio hipotética
- Preparar o ensaio
Exemplo: loja de formação com um PDF de teste, numa cópia de ensaio e com pagamentos simulados. Resultado observado: por preencher. - Testar o acesso legítimo
Com uma conta autorizada, confirmar a ligação da encomenda e abrir o PDF de teste. Resultado observado: por preencher. - Testar o acesso anónimo
Sem sessão iniciada, tentar abrir o URL direto do PDF de teste. Resultado observado: por preencher. - Registar e corrigir
Registar o método, a localização e as diferenças entre os acessos; pedir revisão técnica se necessário. Resultado observado: por preencher.
Em Ferramentas > Saúde do site > Estado, consulte a proteção do diretório local. Com Force downloads ou X-Accel-Redirect/X-Sendfile, o teste verifica o acesso direto a um ficheiro; se for acessível, peça ao alojamento para bloquear esse acesso preservando a entrega autorizada. Com Redirect only, testa a listagem do diretório: uma listagem bloqueada não torna privados os URLs dos ficheiros. Um resultado inconclusivo não prova segurança nem exposição; peça a verificação das escritas de teste, pedidos ao próprio site e eventuais interferências de CDN ou firewall. Nenhum destes resultados certifica armazenamento remoto.
Em NGINX, um ficheiro .htaccess não bloqueia o acesso: o servidor ignora-o. O alojamento deve aplicar uma regra compatível com o método de entrega e com a ordem das regras existentes, conforme a documentação de proteção de uploads em NGINX. Um bloqueio direto também impede o fallback inseguro por redirecionamento; confirme depois que a ligação autorizada continua a funcionar.
Para completar a evidência, consulte Analytics > Downloads e filtre a encomenda ou produto no período afetado. O relatório oficial de downloads regista atividade, incluindo descargas repetidas do mesmo IP; não confunda esse total com compradores únicos nem com prova de leitura integral do ficheiro.
A ficha de ensaio é hipotética: execute-a apenas numa cópia de ensaio, com contas autorizadas e pagamentos simulados, sem emails reais nem alterações ao servidor às cegas. Para outra verificação do catálogo, Stock WooCommerce: diagnóstico de quantidades e disponibilidade ajuda a analisar quantidades e disponibilidade.
Considere o incidente resolvido apenas depois de repetir o cenário afetado: compra autorizada com acesso ao ficheiro certo, limites e expiração corretos e proteção na origem adequada ao método escolhido. Se precisar de apoio, partilhe estado da encomenda, método de entrega, dimensão do ficheiro e erro observado, removendo nomes, emails, ligações privadas de download, caminhos do servidor e credenciais.