Desarrolladores

Una API.
Cada adquirente.

Integrar una vez. Cardflo enruta cada transacción a través de nuestra red de adquisición, sin código adicional al añadir un nuevo proveedor, sin cambios importantes cuando las rutas cambian.

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 herramientas

Todo lo que usted necesita para enviar pagos rápidamente.

API REST

Recursos predecibles, escrituras idempotentes y JSON en todas partes.

Checkout alojado

Integración sencilla, con alcance PCI, personalizable para que coincida con su marca.

Webhooks

Eventos firmados para cada pago, reembolso y disputa.

Vault y tokens de red

Tarjetas de cliente portátiles con gestión del ciclo de vida de los tokens.

SDKs de servidor

Node, Python, Go y PHP, clientes tipados con reintentos incorporados.

Plugins

WooCommerce, Magento, Shopify y Salesforce Commerce Cloud.
Webhooks

Eventos en tiempo real para cada ciclo de vida de pago.

Firmado, reintentado con retroceso exponencial e idempotente por ID de evento. Suscríbete a lo que te interesa, ignora el resto.

  • payment.succeededCapturado por adquirente enrutado
  • payment.retriedDeclive suave, siguiente adquirente
  • payment.failedTodas las rutas agotadas
  • refund.createdIniciado para captura
  • dispute.openedContracargo recibido
  • payout.completedLiquidado en su banco

Cardflo expone una API REST, un flujo de webhook, un iframe de checkout alojado y una creciente biblioteca de componentes integrables. Todo está versionado, es idempotente por defecto y cubre las mismas primitivas, ya sea que esté integrando un adquirente o cinco. La documentación, las claves de sandbox y una colección de Postman son públicas.

Cómo se integran los equipos

Checkout alojado

La ruta más rápida a producción. Redirija o incruste nuestro iframe con alcance PCI, reciba un webhook al completarse. Alcance PCI cero, monederos incluidos, tokens de red activados por defecto. La mayoría de las integraciones se implementan en un día y cubren el 90 por ciento de los casos de uso.

API directa

Control total sobre los flujos de autorización, captura, reembolso y disputa. Alcance PCI DSS SAQ D. Adecuado para tarjetas en archivo, suscripciones, marketplaces y cualquier producto que necesite lógica personalizada en torno a la autorización. SDKs de referencia para Node, Python, Ruby, Go y PHP.

Webhooks y eventos

Idempotente, segura para reintentos, firmada con HMAC. Cada pago, reembolso, contracargo, actualización de KYB y liquidación es un evento de webhook. El sandbox le permite reproducir eventos sin tocar la producción, lo que facilita las pruebas de automatización de extremo a extremo.

Preguntas frecuentes

Preguntas frecuentes

Integración, SDK, webhooks, sandbox, migración y SLA. Las respuestas prácticas que los ingenieros preguntan antes de escribir la primera línea de código.

¿Necesito una integración separada para cada adquirente?

No. Una API REST de Cardflo y un conjunto de webhooks lo conectan a todos los adquirentes de la red. El enrutamiento inteligente elige el adquirente por transacción y usted nunca escribe código específico del adquirente. Agregue o cambie adquirentes en segundo plano sin tocar su base de código.

¿Cómo funcionan los webhooks y la idempotencia?

Los webhooks se firman con HMAC-SHA256 y se entregan con reintentos automáticos y retroceso exponencial. Cada solicitud acepta una clave de idempotencia, por lo que los reintentos de creación devuelven el pago original en lugar de duplicar los cargos. Los eventos incluyen payment.succeeded, payment.retried, refund.created y dispute.opened.

¿Tienen SDKs y componentes de UI alojados?

Sí. SDKs de servidor para Node, Python, PHP, Ruby, Go y .NET. Un checkout alojado de inserción sencilla, Elements para la captura de tarjetas incrustada y una API de Payment Links para flujos sin código. Todos los componentes de UI reducen el alcance de PCI para que usted no maneje datos de tarjetas.

¿Cómo funcionan el sandbox y las tarjetas de prueba?

El sandbox replica la producción con tarjetas de prueba para cada esquema, códigos de denegación forzada para cada código de respuesta que admitimos y desafíos 3DS simulados. Puede reproducir webhooks de producción reales en el sandbox para probar casos extremos sin afectar el tráfico en vivo.

¿Cómo migro desde Stripe, Adyen o Checkout.com?

Los intentos de pago, clientes, reembolsos y disputas se corresponden limpiamente con los equivalentes de Cardflo, y admitimos la importación de tokens de tarjeta cuando el esquema lo permite. Proporcionamos un ingeniero de migración, documentos de mapeo de campos lado a lado y un modo de ejecución en seco para simular el tráfico antes de cambiar el flujo principal.

¿Cuáles son sus límites de tasa y SLAs de tiempo de actividad?

Los límites de tasa de la API pública comienzan en 100 solicitudes por segundo por cuenta, más altas bajo solicitud. Publicamos una disponibilidad del 99.99% en la API transaccional con créditos mensuales si no la cumplimos. El estado en vivo está en status.cardflo.io con historial de incidentes y RSS.
Solicitar ahora