Existe um tipo de incidente especialmente confuso em WooCommerce: o cliente tenta comprar, algo parece acontecer, mas ninguém consegue dizer exatamente onde a compra quebrou.
Às vezes o botão falha. Às vezes o gateway cobra, mas o pedido fica torto. Em outros casos, o retorno do pagamento não atualiza a loja como deveria. E aí começa a discussão improdutiva: “é o gateway”, “é o webhook”, “é o checkout”, “é o WooCommerce”.
Este guia existe para ajudar a dividir o problema por etapa.
O que fazer agora
Pergunte em qual ponto a linha quebra:
- o cliente consegue clicar em finalizar?
- a tentativa chega ao gateway?
- houve cobrança ou autorização?
- o pedido foi criado?
- o status atualizou?
Sem essa divisão, tudo vira “pagamento com problema”.
Quando parece checkout
Suspeite mais do checkout quando:
- botão não responde
- script falha antes da cobrança
- método não carrega
- a etapa final quebra visualmente
Quando parece gateway
Suspeite mais do gateway quando:
- a tentativa chega à adquirência, mas falha ali
- a mensagem principal está ligada à autorização, recusa ou comunicação financeira
- o problema se concentra em um método específico
Quando parece webhook ou atualização final
Suspeite mais dessa camada quando:
- o cliente é cobrado
- o pedido existe, mas fica inconsistente
- o status não fecha
- a operação depende de retorno que não completa
Se a borda também entrou na conversa, complemente com Cloudflare pode derrubar meu checkout?.
Uma forma simples de ler o fluxo
Se quiser reduzir ruído, pense assim:
- se o cliente nem consegue enviar a compra, olhe checkout
- se a compra chega ao provedor e falha ali, olhe gateway
- se há cobrança, mas o pedido não fecha, olhe retorno, webhook e atualização
Essa divisão não fecha o incidente sozinha, mas já impede que tudo seja tratado como um problema único e amorfo.
O que não fazer
Evite:
- tratar qualquer falha de compra como culpa automática do gateway
- confiar só na visão do WooCommerce ou só na visão do gateway
- fazer vários testes sem registrar o que cada etapa mostrou
- considerar “pagou no provedor” como prova de fluxo íntegro
Quando isso já virou incidente de verdade
Quando há cobrança, pedido inconsistente, atualização quebrada ou venda perdida, o cenário já saiu do ajuste comum.
O que separar antes de pedir suporte
Separe:
- horário da tentativa
- método de pagamento afetado
- print da falha
- status visto no gateway
- status visto na loja
- acesso ao WordPress
- acesso ao gateway
- acesso ao ERP, se o pedido também precisar sincronizar
- print do que aparece no pedido dentro da loja
- print do que aparece na transação dentro do provedor
Próximo passo se este é o seu cenário
Se o fluxo de compra está quebrado, o atendimento certo é este:
ver atendimento para checkout WooCommerce com erro
E, para continuar a triagem: