--- title: "Problemas comuns: documentação do CheckoutOS | Chargezen" description: "Soluções para problemas frequentes no CheckoutOS. Da seção Solução de problemas da documentação do CheckoutOS da Chargezen." url: "https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/common-issues" lang: "pt-BR" updated: "2025-01-16" --- Canonical URL: https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/common-issues # 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](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/error-codes) ou [entre em contato com o suporte](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support). ## Ofertas adicionais não aparecem Se as ofertas pós-compra não aparecem após o checkout, verifique o seguinte: 1 #### Verificar se a campanha está ativa 2 #### Verificar regras de segmentação 3 #### Confirmar a integração com Shopify 4 #### Testar com um pedido real Teste rápido 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: 1. Acesse Shopify Admin → Settings → Checkout → Customize 2. Procure as extensões do CheckoutOS entre os blocos disponíveis 3. Arraste-as até a posição desejada no layout do checkout 4. 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 Acúmulo de descontos 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 1 #### Revisar descontos ativos 2 #### Verificar as configurações de combinação 3 #### 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 Verificar erros de JavaScript ```javascript // 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 issue ``` ## Dados 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 1 #### Verificar o status da integração 2 #### Revisar o status dos webhooks 3 #### 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? [ ### Códigos de erro Consulte códigos de erro específicos e seus significados Saiba mais ](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/error-codes)[ ### Fale com o suporte Receba ajuda da nossa equipe de suporte Saiba mais ](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support) Esta página foi útil? Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support)