Solução de problemas do App CartDNA
Resolva problemas comuns do App CartDNA rapidamente. Verifique erros de configuração, problemas de métodos de pagamento, conflitos do checkout Shopify e bloqueios de faturamento. Use este guia para encontrar a causa, aplicar a correção e colocar seu checkout de volta nos trilhos.
A maioria dos problemas do App CartDNA vem de pequenos erros de configuração. Com base em nossa experiência, isso cobre a grande maioria dos problemas. Credenciais erradas, campos ausentes, métodos de pagamento inativos e lacunas de faturamento podem parar o checkout. Esta página ajuda você a identificar o problema e corrigi-lo com confiança.
Lista de verificação de solução de problemas do App CartDNA
Antes de abrir um ticket de suporte, execute estas verificações primeiro. Esta auditoria rápida resolve muitos problemas e ajuda você a encontrar o ponto exato de falha mais rápido.
Como corrigir problemas de configuração de Apps CartDNA
Problemas de configuração são a causa mais comum de erros do App CartDNA. Um único valor errado pode impedir que uma opção de pagamento carregue, autorize ou apareça no checkout. Comece aqui se o app está instalado mas não funciona como esperado.
Chaves API ou credenciais erradas
Muitos comerciantes copiam a chave errada, colocam valores no campo errado ou misturam detalhes de teste e produção. Isso causa transações com falha, métodos de pagamento ocultos ou erros de conexão na área de configuração do app.
O que verificar
- •A chave API corresponde à conta correta do provedor de pagamento
- •ID do comerciante, segredo, token ou endpoint colados no campo certo
- •Credenciais de teste são usadas apenas no modo de teste
- •Credenciais de produção são usadas apenas no modo de produção
- •Não existem espaços ou caracteres faltando nos valores copiados
Melhor ação
- •Salvar novamente as configurações
- •Executar checkout de teste
- •Review setup guidance at Integration
Detalhes de configuração personalizada ausentes
Alguns Apps CartDNA precisam de configurações personalizadas extras para funcionar corretamente. Isso pode incluir opções específicas do comerciante, detalhes de callback, configurações de ambiente ou regras de métodos de pagamento exigidas pelo provedor.
Sinais comuns
- O método de pagamento carrega mas falha após seleção
- Pedidos não completam
- Problemas de redirecionamento ou autorização ocorrem
O que fazer
- •Verificar cada campo necessário na configuração do app
- •Confirmar que opções específicas do provedor estão completas
- •Testar novamente cada fluxo de pagamento após fazer alterações
Conflito de modo de teste e modo de produção
Este é um erro frequente. Comerciantes às vezes adicionam credenciais de teste e tentam checkout de produção. Outros adicionam credenciais de produção e testam apenas em sandbox. Este conflito frequentemente bloqueia transações ou oculta métodos de pagamento.
Corrija com esta regra simples
- Credenciais de teste + checkout de teste
- Credenciais de produção + checkout de produção
Sempre execute um checkout de teste bem-sucedido antes do lançamento público.
Problemas de métodos de pagamento
Às vezes o App CartDNA está configurado corretamente, mas o método de pagamento ainda não aparece ou processa. Nestes casos, o problema frequentemente está com a conta do provedor de pagamento, não com Shopify ou o App CartDNA em si.
Método de pagamento não ativado no provedor
Um método de pagamento deve estar ativo no lado do processador antes que Shopify possa usá-lo. Se o método não foi ativado, clientes não o verão no checkout, mesmo que sua configuração do App CartDNA pareça correta.
Verificar estes pontos
- •O método de pagamento está ativado em sua conta PSP
- •Seu provedor aprovou o método para seu negócio
- •O método suporta sua região, moeda e tipo de loja
Related page: Pagamentos
Provedor de pagamento desabilitou o método
Provedores às vezes desabilitam opções de pagamento devido a revisão de conta, onboarding incompleto, problemas de conformidade ou controles de risco. Quando isso acontece, o App CartDNA não pode forçar o método a funcionar.
O que fazer
- •Entrar no dashboard do seu provedor de pagamento
- •Verificar alertas e notificações da conta
- •Entrar em contato com o provedor se o método foi suspenso
- •Testar novamente após reativação
Solução de problemas do checkout Shopify
Configurações Shopify podem bloquear fluxos de pagamento, mesmo quando o App CartDNA está configurado corretamente. Se o checkout está falhando, verifique sua configuração Shopify em seguida. Estas verificações são especialmente importantes quando clientes não podem ver ou usar uma opção de pagamento.
Campos obrigatórios do checkout não ativados
Alguns métodos de pagamento precisam de dados do comprador como endereço de e-mail ou número de telefone. Se estes campos não são obrigatórios no checkout Shopify, o fluxo de pagamento pode falhar ou a opção de pagamento não aparecerá.
Verificar estas configurações
- •E-mail está ativado onde necessário
- •Número de telefone está ativado onde necessário
- •Captura de dados de faturamento e envio corresponde aos requisitos do provedor
Captura manual está ativada
Alguns métodos de pagamento não funcionam bem quando captura manual está ativa nas configurações de pagamento Shopify. Isso pode quebrar o fluxo esperado de autorização e captura.
Correção
- •Revisar sua configuração de captura no Shopify
- •Testar novamente o método de pagamento após ajustar
Países de faturamento ou envio não suportados
Se seus países de checkout não se alinham com os mercados suportados pelo método de pagamento, a opção pode permanecer oculta. Regras de países frequentemente se aplicam tanto a localizações de faturamento quanto de envio.
O que verificar
- •Países suportados estão ativados no Shopify
- •Configurações Shopify Markets estão corretas
- •O método de pagamento suporta o país sendo selecionado
Método de pagamento CartDNA instalado mas não ativado
Instalação por si só não completa a configuração. O método de pagamento também deve ser ativado do lado Shopify. Este é um passo simples mas frequentemente esquecido no lançamento.
Ação
- •Abrir Shopify Admin
- •Ir para configurações de pagamento
- •Confirmar que o método de pagamento CartDNA está ativo
- •Salvar alterações e testar checkout
Problema de assinatura Shopify ou faturamento de plataforma
Se sua assinatura Shopify está inativa ou um pagamento de faturamento Shopify falhou, checkout e comportamento do app podem ser impactados. Este problema fica fora das configurações normais do app, então vale a pena verificar cedo.
Revisar
- •Status da assinatura Shopify
- •Alertas de faturamento com falha
- •Avisos do admin afetando checkout ou acesso ao app
Conflito de regras de pagamento
Regras de ocultar e mostrar podem entrar em conflito umas com as outras. Quando isso acontece, o método de pagamento pode não aparecer para o comprador mesmo que o app esteja funcionando.
O que revisar
- •Regras de personalização de pagamento
- •Lógica de checkout ocultando apps de pagamento
- •Condições baseadas em mercado, país ou carrinho
Moeda da loja não suportada
Nem todo método de pagamento suporta todas as moedas. Se sua moeda padrão Shopify não é suportada, o cliente pode não ver a opção no checkout.
Verificar
- •Moeda padrão da loja
- •Configurações de moeda do mercado
- •Suporte de moeda do método de pagamento
Problemas de faturamento CartDNA
Alguns problemas de acesso ao app estão ligados a etapas de faturamento ou aceitação legal. Estas verificações são fáceis de perder mas podem bloquear o uso do app até serem completadas.
Termos de Serviço e acordos de licença não aceitos
Se os termos necessários, o acordo de licença ou etapas de onboarding não foram completados, seu App CartDNA pode não funcionar em estado completamente operacional.
Correção
- •Verificar solicitações de acordo pendentes
- •Aceitar todos os termos necessários
- •Confirmar que o onboarding está completo
Taxas CartDNA atrasadas
Faturas pendentes podem impactar o status do app. Uma lacuna de faturamento pode parar o acesso, pausar o serviço ou atrasar resolução de suporte até que a conta esteja em dia.
Ação
- •Procurar por taxas atrasadas
- •Atualizar detalhes de pagamento se necessário
- •Confirmar status da conta após pagar
Melhores práticas antes do lançamento
Testes adequados pré-lançamento reduzem problemas de checkout e protegem a conversão. Não confie apenas na configuração. Sempre execute testes reais de ponta a ponta antes de disponibilizar a opção de pagamento para compradores.
Etapas recomendadas
Perguntas frequentes
Por que meu método de pagamento CartDNA não aparece no checkout Shopify?
Isso geralmente aponta para um de quatro problemas: método de pagamento inativo, credenciais erradas, conflito de país ou moeda, ou regras de pagamento ocultando o app. Comece com ativação, credenciais e configurações de checkout.
Como corrigir erros de credenciais do App CartDNA?
Verifique novamente cada chave API, token e detalhe de comerciante na área de configuração. Certifique-se de que valores de teste e produção não estão misturados. Salve as alterações e execute um checkout de teste no modo correspondente.
Por que CartDNA funciona em modo de teste mas falha em modo de produção?
Falhas em modo de produção frequentemente acontecem porque credenciais de produção não foram adicionadas, o método de pagamento não está ativado pelo provedor, ou configurações de checkout Shopify estão bloqueando o fluxo.
Preciso entrar em contato com suporte CartDNA para cada problema?
Não. A maioria dos problemas pode ser corrigida verificando credenciais, status de ativação, campos Shopify, estado de faturamento e configuração teste vs produção. Entre em contato com suporte após executar as verificações nesta página.
Recursos relacionados
Começando
Aprenda os primeiros passos corretos para instalar e lançar Apps CartDNA.
Learn moreAjuda de integração
Revise dicas de configuração, ajuda de configuração e orientação técnica.
Learn moreMétodos de pagamento
Revise métodos de pagamento suportados e expectativas de configuração de pagamento.
Learn moreRecursos do App CartDNA
Entenda como CartDNA funciona dentro do checkout Shopify.
Learn moreCorrija seu App CartDNA mais rápido
A maioria dos problemas de solução de problemas do App CartDNA vem de configuração, ativação ou configurações de checkout. Use este guia para resolver o problema passo a passo, teste o fluxo e restaure uma experiência de checkout sem atritos para seus clientes.