Problemas comuns
Soluções para problemas frequentes no CheckoutOS
Última atualização: 2025-01-16
Este guia reúne os problemas mais comuns no CheckoutOS e suas soluções. Se não encontrar seu problema aqui, consulte a referência de códigos de erro ou entre em contato com o suporte.
Ofertas adicionais não aparecem
Se as ofertas pós-compra não aparecem após o checkout, verifique o seguinte:
Verificar se a campanha está ativa
Verificar regras de segmentação
Confirmar a integração com Shopify
Testar com um pedido real
Crie uma campanha sem regras de segmentação, exibida a todos, com desconto de 100% em um produto de baixo valor. Faça um pedido de teste para verificar se o fluxo funciona.
Extensões de checkout não aparecem
Se selos de confiança, barras de progresso ou outras extensões de checkout não estiverem visíveis:
Requisito do Shopify Plus
As extensões nativas de checkout exigem uma destas opções:
- Plano Shopify Plus; ou
- Acesso ao beta de Checkout Extensibility, disponível para algumas lojas sem Plus
Verifique seu plano em Shopify Admin → Settings → Plan.
Posicionamento das extensões
Verifique se as extensões estão em um local visível:
- Acesse Shopify Admin → Settings → Checkout → Customize
- Procure as extensões do CheckoutOS entre os blocos disponíveis
- Arraste-as até a posição desejada no layout do checkout
- Salve e visualize as alterações
Conflitos de descontos
Os descontos do CheckoutOS podem entrar em conflito com descontos existentes da Shopify ou de outros apps. Os sintomas comuns incluem:
- Desconto da oferta adicional não aplicado
- Valor de desconto incorreto
- Vários descontos acumulados inesperadamente
A Shopify limita as combinações de descontos. Se o cliente já aplicou um código, os descontos das ofertas adicionais do CheckoutOS podem não ser aplicados. Configure suas regras em Dashboard → Settings → Discount Functions.
Etapas para resolver
Revisar descontos ativos
Verificar as configurações de combinação
Configurar a prioridade do CheckoutOS
Carregamento lento ou tempo esgotado
Se os recursos do CheckoutOS carregarem lentamente ou excederem o tempo limite:
Problemas de rede
- Verifique a estabilidade da conexão com a internet
- Tente limpar o cache e os cookies do navegador
- Teste em uma janela anônima ou privada
- Desative temporariamente as extensões do navegador
Conflitos entre apps
Outros apps da Shopify podem ocasionalmente entrar em conflito com o CheckoutOS:
- Desative temporariamente outros apps relacionados ao checkout
- Verifique se há erros de JavaScript no console de desenvolvedor do navegador
- Revise apps instalados recentemente que possam afetar o checkout
// Open browser developer tools (F12) and check the Console tab
// Look for errors mentioning:
// - chargezen
// - checkoutos
// - checkout-extension
// Common error patterns:
// "Failed to load resource" - Network/CORS issue
// "undefined is not a function" - JavaScript conflict
// "Extension blocked" - CSP or ad blocker issueDados de análise não são registrados
Se o painel não mostrar dados ou apresentar métricas incorretas:
Atraso dos dados
As métricas do painel têm um atraso de 15 minutos. Para dados em tempo real, use a seção Analytics, que oferece atualizações ao vivo.
Verificar o rastreamento
Verificar o status da integração
Revisar o status dos webhooks
Faça um pedido de teste
Problemas de exibição em dispositivos móveis
Se os recursos do CheckoutOS não aparecerem corretamente em dispositivos móveis:
- Teste em dispositivos reais, não apenas na emulação do navegador
- Confira as configurações para dispositivos móveis em Dashboard → Settings → Store → Mobile Behavior
- Revise o CSS personalizado em busca de problemas nos pontos de quebra para dispositivos móveis
- Confirme que seu tema Shopify é responsivo em dispositivos móveis
Ainda precisa de ajuda?
Precisa de mais ajuda? Fale com o suporte