Programadores

Uma API.
Cada adquirente.

Integre uma vez. A Cardflo encaminha cada transação através da nossa rede de aquisição, sem código adicional ao adicionar um novo fornecedor, sem alterações significativas quando as rotas mudam.

create-payment.ts
// Create a payment, one API, every acquirer
const payment = await cardflo.payments.create({
  amount: 4999,            // £49.99
  currency: "GBP",
  customer: { id: "cus_8aF2..." },
  method: { type: "card", token: "tok_live_..." },
  // Smart routing picks the best acquirer automatically.
  routing: { strategy: "approval_then_cost" },
});

if (payment.status === "approved") {
  // Webhook payment.succeeded will follow.
}
Kit de ferramentas

Tudo o que precisa para enviar pagamentos rapidamente.

REST API

Recursos previsíveis, escritas idempotentes e JSON em todo o lado.

Checkout alojado

Fácil de integrar, com âmbito PCI, personalizável para corresponder à sua marca.

Webhooks

Eventos assinados para cada pagamento, reembolso e disputa.

Tokens de cofre e de rede

Cartões de cliente portáteis com gestão do ciclo de vida dos tokens.

SDKs de servidor

Node, Python, Go e PHP, clientes tipificados com novas tentativas incorporadas.

Plugins

WooCommerce, Magento, Shopify e Salesforce Commerce Cloud.
Webhooks

Eventos em tempo real para cada ciclo de vida de pagamento.

Assinado, com novas tentativas com backoff exponencial e idempotente por ID do evento. Subscreva o que lhe interessa, ignore o resto.

  • payment.succeededCapturado pelo adquirente da rota
  • payment.retriedRecusa suave, próximo adquirente
  • payment.failedTodas as rotas esgotadas
  • refund.createdIniciado para captura
  • dispute.openedEstorno recebido
  • payout.completedLiquidado para o seu banco

A Cardflo expõe uma API REST, um fluxo de webhook, um iframe de checkout hospedado e uma biblioteca crescente de componentes drop-in. Tudo é versionado, idempotente por padrão e abrange as mesmas primitivas, quer esteja a integrar um adquirente ou cinco. A documentação, as chaves de sandbox e uma coleção Postman são públicas.

Como as equipas integram

Checkout hospedado

Caminho mais rápido para a produção. Redirecione ou incorpore o nosso iframe com escopo PCI, receba um webhook ao concluir. Escopo PCI zero, carteiras incluídas, tokens de rede ativados por padrão. A maioria das integrações são lançadas em um dia e cobrem 90% dos casos de uso.

API direta

Controlo total sobre os fluxos de autorização, captura, reembolso e disputa. Escopo PCI DSS SAQ D. Adequado para cartão em arquivo, subscrições, mercados e qualquer produto que precise de lógica personalizada para a autenticação. SDKs de referência para Node, Python, Ruby, Go e PHP.

Webhooks e eventos

Idempotente, segura para novas tentativas, assinada com HMAC. Cada pagamento, reembolso, estorno, atualização KYB e liquidação é um evento de webhook. O ambiente de sandbox permite-lhe reproduzir eventos sem tocar na produção, o que torna os testes de automação de ponta a ponta triviais.

FAQ

Perguntas frequentes

Integração, SDKs, webhooks, sandbox, migração e SLAs. As respostas práticas que os engenheiros perguntam antes de escrever a primeira linha de código.

Preciso de uma integração separada para cada adquirente?

Não. Uma API REST da Cardflo e um conjunto de webhooks conectam-no a cada adquirente na rede. O roteamento inteligente escolhe o adquirente por transação e nunca escreve código específico do adquirente. Adicione ou troque adquirentes nos bastidores sem tocar na sua base de código.

Como funcionam os webhooks e a idempotência?

Os webhooks são assinados com HMAC-SHA256 e entregues com novas tentativas automáticas e recuo exponencial. Cada solicitação aceita uma chave de idempotência, de modo que as criações com novas tentativas retornam o pagamento original em vez de duplicar as cobranças. Os eventos incluem payment.succeeded, payment.retried, refund.created e dispute.opened.

Têm SDKs e componentes de UI alojados?

Sim. SDKs de servidor para Node, Python, PHP, Ruby, Go e .NET. Uma finalização de compra alojada incorporada, Elements para captura de cartão incorporada e uma API de links de pagamento para fluxos sem código. Todos os componentes da interface de utilizador reduzem o âmbito PCI para que se mantenha fora dos dados do cartão.

Como funciona o sandbox e os cartões de teste?

O sandbox espelha a produção com cartões de teste para cada esquema, códigos de recusa forçada para cada código de resposta que suportamos e desafios 3DS simulados. Pode reproduzir webhooks de produção reais no sandbox para testar casos extremos sem tocar no tráfego em tempo real.

Como migro de Stripe, Adyen ou Checkout.com?

Os intentos de pagamento, clientes, reembolsos e disputas mapeiam-se claramente para equivalentes Cardflo, e suportamos a importação de tokens de cartão onde o esquema o permite. Fornecemos um engenheiro de migração, documentação de mapeamento de campo lado a lado e um modo de execução de teste para monitorizar o tráfego antes de mudar o fluxo primário.

Quais são os vossos limites de taxa e SLAs de tempo de atividade?

Os limites de taxa da API pública começam em 100 solicitações por segundo por conta, sendo maiores sob pedido. Publicamos 99,99% de disponibilidade na API transacional com créditos mensais caso não cumpramos. O estado está ativo em status.cardflo.io com histórico de incidentes e RSS.
Solicitar agora