Um pedido Magento 2 pendente após pagamento pode confundir o atendimento, atrasar a expedição e até provocar uma cobrança duplicada quando o cliente tenta comprar novamente. Nem sempre, porém, o status pendente representa uma falha: autorização, captura e criação da fatura podem ocorrer em momentos diferentes, conforme a configuração do meio de pagamento.
Antes de alterar o pedido manualmente, registre o número da compra, horário, método utilizado, identificador da transação e status exibido pelo gateway. Os oito testes abaixo ajudam a localizar a quebra sem apagar logs ou criar divergências financeiras.
Pedido Magento 2 pendente após pagamento: entenda os estados
No Magento, estado e status não são necessariamente a mesma coisa. O estado representa uma etapa interna do fluxo, enquanto o status é o rótulo associado a ela. Além disso, a mensagem “pagamento aprovado” pode significar apenas que a transação foi autorizada, sem captura efetiva do valor.
Antes do diagnóstico, responda:
- o pedido existe no Admin ou somente no sistema do gateway;
- o pagamento foi autorizado ou capturado;
- há fatura criada no Magento;
- o estoque foi reservado ou baixado;
- o cliente recebeu a confirmação do pedido;
- o problema afeta todos os métodos ou apenas um;
- o status muda sozinho depois de alguns minutos.
Essa classificação separa um processamento assíncrono normal de uma integração interrompida.
1. Confirme se o pedido realmente foi criado
Pesquise no Admin pelo número incremental, e-mail do cliente, horário e valor. Se o pagamento aparece no gateway, mas não existe pedido no Magento, a interrupção pode ter ocorrido entre a autorização e a conclusão do checkout.
Verifique também se o carrinho permaneceu ativo. Um pedido ausente não deve ser “corrigido” apenas criando outro manualmente, pois a transação original pode ser confirmada depois e gerar duplicidade. Se a jornada também perde produtos ou volta vazia, siga o diagnóstico de sessão e carrinho do Magento 2.
2. Diferencie autorização, captura e liquidação
Abra os detalhes da transação no painel do provedor e identifique a operação registrada. Uma autorização reserva ou valida o valor, mas não significa necessariamente que ele foi capturado. A liquidação pode acontecer posteriormente, fora do Magento.
Compare os identificadores exibidos pelo provedor com os dados do pedido e da transação no Admin. Não use apenas a mensagem mostrada ao consumidor como prova de captura. Em integrações com retorno externo, teste também a volta do navegador para a loja, mas lembre-se de que esse redirecionamento não deveria ser a única fonte de confirmação financeira.
3. Consulte o histórico do pedido e as transações
No Admin, abra o pedido e examine comentários, faturas, transações e alterações de status. Procure por mensagens de autorização, captura recusada, validação antifraude, retorno inválido ou tentativa repetida.
Se houver acesso técnico ao banco, faça somente consultas de leitura e sempre respeite o prefixo de tabelas do ambiente. Por exemplo:
SELECT entity_id, increment_id, state, status, created_at, updated_at
FROM sales_order
WHERE increment_id = 'NUMERO_DO_PEDIDO';
Uma diferença relevante entre created_at e updated_at pode indicar processamento posterior, mas não prova a causa. Evite atualizar diretamente as tabelas sales_order, sales_payment_transaction ou sales_invoice: mudar um rótulo não executa as operações comerciais associadas.
4. Correlacione os logs pelo horário e identificador
Examine var/log/system.log, var/log/exception.log, logs específicos do módulo e registros do servidor web ou PHP. Use o horário da tentativa, o número do pedido e o identificador da transação para reduzir o volume:
grep -RiE "NUMERO_DO_PEDIDO|ID_DA_TRANSACAO" var/log/
Procure por timeout, erro de autenticação, resposta HTTP inesperada, assinatura inválida, exceção ao criar fatura ou falha ao salvar o pedido. Preserve uma cópia dos trechos relevantes antes de rotacionar arquivos ou reiniciar serviços.
5. Teste o webhook ou a notificação do gateway
Muitos módulos dependem de uma notificação servidor a servidor para transformar a aprovação externa em atualização no Magento. Se o endpoint estiver bloqueado, responder com erro ou demorar demais, o gateway poderá considerar a entrega malsucedida.
No painel do provedor, verifique o histórico de notificações, o código HTTP recebido e as tentativas de reenvio. Na infraestrutura, confirme se a URL pública está acessível e se firewall, CDN, WAF ou regras de autenticação não bloqueiam a chamada. Não desative proteções globalmente; crie uma exceção limitada somente quando a documentação e o teste controlado justificarem.
Integrações próprias também precisam validar contratos e respostas. O roteiro de testes para APIs REST e GraphQL do Adobe Commerce ajuda a organizar essa homologação.
6. Verifique cron e filas de mensagens
Algumas integrações atualizam pagamentos, criam faturas ou processam notificações de forma assíncrona. Confirme se o cron está ativo e se existem tarefas atrasadas:
bin/magento cron:run
bin/magento queue:consumers:list
Executar o cron manualmente uma vez pode ajudar no diagnóstico, mas não substitui a correção do agendamento do sistema. Antes de iniciar consumidores manualmente em produção, identifique quais são exigidos pelo módulo, como eles são gerenciados e se já existe outro processo ativo. Consumidores duplicados ou executados sem supervisão podem aumentar a carga e dificultar a análise.
7. Compare configuração e credenciais do ambiente
Confirme se o módulo está em modo de produção ou homologação, se as credenciais pertencem à conta correta e se a URL de notificação corresponde ao domínio atual. Após clonagens, trocas de domínio ou implantações, é possível manter chaves de outro ambiente ou callbacks apontando para uma instalação antiga.
Compare configurações sem expor segredos em chamados, capturas de tela ou logs compartilhados. Verifique ainda moeda, website, visão de loja, método de captura e associação entre status. Se o problema começou após uma implantação, revise as alterações do módulo e da configuração, em vez de limpar todos os caches como primeira medida.
8. Reproduza em homologação com cenários controlados
Use credenciais de teste e execute pelo menos quatro cenários: aprovação, recusa, cancelamento e atraso na notificação. Valide o pedido no Admin, a transação, a fatura, os e-mails, o estoque e a resposta apresentada ao cliente.
Teste também notificações repetidas. O processamento deve ser idempotente: receber novamente o mesmo evento não deveria criar outra fatura, capturar o valor duas vezes ou alterar um pedido já concluído. Quando o problema estiver relacionado especificamente ao PayPal e ao Payment Services, consulte os testes de checkout e retorno do PayPal.
O que não fazer para “destravar” o pedido
- não altere estado e status diretamente no banco;
- não capture novamente sem confirmar a situação no provedor;
- não crie uma segunda compra antes de conciliar a transação original;
- não apague logs ou tabelas de filas antes de preservar evidências;
- não libere a expedição usando apenas uma captura de tela do cliente;
- não desative firewall ou antifraude de forma ampla para testar.
Se houver cobrança sem pedido válido, envolva as equipes financeira e de atendimento. A decisão entre aguardar, estornar, cancelar ou reconstruir a operação depende do estado real da transação e das regras do negócio.
Conclusão
Um pedido Magento 2 pendente após pagamento deve ser investigado como uma cadeia: checkout, provedor, notificação, aplicação, cron, filas e criação da fatura. O ponto decisivo é conciliar os identificadores e horários de todos os sistemas antes de alterar qualquer registro.
Se a loja acumula pedidos pendentes ou apresenta divergências entre Magento e gateway, uma análise técnica pode localizar a etapa interrompida e definir uma correção segura. A equipe do SuporteMagento.com.br pode apoiar o diagnóstico, a homologação e a revisão da integração.
Perguntas frequentes
Pedido pendente significa que o pagamento falhou?
Não necessariamente. O valor pode estar apenas autorizado, aguardando captura, análise antifraude ou processamento de uma notificação. Confirme o estado diretamente no provedor e compare o identificador da transação.
Posso mudar o status do pedido manualmente no Magento?
A alteração manual pode ser inadequada quando não existe captura ou fatura correspondente. Nunca atualize diretamente o banco para simular a conclusão. Primeiro identifique a causa e confirme os efeitos financeiros e operacionais.
Por que o gateway aprovou, mas o pedido não existe no Admin?
A aplicação pode ter falhado depois da autorização e antes de concluir o pedido, ou a confirmação pode depender de um webhook que não foi processado. Logs, carrinho, histórico do gateway e notificações ajudam a localizar a quebra.
Limpar o cache resolve pedido pendente?
Normalmente não. Cache raramente é a causa direta de uma transação que não atualizou. A limpeza indiscriminada também pode dificultar a reprodução sem corrigir webhook, cron, fila ou integração.

