PrestaShop Checkout Travando? Guia Completo para Resolver (2026)

⚠️ Nota: Este artigo trata de checkout TRAVADO (não funciona, erro, tela branca).
Se o seu checkout está LENTO mas funciona, consulte o guia de performance do checkout.

Seu cliente adicionou produtos ao carrinho, preencheu os dados… e o checkout travou.

O botão “Finalizar pedido” não responde. A página congela ao selecionar o pagamento. Ou simplesmente aparece um erro 500 no último passo.

🔴 Isso não é lentidão. É travamento.

E a diferença é crítica:

• Lentidão → o cliente espera, mas compra
• Travamento → o cliente NÃO consegue comprar

Neste guia completo, você vai aprender a diagnosticar e resolver todas as causas de checkout travado no PrestaShop.

Índice

1. Checklist de Emergência: 5 Ações em 2 Minutos
2. Principais Causas do Checkout Travando
3. Como Diagnosticar o Problema (Passo a Passo)
4. Solução por Tipo de Problema
5. Módulo PrestaShop Checkout: O Maior Vilão
6. Prevenção: Como Evitar que o Checkout Trave Novamente
7. Quando Contratar um Especialista

1. Checklist de Emergência: 5 Ações em 2 Minutos {#checklist}

Antes de qualquer diagnóstico profundo, faça estas 5 ações. Uma delas pode resolver na hora.

1. Limpe o cache da loja

No backoffice: Parâmetros Avançados > Desempenho > Limpar cache

Ou via FTP: delete o conteúdo da pasta /var/cache/ (mantenha as pastas vazias)

2. Reinicie o módulo Checkout (se estiver usando)

Se você usa o Módulo PrestaShop Checkout (da parceria com PayPal):

1. Acesse Módulos > Gerenciador de Módulos
2. Busque por “PrestaShop Checkout”
   • Clique em Reiniciar (reset)
3. Reconecte sua conta PayPal na configuração do módulo

✅ Este passo resolve a maioria dos problemas com este módulo específico

3. Teste em modo anônimo e com outro navegador

• Abra uma janela anônima/privada
• Teste com Chrome, Firefox e Edge
• Se funcionar em um mas não em outro → problema é cache/navegador

4. Verifique o console do navegador

Abra o checkout e pressione F12 > Console

Procure por:

• 🔴 Erros em vermelho (JavaScript quebrado)
• ⚠️ Avisos de undefined function
• 🔗 Requisições com status 404 ou 500

Se encontrar erros JS, o problema pode ser:

• Conflito de módulos de pagamento
• Tema personalizado com scripts incompatíveis
• CDN mal configurada

5. Troque temporariamente para o tema padrão

No backoffice: Design > Configurações de Tema

• Altere para o tema Classic (padrão do PrestaShop)

Se o checkout funcionar com o tema padrão:
👉 O problema está no SEU tema personalizado

2. Principais Causas do Checkout Travando {#causas}

Após o checklist, se o problema persistir, identifique a causa real:

3. Como Diagnosticar o Problema (Passo a Passo) {#diagnostico}

Passo 1: Ativar Modo Debug

O modo debug revela o erro exato que está escondido.

Como ativar:

Via backoffice (se acessível):
Parâmetros Avançados > Desempenho > Modo debug

Via FTP (se o backoffice também está travado):

1. Acesse /config/defines.inc.php
2. Altere:phpdefine(‘_PS_MODE_DEV_’, false); // altere para: define(‘_PS_MODE_DEV_’, true);
3. Recarregue o checkout

Agora o erro específico aparecerá na tela. Anote a mensagem.

Para um guia completo sobre debug, consulte Debug no PrestaShop (modo dev): guia completo para identificar e resolver erros

Passo 2: Ativar o Profiler (se o problema é lentidão extrema)

Se o checkout “trava” por estar extremamente lento (não por erro de código):

1. No mesmo arquivo defines.inc.php, adicione:phpdefine(‘_PS_DEBUG_PROFILING_’, true);
2. Recarregue o checkout
3. No rodapé da página, você verá:
   • Número de consultas SQL
   • Tempo total de execução
   • Memória utilizada
   • Queries mais lentas

Isso ajuda a identificar módulos mal otimizados que estão sobrecarregando o checkout.

Passo 3: Verificar Logs do Servidor

Se o modo debug não mostrar nada (tela branca ou erro 500 sem detalhes):

• Apache: /var/log/apache2/error.log
• Nginx: /var/log/nginx/error.log
• PHP-FPM: /var/log/php8.x-fpm.log

Procure por mensagens como:

• Timeout
• Memory exhausted
• proc_open()
• undefined function

Passo 4: Auditoria de Módulos do Checkout

Mais de 70% dos problemas no checkout vêm de módulos de terceiros .

Metodologia profissional (sem quebrar a loja):

1. Primeiro, identifique quais módulos AFETAM o checkout:
   • Módulos de pagamento (PayPal, Mercado Pago, PIX, PagSeguro)
   • Módulos de frete (Correios, transportadoras)
   • Módulos que adicionam campos no checkout
   • Módulos de validação de endereço/CPF
2. Desative SOMENTE esses módulos, um por um:
   • Desative 1 módulo
   • Teste o checkout
   • Se funcionar → encontrou o culpado
   • Reative e desative o próximo
3. Verifique a compatibilidade: Conflito de módulos PrestaShop: como identificar, corrigir e evitar erros

4. Solução por Tipo de Problema {#solucoes}

Erro de JavaScript no Checkout {#js}

Sintomas:

• Botões não respondem
• Checkout “congela” ao clicar
• Console do navegador mostra erros vermelhos

Causas comuns:

• Módulos de pagamento com scripts duplicados
• Tema com jQuery conflitante
• Scripts de terceiros (Chat, Pixel, Analytics)

Solução:

1. Identifique o script problemático no console (a linha de erro geralmente indica o arquivo)
2. Desative o módulo relacionado ao script
3. Se for do tema, teste com o tema Classic
4. Se for script de terceiro, remova temporariamente o código do header

Erro 500 no Último Passo do Checkout {#erro500}

Sintoma: Cliente preenche tudo, clica em “Finalizar pedido” → erro 500

Causas comuns:

• Problema no hook actionValidateOrder
• Módulo de pagamento com erro na função validateOrder()
• Problema no envio de e-mail (função proc_open bloqueada)

Solução passo a passo:

1. Ative o modo debug (como mostrado acima)
2. Recrie o erro (tente finalizar um pedido)
3. Leia a mensagem de erro — ela indicará o arquivo e linha exatos

Exemplo real: Se o erro menciona proc_open() ou email, o problema é no envio de e-mails.

• Configure SMTP no lugar de mail()
• Ou solicite à hospedagem que libere a função

Exemplo 2: Se o erro menciona actionValidateOrder, verifique Erros de pagamento específicos: causas, diagnósticos e soluções completas

Checkout com Media Server Configurado {#mediaserver}

Sintoma: Módulos de pagamento externo (como ps_checkout) não carregam, checkout quebrado

Causa: Bug no PrestaShop que substitui o caminho correto do script JS por apenas https://MediaServer1

Solução rápida:

1. Acesse Parâmetros Avançados > Desempenho
2. Localize a configuração Media Server
3. Remova os valores configurados (deixe em branco)
4. Limpe o cache e teste

Solução definitiva: Aguardar o patch ou aplicar a correção manual descrita no GitHub issue #36939

Checkout “Trava” por Lentidão Extrema {#servidor}

Sintoma: O checkout não “travou” tecnicamente, mas está tão lento que parece travado

Causas:

• Servidor sobrecarregado (CPU 100%)
• Consultas SQL lentas no checkout
• TTFB alto (acima de 2s)

Soluções:

1. Otimize o servidor:
   • Aumente memory_limit para 512M
   • Aumente max_execution_time para 300
   • Ative Redis PrestaShop Redis: Como Configurar e Acelerar
2. Otimize o banco de dados:
   • Crie índices nas tabelas ps_cart, ps_orders, ps_address
   • Limpe logs antigos
3. Considere uma hospedagem mais robusta:
   Melhor Hospedagem PrestaShop: Escolha Certa para Velocidade, Estabilidade e Crescimento

Para diagnóstico completo de performance: PrestaShop lento: como resolver e deixar sua loja muito mais rápida

5. Módulo PrestaShop Checkout: O Maior Vilão {#modulo-checkout}

Se você está usando o módulo oficial PrestaShop Checkout (desenvolvido em parceria com o PayPal), esta é a causa mais provável do seu problema.

Por que este módulo causa tantos problemas?

Segundo relatos no fórum oficial, o módulo tem causado :

• ❌ Checkout quebrado após atualizações
• ❌ Incompatibilidade com temas customizados
• ❌ Conflitos com outros módulos de frete e pagamento
• ❌ Falta de suporte e atualizações inconsistentes

Como corrigir problemas com este módulo

Solução 1: Reiniciar o módulo

1. Módulos > Gerenciador de Módulos
2. Busque “PrestaShop Checkout”
3. Clique em Reiniciar (reset)

Solução 2: Remover Media Server (se configurado)

Conforme descrito na seção 4, o módulo tem um bug conhecido com Media Server .

Solução 3: Substituir por alternativas mais estáveis

Muitos desenvolvedores recomendam evitar este módulo e usar alternativas :

Para mais opções: Módulos de pagamento PrestaShop: guia completo

6. Prevenção: Como Evitar que o Checkout Trave Novamente {#prevencao}

Checklist de Prevenção

Configurações Recomendadas

1. Cache bem configurado:
   Cache PrestaShop: Como Configurar Corretamente e acelerar sua loja
2. Manutenção contínua:
   Manutenção PrestaShop: Garanta Sua Loja Sempre Estável e Segura
3. Monitoramento ativo:
   Configure alertas para erros no checkout (UptimeRobot, Pingdom)

Antes de Instalar QUALQUER Módulo Novo

1. Verifique se é compatível com sua versão do PrestaShop
2. Leia avaliações de outros usuários
3. Teste em ambiente de staging primeiro
4. Faça backup completo da loja

Para escolher módulos confiáveis: Como Escolher Addons PrestaShop sem Travar sua Loja

7. Quando Contratar um Especialista {#especialista}

Sinais de que você precisa de ajuda profissional

• ✅ Você seguiu todo este guia e o checkout continua travado
• ✅ O erro envolve código personalizado (overrides, temas customizados)
• ✅ O problema é intermitente (às vezes funciona, às vezes não)
• ✅ Sua loja fatura mais de R$ 10.000/mês (cada hora parada custa caro)
• ✅ Você não tem conhecimento técnico para ativar debug ou interpretar erros

Opções de suporte especializado

Conclusão

Checkout travando é o problema mais crítico que uma loja PrestaShop pode ter.

Lembre-se:

• ✅ Este artigo foca em TRAVAMENTO (checkout não funciona)
• ✅ Se seu checkout é lento mas funciona, consulte PrestaShop lento: como resolver
• ✅ Para erros específicos de pagamento, veja Erros de pagamento específicos

Sua loja está perdendo vendas agora? Solicite diagnóstico urgente

Links Relacionados

• PrestaShop Tela Branca: Como Resolver
• Erro 500 PrestaShop: Guia Completo
• Timeout no PrestaShop: Causas e Soluções
• Debug no PrestaShop (modo dev)
• PrestaShop Redis: Como Configurar
• Melhor Hospedagem PrestaShop
• Requisitos de Servidor PrestaShop