Direct API

Esta página documenta detalles para integrar las soluciones DEUNA en tu aplicación de forma Direct API / Headless.

Acerca de la integración

Los servicios API DEUNA son organizados alrededor del principio REST.

Esto significa que los servicios:

• Son orientados sobre recursos.
• Reciben y retornan JSON responses.
• Usan lo códigos estandard de respuesta HTTP.
• Usan los estándares en autenticación REST
• Usan los verbos GET, POST, PATCH, FETCH, y DELETE.

Autenticación

DEUNA crea API Keys privados y públicos para tu applicación.

Usa los API Keys para autenticarte como comercio a la API.

Se usan tokens JWT para llamadas que crean pagos, almacenan tarjetas, y operan con data de usuario.

📘

Los tokens JWT para hacer operaciones a nombre de usuarios tienen su propia expiración.

Las APY Keys se crean durante la creación de tu cuenta Sandbox y tambiénlas puede proveer un TPM de DEUNA.

📘

Puedes crear múltiples API Keys asociadas a la misma cuenta.

Idempotencia

Las APIs DEUNA soportan idempotencia para que puedas reintentar peticiones a nuestro API sin preocuparte que accidentalmente generes la misma operación dos veces.

📘

Para realizar peticiones idempotentes, manda la llave X-Idempotency-Key en el header.

DEUNA guarda el código de respuesta y el payload de la primer petición para cada valor del idempotency key.

📘

Usa UUIDs versión 4 para evitar colisiones.

DEUNA puede remover los idempotency keys despues de 24 horas desde la primer peticion con ese idempotency key.

Los idempotency keys son usado para el verbo HTTP: POST.

📘

La idempotencia es totalmente opcional.

Ambientes

El entorno de APIs DEUNA cuenta con dos ambientes independientes del otro:

Sandbox

Sandbox es el ambiente que se usa para realizar pruebas.

Este ambiente contiene las conexiones a los diferentes proveedores de pagos y fraude apuntando a sus respectivos ambientes de prueba.

Es el ambiente donde deben realizarse con los datos de prueba que disponga cada proveedor.

URL: https://api.sandbox.deuna.io

📘

El timeout del ambiente sandbox es 75 segundos. El tiempo de respuesta promedio es una fracción de este tiempo.

Producción

Producción es el ambiente que se usa para procesar transacciones reales en el ambiente productivo.

Lo más recomendado es probar cada integración en el ambiente de Staging antes de moverse al productivo.

URL: https://api.deuna.io

📘

El timeout duro del ambiente productivo de 60 segundos. El timeout tiene en consideración que una transacción puede contactar multiples proveedores anti-fraude y de pagos.

Acerca de la API

Colección de Postman

DEUNA cuenta con la siguiente colección de Postman pública para basar integraciones y hacer pruebas de una manera más conveniente: https://docs.deuna.com/reference/colecciones-de-postman.

Manejo de usuarios

DEUNA permite la creación de usuarios para un mejor manejo y estructura de todos los recursos y servicios.

Con el manejo de usuarios, puedes:

• Crear usuarios
• Obtener usuarios
• Eliminar usuarios
• Asociar tarjetas almacenadas a usuarios
• Asociar pagos a usuarios
• Asociar direcciones a usuarios

Almacenamiento de tarjetas para uso futuro

DEUNA cuenta con la funcionalidad de almacenamiento de tarjetas para guardar tarjetas previamente almacenadas y dar una mejor experiencia a tus clientes.

DEUNA genera un token único por cada tarjeta creada que puede ser almacenada sin ningún riesgo.

📘

Si tu comercio no es PCI compliant, esta funcionalidad te permite tokenizar client-side la tarjeta, enviar el token a tu servidor, y procesar el pago desde tu backend sin ningún problema.

Revisa esta sección para una guía paso a paso: https://docs.deuna.com/docs/headless-payments-and-fraud-module

📘

Si tu comercio es PCI compliant, puedes procesar pagos sin tokenizar previamente una tarjeta con DEUNA.

Procesar pagos

Con DEUNA puedes procesar mediante una sola integración pagos de tus usuarios usando nuestro motor de pagos y fraude que te permite, entre muchos beneficios, orquestrar en tiempo real el pago por multiples proveedores de pagos y fraude manteniendo una misma estructura de respuesta y una estandarización de códigos de error entre los proveedores, lo que hace esta integración con DEUNA mucho mas sencilla.

3DS

DEUNA soporta el flujo 3DS en todas sus integraciones.

📘

Para más informacioinformación sobre 3DS, ve a 3DS Secure.

Webhooks

DEUNA comunica actualizaciones sobre cambios de estado de una orden mediante webhook.

Los webhooks son recomendados para comunicar eventos asíncronos de métodos de pagos. El resultado de aprobado o rechazado se comunica con este estándar.

Con nuevas tecnologias con 3DS, incluso las transacciones con tarjetas se vuelven asíncronas y es importante escuchar los eventos de una orden una vez el usuario concluye la autenticación con su banco y se recibe un estado final sobre un pago.

📘

Para más información, ve a Webhooks.