CartDNA é um Shopify parceiro de desenvolvimento de aplicações de pagamento

Logótipo CartDNA

Guia de Integração CartDNA para Shopify

Obtenha dicas de configuração, orientação de configuração, ajuda com credenciais da aplicação e soluções práticas para integração da aplicação de pagamento CartDNA Shopify. Aprenda como atualizar chaves API, gerir definições de teste e produção, configurar webhooks e reduzir erros comuns de configuração antes de entrar online.

Integrações de aplicações de pagamento compatíveis com Shopify
Suporte de credenciais de teste e produção
Mais de 720 métodos de pagamento em mais de 190 mercados
Configuração flexível para configurações específicas do fornecedor

Integração CartDNA simplificada para comerciantes Shopify

CartDNA ajuda comerciantes Shopify a conectar métodos de pagamento aprovados, bancos, PSPs e serviços de pagamento alternativos através de fluxos de aplicações de pagamento nativos compatíveis com Shopify. Esta página da base de conhecimento oferece um ponto de partida prático para atualizar definições, compreender credenciais e verificar pontos críticos de configuração antes do lançamento.

Cada aplicação CartDNA pode ter requisitos técnicos diferentes. Isto porque cada integração depende do fornecedor de pagamento, processador, banco ou parceiro de serviço por trás da aplicação. A sua configuração pode incluir campos API específicos do fornecedor, opções personalizadas, credenciais de produção e teste e, por vezes, requisitos de configuração de webhook.

Atualize as definições da aplicação CartDNA e chaves API

Pode atualizar as definições da aplicação de pagamento CartDNA e credenciais API de duas formas. Ambos os métodos levam-no à mesma área de configuração da aplicação. Escolha a rota que melhor se adequa ao seu fluxo de trabalho.

Atualizar através do Admin Shopify

Melhor para comerciantes que desejam gerir definições da aplicação de pagamento diretamente do Shopify.

Inclui:

Acesso rápido das definições de pagamento do Shopify
Rota direta para a área de gestão da aplicação
Bom para atualizações de configuração do dia a dia

Atualizar através do Portal de Comerciantes CartDNA

Melhor para comerciantes a gerir uma ou mais aplicações CartDNA do painel CartDNA.

Inclui:

Acesso centralizado à gestão de aplicações CartDNA
Navegação fácil do painel principal
Útil para fluxos de trabalho de comerciantes com múltiplas aplicações

Nota de suporte: Se não tem acesso ao Portal de Comerciantes CartDNA, ou se não consegue iniciar sessão, contacte a Equipa de Suporte CartDNA antes de fazer alterações relacionadas com a conta.

Como atualizar definições da aplicação CartDNA através do Admin Shopify

Use esta rota se deseja gerir a aplicação CartDNA da sua conta Shopify.

1

Inicie sessão no seu Painel Admin Shopify.

2

Vá para: Definições > Pagamentos

3

Encontre a sua aplicação de pagamento CartDNA na lista de métodos de pagamento.

4

Abra o menu Mais ações e clique em: Gerir

5

Será redirecionado para a secção de configuração da aplicação CartDNA.

Nota útil: Esta rota é útil quando deseja uma forma rápida de rever o estado da aplicação de pagamento, campos de configuração e atualizações de credenciais sem sair do Shopify.

Como atualizar definições da aplicação CartDNA através do Portal de Comerciantes CartDNA

Use esta rota se prefere trabalhar do painel CartDNA.

1

Inicie sessão no seu Portal de Comerciantes CartDNA.

2

Vá para o Painel Principal.

3

Encontre a aplicação que deseja atualizar.

4

Clique em: Gerir

5

Será redirecionado para a secção de configuração da aplicação CartDNA.

Nota de suporte importante: Se está a enfrentar problemas de início de sessão, falta de acesso ou restrições de conta, contacte a Equipa de Suporte CartDNA para obter ajuda antes de atualizar definições de pagamento.

O que verá dentro da secção de configuração da aplicação

Depois de abrir a área de configuração, poderá ver várias separadores dependendo da aplicação.

Modo Produção

Insira ou atualize as suas chaves API de produção e definições de produção para transações reais.

Modo Teste

Adicione ou atualize credenciais de teste para simular pagamentos sem movimentar dinheiro real.

Configuração Personalizada

Gira campos específicos do fornecedor se suportados pela aplicação CartDNA selecionada.

Nota importante: Algumas aplicações incluem definições extra que são exclusivas do processador de pagamento, banco, adquirente ou fornecedor de serviço conectado a essa integração. Isto significa que os campos de configuração podem diferir de aplicação para aplicação.

O que são credenciais da aplicação CartDNA

Credenciais da aplicação são chaves API seguras ou detalhes de ligação emitidos pelo seu fornecedor de pagamento. Permitem que a sua aplicação CartDNA comunique com um PSP, banco, plataforma omnicanal ou outro fornecedor de serviços de pagamento para que as transações possam ser processadas com segurança.

Estas credenciais atuam como a ponte técnica entre a sua loja Shopify e o fornecedor de pagamento. Na maioria dos casos, as credenciais usadas no CartDNA são as mesmas credenciais que usaria se estivesse a integrar diretamente com esse fornecedor.

Saiba mais sobre configuração de pagamento:

Credenciais de teste vs credenciais de produção

Credenciais de teste

  • Usadas para desenvolvimento e validação de configuração
  • Nenhum fundo de pagamento real é movimentado
  • Ajuda a verificar redirecionamentos e comportamento da aplicação
  • Melhor para testes pré-lançamento

Credenciais de produção

  • Usadas para transações reais de clientes
  • Necessárias quando está pronto para aceitar pagamentos
  • Devem ser adicionadas apenas após testes bem-sucedidos
  • Devem corresponder à sua conta de comerciante de produção aprovada

Conselho prático: Complete sempre testes completos no modo de teste antes de mudar para o modo de produção. Isto ajuda a detetar problemas de configuração cedo e reduz pagamentos falhados após o lançamento.

Onde encontrar as suas chaves API e credenciais da aplicação

Normalmente pode encontrar credenciais API de teste e produção iniciando sessão no painel de comerciante ou portal de parceiros do seu fornecedor de pagamento. Em alguns casos, o fornecedor pode enviá-las diretamente para si ou pedir que as solicite através do suporte.

O que verificar:

  • Confirme que está a usar a conta de comerciante correta
  • Confirme se as chaves são de teste ou produção
  • Confirme se valores de webhook extras são necessários
  • Confirme se o PSP tem instruções de configuração específicas do fornecedor

Mensagem de suporte focada em conversão: Não tem certeza de quais credenciais usar? Contacte o Suporte CartDNA antes de atualizar a aplicação. Uma verificação rápida agora pode prevenir falhas de pagamento depois.

Configure webhooks se necessário

Após atualizar chaves API de teste ou produção, poderá precisar de clicar no botão: Configurar Webhooks para cada modo.

Este passo é crítico para algumas aplicações de pagamento. Se a configuração de webhook for necessária mas não concluída, a sua aplicação pode não funcionar corretamente. Atualizações de estado de encomenda, confirmações de pagamento e eventos de transação podem falhar ao sincronizar adequadamente.

Algumas aplicações CartDNA não requerem configuração de webhook, portanto pode não ver este botão.

Antes de terminar:

  • Guarde as suas definições atualizadas
  • Configure webhooks se a opção aparecer
  • Execute um checkout de teste
  • Confirme comportamento de redirecionamento e retorno
  • Reveja estado de encomenda e pagamento no Shopify

Melhores práticas antes de fazer alterações de integração

Recomendamos vivamente falar com a Equipa de Suporte CartDNA antes de alterar chaves API, mapeamentos de conta de comerciante ou definições específicas do fornecedor. Um pequeno erro de configuração pode parar transações, enviar clientes para a página de pagamento errada ou criar erros de checkout.

Lista de verificação de melhores práticas:

  • Confirme que está a editar a aplicação CartDNA correta
  • Verifique se o fornecedor emitiu novas credenciais de teste ou produção
  • Reveja campos personalizados cuidadosamente
  • Configure webhooks se necessário
  • Teste o checkout após cada alteração importante
  • Complete uma transação de produção se possível
  • Confirme que o cliente chega à página de pagamento correta

Este processo ajuda a proteger a taxa de conversão, estabilidade do checkout e confiança do cliente.

Reconecte a aplicação a outra conta de comerciante ou perfil de pagamento

CartDNA permite que reconecte ou atualize a sua aplicação de pagamento licenciada para funcionar com uma conta de comerciante ou perfil de pagamento diferente sem cobranças adicionais. Isto oferece flexibilidade ao trocar de adquirentes, mudar para uma nova configuração de PSP ou atualizar arranjos de pagamento comerciais.

Antes de trocar:

  • Verifique o estado de aprovação do fornecedor
  • Confirme que as credenciais de produção são válidas
  • Reveja quaisquer alterações de configuração personalizada
  • Re-teste a aplicação antes de aceitar encomendas de produção

Entre online com mais confiança

Um lançamento cuidadoso reduz o risco de pagamento e ajuda a evitar jornadas de clientes falhadas. Antes de entrar online, deve testar redirecionamentos de pagamento, verificar URLs de retorno, confirmar comportamento de criação de encomenda e verificar se as notificações de pagamento estão a atualizar corretamente dentro do Shopify.

Fluxo de lançamento recomendado:

  1. 1.Adicione credenciais de teste
  2. 2.Execute transações de teste
  3. 3.Confirme comportamento de redirecionamento
  4. 4.Confirme atualizações de encomendas Shopify
  5. 5.Adicione credenciais de produção
  6. 6.Configure webhooks de produção se necessário
  7. 7.Execute uma transação real
  8. 8.Monitorize as primeiras encomendas de perto

Perguntas frequentes

Posso atualizar chaves API da aplicação CartDNA mais tarde?
Sim. Pode atualizar credenciais API e definições da aplicação a qualquer momento através do Admin Shopify ou do Portal de Comerciantes CartDNA.
Todas as aplicações CartDNA usam os mesmos campos de configuração?
Não. Cada aplicação CartDNA pode incluir definições diferentes dependendo do fornecedor de pagamento, banco, processador ou parceiro de serviço por trás da integração.
Sempre preciso de configurar webhooks?
Não. Algumas aplicações requerem configuração de webhook e outras não. Se o botão aparecer na sua área de configuração, reveja-o cuidadosamente e complete o passo se necessário.
Onde obtenho as minhas credenciais de teste e produção?
A maioria dos comerciantes obtém-nas do painel de comerciante PSP ou banco. Alguns fornecedores emitem-nas diretamente através de onboarding ou suporte.
Devo testar antes de usar credenciais de produção?
Sim. Deve sempre testar primeiro. Isto ajuda a identificar problemas de configuração antes que clientes reais comecem a usar o método de pagamento.
CartDNA pode ajudar-me a verificar a configuração?
Sim. O Suporte CartDNA pode ajudar a rever a sua configuração e reduzir a possibilidade de erros de configuração.

Precisa de ajuda com a integração CartDNA?

Se está a atualizar credenciais, a mudar fornecedores de pagamento ou a preparar-se para entrar online, a equipa CartDNA pode ajudá-lo a rever a configuração e reduzir problemas de checkout evitáveis.

Orientação de revisão de credenciais
Verificações de configuração de webhook
Resolução de problemas de configuração
Suporte de lançamento de teste e produção