Nabeyond ltd t/a CartDNA é um CartDNA é um Shopify parceiro de desenvolvimento de aplicações de pagamento
Use a API CartDNA para autenticar com segurança, criar pedidos de pagamento, controlar a seleção do método de pagamento e manter os seus sistemas atualizados através de fluxos de callback. Criada para equipas que precisam de infraestrutura de pagamento flexível e controlo fiável do backend.
A API CartDNA fornece as ações principais necessárias para a orquestração de pagamentos. Pode solicitar um token de acesso, enviar pedidos de pagamento, definir dados do cliente e da encomenda, escolher métodos de pagamento suportados e receber atualizações de estado através de URLs de callback.
Use credenciais do cliente para solicitar um token de acesso e inclua esse token nas solicitações autorizadas.
Crie pedidos de pagamento com detalhes da encomenda, valor, moeda, dados do cliente e seleção do método de pagamento.
Proteja cada pedido com validação de timestamp, chaves de idempotência e assinaturas de pedido.
Use o URL de pagamento devolvido para enviar clientes para a experiência de pagamento.
Receba atualizações de pagamento no seu backend para que o seu sistema de encomendas fique preciso.
Os pedidos da API CartDNA suportam ações de transações comuns como criação de pagamentos e fluxos de pré-autorização, dependendo da configuração do seu comerciante. Isso dá aos programadores flexibilidade ao lidar com capturas diretas, pagamentos em etapas ou lógica de checkout específica do método.
A referência pública de API mostra suporte para vários métodos de pagamento e moedas, incluindo cartões e alguns métodos locais. Isso dá aos comerciantes mais flexibilidade ao vender em diferentes mercados e ajuda os programadores a criar experiências de pagamento que correspondam às expectativas dos clientes.
Exemplos:
CartDNA usa proteção de pedidos em camadas. Os tokens controlam o acesso à API. Os timestamps ajudam a reduzir problemas de replay. As chaves de idempotência reduzem duplicatas acidentais. As assinaturas protegem campos de pagamento críticos contra adulteração. Esta estrutura é prática para sistemas de produção onde a fiabilidade de pagamento é importante.
A sua integração deve lidar com casos de falha comuns da API como tokens inválidos, pedidos expirados, pedidos duplicados e assinaturas inválidas. Crie retentativas claras onde seguro, registe o contexto do pedido e mostre mensagens de erro internas úteis às equipas de suporte.
Mantenha todos os segredos no lado do servidor
Use chaves de idempotência UUID
Padronize formatos de ID de encomenda
Registe entregas de callback
Reconcilie resultados de redirecionamento com o estado final do backend
Separe credenciais de sandbox e produção
Teste a geração de assinatura com amostras de payload fixas
Para cabeçalhos exatos, exemplos de pedidos, campos de payload e formatos de resposta, use a referência completa da API CartDNA.
Ir para referência de API