CartDNA é um Shopify Parceiro de desenvolvimento de aplicativos de pagamento

Logo CartDNA

API CartDNA

Use a API CartDNA para autenticar com segurança, criar solicitações de pagamento, controlar a seleção de método de pagamento e manter seus sistemas atualizados por meio de fluxos de callback. Criada para equipes que precisam de infraestrutura de pagamento flexível e controle confiável do backend.

O que a API permite fazer

A API CartDNA fornece as ações principais necessárias para orquestração de pagamentos. Você pode solicitar um token de acesso, enviar solicitações de pagamento, definir dados do cliente e do pedido, escolher métodos de pagamento suportados e receber atualizações de status por meio de URLs de callback.

Principais capacidades da API

Autenticação

Use credenciais do cliente para solicitar um token de acesso e inclua esse token nas solicitações autorizadas.

Criação de pagamentos

Crie solicitações de pagamento com detalhes do pedido, valor, moeda, dados do cliente e seleção de método de pagamento.

Controles de segurança

Proteja cada solicitação com validação de timestamp, chaves de idempotência e assinaturas de solicitação.

Fluxo de redirecionamento do cliente

Use a URL de pagamento retornada para enviar clientes para a experiência de pagamento.

Atualizações por callback

Receba atualizações de pagamento no seu backend para manter seu sistema de pedidos preciso.

Criado para fluxos de transações reais

As solicitações 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 desenvolvedores flexibilidade ao lidar com capturas diretas, pagamentos em etapas ou lógica de checkout específica do método.

Suporte a pagamentos locais e globais

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 desenvolvedores a criar experiências de pagamento que correspondam às expectativas dos clientes.

Exemplos:

  • Cartões para ampla cobertura global
  • Bancontact para a Bélgica
  • Boleto e Pix para o Brasil
  • Klarna para mercados internacionais selecionados
  • Przelewy24 para a Polônia

A segurança vem primeiro

CartDNA usa proteção de solicitações 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. Essa estrutura é prática para sistemas de produção onde a confiabilidade de pagamento importa.

Planeje para estados de falha previsíveis

Sua integração deve lidar com casos de falha comuns da API, como tokens inválidos, solicitações expiradas, solicitações duplicadas e assinaturas inválidas. Crie retentativas claras onde seguro, registre o contexto da solicitação e mostre mensagens de erro internas úteis às equipes de suporte.

Como construir de forma limpa

Mantenha todos os segredos no lado do servidor

Use chaves de idempotência UUID

Padronize formatos de ID de pedido

Registre entregas de callback

Reconcilie resultados de redirecionamento com o status final do backend

Separe credenciais de sandbox e produção

Teste a geração de assinatura com amostras de payload fixas

Precisa de detalhes no nível do endpoint?

Para cabeçalhos exatos, exemplos de solicitações, campos de payload e formatos de resposta, use a referência completa da API CartDNA.

Ir para referência de API