CHECKOUT101: Falha na finalização, carrinho preservado

O que isso significa

A finalização da compra não foi concluída, e o carrinho continua seguro para uma nova tentativa.

Revise o carrinho e tente finalizar novamente; o conteúdo atual do carrinho foi preservado.

O que fazer

Tente a ação novamente. O WCPOS não repete isso sozinho — tente de novo quando estiver pronto.

Seus dados

O pedido em si está seguro e inalterado.

Solução de problemas

1. Revise o carrinho — ele está inalterado — e tente finalizar a compra novamente.
2. Se falhar da mesma forma, expanda a entrada de log: o serverCode e o status indicam se a loja recusou o pedido e por quê.
3. Uma falha repetida com status da classe 500 é um problema do site — verifique WooCommerce → Status → Logs em busca de um erro do PHP no horário da falha.
4. Se o motivo indicar um item específico, remova-o, conclua a venda e investigue esse produto depois.

Onde verificar

Quando o WCPOS consegue salvar este erro, ele é registrado no dispositivo que o gerou. Abra Saúde da loja → Logs (o ícone de batimento cardíaco na parte inferior do menu de navegação), localize a entrada marcada com este código e expanda-a: a linha expandida mostra o motivo em linguagem simples e o contexto capturado no momento da falha. Em uma requisição à loja, esse contexto pode incluir o código de erro do próprio servidor (serverCode), o status HTTP ou o endpoint; os campos exibidos dependem de onde a falha ocorreu. Ao relatar um problema, use Copiar informações de depuração no topo da tela de Logs (Compartilhar informações de depuração em celulares e tablets) em vez de capturas de tela: isso reúne a versão do aplicativo, o estado da conexão e os erros mais recentes. Os logs são mantidos por no máximo 30 dias, portanto colete-os enquanto o problema estiver recente. Copie também qualquer erro do console do navegador que tenha aparecido antes de o POS conseguir gravar sua própria entrada de log.

Além do log no aplicativo, esta falha pode deixar evidências em:

• Inspetor de rede (web e desktop): abra as ferramentas de desenvolvedor — pressione F12 no navegador ou use Avançado → Alternar ferramentas de desenvolvedor no menu do aplicativo desktop — e selecione a aba Rede. Siga primeiro as orientações de nova tentativa desta página; só reproduza a ação quando esses passos indicarem que é seguro. Uma requisição com falha mostra o status HTTP e o corpo bruto da resposta, incluindo páginas de erro que nunca chegam ao log do POS.
• Logs do POS no servidor: no WP Admin, abra POS → Configurações → Ferramentas → Logs. Essa página registra avisos e erros relacionados ao POS gerados no próprio servidor, que podem nunca aparecer dentro do aplicativo. Um selo vermelho no menu indica erros do servidor não lidos.
• WooCommerce → Status → Logs: no site WordPress, verifique o fatal-errors-*.log mais recente em busca de falhas do PHP, além de qualquer fonte de log com o nome de um plugin envolvido na falha. Um erro da classe 500 vindo da loja quase sempre deixa sua causa aqui.

Detalhes

• Código: CHECKOUT101 (CHECKOUT_FAILED_CART_SAFE)
• Severidade: error
• Introduzido em: WCPOS 1.10.0