Atualizar Definições e Chaves API da Aplicação CartDNA
Precisa de corrigir uma chave, mudar de teste para produção ou conectar uma subconta diferente? Pode atualizar as definições da aplicação CartDNA sem reinstalar a aplicação. Isto poupa tempo, reduz atritos na configuração e ajuda a manter os pagamentos a funcionar 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 pode atualizar numa aplicação CartDNA?
Pode editar chaves API, alterar detalhes de configuração e conectar uma conta ou subconta diferente dentro do mesmo processador de pagamentos. Não precisa de comprar uma nova licença para esta alteração. A aplicação permanece instalada. A sua configuração é simplesmente atualizada com os novos detalhes de ligaçã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
Pode trocar contas dentro do mesmo processador de pagamentos. Não pode trocar a aplicação de um processador para outro processador.
Regra importante antes de fazer alterações
As aplicações CartDNA suportam alterações de chaves e alterações de conta dentro do mesmo processador. Isto oferece flexibilidade quando a estrutura da sua conta PSP muda. Mas cada processador usa APIs diferentes, lógica de autenticação diferente e arquitectura de ligação diferente. É por isso que a troca de processador não é suportada dentro da mesma aplicação instalada.
O que 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 a aplicação
O que não pode fazer
- Alterar o processador ligado do Processador A para o Processador B
- Reutilizar a mesma aplicação para um processador de pagamentos completamente diferente
- Saltar um novo acordo ao mudar para um novo processador
Se quiser usar um processador diferente, precisa de: uma nova aplicação CartDNA, uma nova ligação de processador e um novo acordo assinado e processo de aprovação.
Porque os comerciantes atualizam definições e chaves API do CartDNA
A maioria dos comerciantes atualiza definições durante crescimento, testes ou alterações de conta. Isto geralmente acontece quando uma empresa passa de pagamentos sandbox para produção, corrige erros de configuração ou precisa de 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 definições da aplicação para corresponder aos novos detalhes da conta PSP ou requisitos da loja.
Como atualizar/trocar chaves API da aplicação CartDNA
Geralmente pode atualizar as suas definições em alguns passos claros. Siga o processo cuidadosamente. Isto ajuda a evitar erros de autenticação, pagamentos falhados e interrupção da loja. Verifique sempre duas vezes os valores antes de guardar qualquer alteração.
Método 1: Atualizar através do Admin do Shopify
- 1Inicie sessão no seu admin do Shopify.
- 2Abra a aplicação de pagamentos CartDNA.
- 3Vá para a área de definições da aplicação.
- 4Encontre a secção de credenciais API.
- 5Substitua as chaves antigas pelas novas chaves corretas.
- 6Atualize quaisquer campos de configuração relacionados, se necessário.
- 7Guarde as suas alterações.
- 8Execute um pagamento de teste se o modo de teste estiver ativo.
- 9Verifique se a aplicação está a conectar-se corretamente.
Método 2: Atualizar através do portal do comerciante CartDNA
- 1Inicie sessão no seu portal do comerciante CartDNA.
- 2Abra a loja ou conta vinculada à sua aplicação.
- 3Vá para as definições de ligação ou credenciais API.
- 4Introduza os novos detalhes da chave.
- 5Reveja todos os valores de configuração relacionados.
- 6Guarde as novas definições.
- 7Confirme o estado da ligação.
- 8Teste o comportamento do checkout antes de confiar na nova configuração.
Support note: Se não conseguir aceder ao portal ou a sua atualização falhar, contacte o suporte CartDNA antes de fazer alterações repetidas.
Melhores práticas antes de guardar novas chaves API
Um pequeno erro nas credenciais pode bloquear pagamentos, interromper a comunicação da aplicação ou criar tentativas de checkout falhadas. Use esta lista de verificação antes de guardar alterações. Isto ajuda a proteger a receita e oferece uma transição mais suave.
- Confirme que está a usar a conta correta
- Verifique se as chaves são de teste ou produção
- Copie a chave completa sem caracteres em falta
- Reveja os campos de configuração relacionados
- Guarde alterações apenas após uma verificação final
- Execute uma transação de teste
- Confirme autorização bem-sucedida e criação de encomenda
- Reveja registos ou mensagens de erro se a ligação falhar
Mudar 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 a verificar o fluxo com segurança. As chaves de produção ativam pagamentos reais. Deve trocar apenas após ter validado o checkout, a configuração da aplicação e a preparação da conta do processador.
Antes de mudar para produção
- Certifique-se de que a 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 definições de webhook ou callback, se necessário
- Execute um teste final ponta a ponta
Depois de mudar para produção
- Realize uma transação real controlada, se apropriado
- Verifique o estado de autorização do pagamento
- Verifique a criação de encomendas no Shopify
- Monitorize de perto as primeiras encomendas de produção
- Mantenha os detalhes de contacto do suporte prontos em caso de erros
Próximos passos úteis
Ligações internas ajudam os utilizadores a avançar mais rapidamente. Também ajudam os motores de busca a entender os relacionamentos entre páginas. Adicione ligações contextuais dentro do conteúdo e um pequeno centro de ligações perto do final da página para navegação mais forte e maior valor de SEO.
Perguntas frequentes
Posso atualizar as definições da aplicação CartDNA sem reinstalar a aplicação?▼
Posso mudar para uma subconta diferente no mesmo processador?▼
Posso alterar a aplicação 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 a sua ligação CartDNA?
Se precisa de 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.