Atualizar Configurações e Chaves API do App CartDNA
Precisa corrigir uma chave, mudar de teste para produção ou conectar uma subconta diferente? Você pode atualizar as configurações do app CartDNA sem reinstalar o aplicativo. Isso economiza tempo, reduz atritos na configuração e ajuda a manter os pagamentos funcionando sem problemas.
Funciona para atualizações de chaves, alterações de conta dentro do mesmo processador e correção de erros de configuração anteriores.
O que você pode atualizar em um app CartDNA?
Você pode editar chaves API, alterar detalhes de configuração e conectar uma conta ou subconta diferente dentro do mesmo processador de pagamentos. Você não precisa comprar uma nova licença para essa alteração. O app permanece instalado. Sua configuração é simplesmente atualizada com os novos detalhes de conexão.
- Atualizar chaves de teste para chaves de produção
- Substituir credenciais API incorretas
- Editar detalhes de configuração existentes
- Conectar uma subconta diferente
- Conectar uma conta diferente dentro do mesmo processador
Você pode trocar contas dentro do mesmo processador de pagamentos. Você não pode trocar o app de um processador para outro processador.
Regra importante antes de fazer alterações
Os apps CartDNA suportam alterações de chaves e alterações de conta dentro do mesmo processador. Isso oferece flexibilidade quando a estrutura da sua conta PSP muda. Mas cada processador usa APIs diferentes, lógica de autenticação diferente e arquitetura de conexão diferente. É por isso que a troca de processador não é suportada dentro do mesmo app instalado.
O que você pode fazer
- Trocar chaves API dentro do mesmo processador
- Mover de uma subconta para outra subconta
- Mudar do modo de teste para o modo de produção
- Corrigir erros de configuração anteriores sem reinstalar o app
O que você não pode fazer
- Alterar o processador conectado do Processador A para o Processador B
- Reutilizar o mesmo app para um processador de pagamentos completamente diferente
- Pular um novo acordo ao mudar para um novo processador
Se você quiser usar um processador diferente, você precisa de: um novo app CartDNA, uma nova conexão de processador e um novo acordo assinado e processo de aprovação.
Por que comerciantes atualizam configurações e chaves API do CartDNA
A maioria dos comerciantes atualiza configurações durante crescimento, testes ou alterações de conta. Isso geralmente acontece quando uma empresa passa de pagamentos sandbox para produção, corrige erros de configuração ou precisa conectar uma conta de comerciante diferente sob o mesmo PSP. Atualizações rápidas reduzem a interrupção do checkout e ajudam a proteger a taxa de conversão.
Mudar de teste para produção
Substitua chaves sandbox por credenciais de produção quando estiver pronto para receber pagamentos reais de clientes.
Corrigir erros de configuração
Corrija chaves API inválidas, segredos incorretos ou valores de configuração adicionados anteriormente.
Trocar para outra subconta
Conecte uma conta aprovada diferente dentro da mesma configuração do processador de pagamentos.
Editar detalhes de configuração
Atualize as configurações do app para corresponder aos novos detalhes da conta PSP ou requisitos da loja.
Como atualizar/trocar chaves API do app CartDNA
Você geralmente pode atualizar suas configurações em alguns passos claros. Siga o processo cuidadosamente. Isso ajuda você a evitar erros de autenticação, pagamentos falhados e interrupção da loja. Sempre verifique duas vezes os valores antes de salvar qualquer alteração.
Método 1: Atualizar através do Admin do Shopify
- 1Faça login no seu admin do Shopify.
- 2Abra o app de pagamentos CartDNA.
- 3Vá para a área de configurações do app.
- 4Encontre a seção de credenciais API.
- 5Substitua as chaves antigas pelas novas chaves corretas.
- 6Atualize quaisquer campos de configuração relacionados, se necessário.
- 7Salve suas alterações.
- 8Execute um pagamento de teste se o modo de teste estiver ativo.
- 9Verifique se o app está se conectando corretamente.
Método 2: Atualizar através do portal do comerciante CartDNA
- 1Faça login no seu portal do comerciante CartDNA.
- 2Abra a loja ou conta vinculada ao seu app.
- 3Vá para as configurações de conexão ou credenciais API.
- 4Digite os novos detalhes da chave.
- 5Revise todos os valores de configuração relacionados.
- 6Salve as novas configurações.
- 7Confirme o status da conexão.
- 8Teste o comportamento do checkout antes de confiar na nova configuração.
Support note: Se você não conseguir acessar o portal ou sua atualização falhar, contate o suporte CartDNA antes de fazer alterações repetidas.
Melhores práticas antes de salvar novas chaves API
Um pequeno erro nas credenciais pode bloquear pagamentos, interromper a comunicação do app ou criar tentativas de checkout falhadas. Use esta lista de verificação antes de salvar alterações. Isso ajuda a proteger a receita e oferece uma transição mais suave.
- Confirme que você está usando a conta correta
- Verifique se as chaves são de teste ou produção
- Copie a chave completa sem caracteres faltando
- Revise os campos de configuração relacionados
- Salve alterações apenas após uma verificação final
- Execute uma transação de teste
- Confirme autorização bem-sucedida e criação de pedido
- Revise logs ou mensagens de erro se a conexão falhar
Mudando de chaves de teste para chaves de produção
Esta é uma das atualizações mais comuns que os comerciantes fazem. As chaves de teste ajudam você a verificar o fluxo com segurança. As chaves de produção ativam pagamentos reais. Você deve trocar apenas após ter validado o checkout, a configuração do app e a preparação da conta do processador.
Antes de mudar para produção
- Certifique-se de que sua conta PSP de produção está aprovada
- Confirme que a conta de produção corresponde aos detalhes do seu negócio
- Verifique moedas e métodos de pagamento
- Confirme configurações de webhook ou callback, se necessário
- Execute um teste final de ponta a ponta
Depois de mudar para produção
- Realize uma transação real controlada, se apropriado
- Verifique o status de autorização do pagamento
- Verifique a criação de pedidos no Shopify
- Monitore de perto os primeiros pedidos de produção
- Mantenha os detalhes de contato do suporte prontos em caso de erros
Próximos passos úteis
Links internos ajudam os usuários a avançar mais rapidamente. Eles também ajudam os mecanismos de busca a entender os relacionamentos entre páginas. Adicione links contextuais dentro do conteúdo e um pequeno hub de links perto do final da página para navegação mais forte e maior valor de SEO.
Perguntas frequentes
Posso atualizar as configurações do app CartDNA sem reinstalar o app?▼
Posso mudar para uma subconta diferente no mesmo processador?▼
Posso alterar o app de um processador de pagamentos para outro?▼
Posso mudar de chaves de teste para chaves de produção?▼
O que devo fazer se as novas chaves não funcionarem?▼
Precisa de ajuda para atualizar sua conexão CartDNA?
Se você precisa editar chaves, corrigir erros de configuração ou conectar uma conta diferente dentro do mesmo processador, o suporte CartDNA pode ajudá-lo a fazer isso com segurança. Aja antes que um problema de configuração afete o desempenho do checkout ou a confiança do cliente.