Nabeyond ltd t/a CartDNA es un CartDNA es un Shopify Socio de desarrollo de aplicaciones de pago
Usa la API de CartDNA para autenticarte de forma segura, crear solicitudes de pago, controlar la selección del método de pago y mantener tus sistemas actualizados mediante flujos de callback. Creada para equipos que necesitan infraestructura de pago flexible y control confiable del backend.
La API de CartDNA te proporciona las acciones principales necesarias para la orquestación de pagos. Puedes solicitar un token de acceso, enviar solicitudes de pago, definir datos del cliente y del pedido, elegir métodos de pago compatibles y recibir actualizaciones de estado a través de URLs de callback.
Usa las credenciales del cliente para solicitar un token de acceso e incluirlo en solicitudes autorizadas.
Crea solicitudes de pago con detalles del pedido, monto, moneda, datos del cliente y selección del método de pago.
Protege cada solicitud con validación de timestamp, claves de idempotencia y firmas de solicitud.
Usa la URL de pago devuelta para enviar a los clientes a la experiencia de pago.
Recibe actualizaciones de pago en tu backend para mantener tu sistema de pedidos preciso.
Las solicitudes de la API de CartDNA admiten acciones de transacciones comunes como creación de pagos y flujos de preautorización, según la configuración de tu comerciante. Esto brinda a los desarrolladores flexibilidad al manejar capturas directas, pagos por etapas o lógica de checkout específica del método.
La referencia pública de API muestra soporte para varios métodos de pago y monedas, incluyendo tarjetas y métodos locales seleccionados. Esto brinda a los comerciantes mayor flexibilidad al vender en diferentes mercados y ayuda a los desarrolladores a crear experiencias de pago que coincidan con las expectativas de los clientes.
Ejemplos:
CartDNA usa protección de solicitudes en capas. Los tokens controlan el acceso a la API. Los timestamps ayudan a reducir los problemas de replay. Las claves de idempotencia reducen duplicados accidentales. Las firmas protegen los campos de pago críticos de manipulaciones. Esta estructura es práctica para sistemas de producción donde importa la confiabilidad de los pagos.
Tu integración debe manejar casos de fallo comunes de la API como tokens inválidos, solicitudes caducadas, solicitudes duplicadas y firmas inválidas. Construye reintentos claros donde sea seguro, registra el contexto de la solicitud y muestra mensajes de error internos útiles a los equipos de soporte.
Mantén todos los secretos en el lado del servidor
Usa claves de idempotencia UUID
Estandariza los formatos de ID de pedido
Registra las entregas de callback
Reconcilia los resultados de redirección con el estado final del backend
Separa las credenciales de sandbox y producción
Prueba la generación de firma con muestras de payload fijas
Para obtener encabezados exactos, ejemplos de solicitudes, campos de payload y formatos de respuesta, usa la referencia completa de la API de CartDNA.
Ir a referencia de API