API directa
Cree una experiencia de pago propiedad del comerciante con las API del servidor DEUNA.
En esta página
Controla la interfaz y coordina los pagos desde tu backend.
Crea el recorrido del cliente en tu aplicación y usa las API de DEUNA para operaciones de pagos, usuarios, tarjetas y orquestación.
- Interfaz
- Frontend y backend propiedad del comercio
- Modelo de entrega
- API servidor a servidor con soporte del cliente cuando sea necesario
- Ideal para
- Equipos que necesitan el máximo control del producto
Integre las soluciones de pago y pago DEUNA en su aplicación a través de Direct API/Headless.
Los servicios API de DEUNA se organizan en torno al principio REST.
Esto significa que los servicios:
- Están orientados a los recursos.
- Recibir y devolver respuestas JSON.
- Utilice códigos de respuesta HTTP estándar.
- Autenticar con estándares REST
- Utilice los verbos REST estándar GET, POST, PATCH, FETCH y DELETE.
Autenticación#
DEUNA crea claves API públicas y privadas para su aplicación.
Utilice claves API para autenticarse como comerciante en la API. Las claves APY se crean durante la creación de su cuenta Sandbox y también pueden ser proporcionadas por un TPM DEUNA. Puede crear varias claves API asociadas con la misma cuenta.
Los tokens JWT se utilizan para llamadas que crean pagos, almacenan tarjetas y operan con datos de usuario.
Idempotencia#
Las API de DEUNA admiten idempotencia, lo que le permite volver a intentar solicitudes a nuestra API sin preocuparse de generar accidentalmente la misma operación dos veces.
DEUNA guarda el código de respuesta y la carga útil de la primera solicitud para cada valor del idempotency key.
DEUNA guarda el código de respuesta y la carga útil de la primera solicitud para cada valor de la clave de idempotencia.
Las claves de idempotencia se utilizan para el verbo HTTP: POST.
Entornos#
El entorno API DEUNA cuenta con dos entornos independientes entre sí:
Caja de arena
Sandbox es el entorno utilizado para las pruebas.
El entorno sandbox contiene las conexiones a los distintos proveedores de pago y fraude dirigidos a sus respectivos entornos de prueba.
Utilizar el entorno sandbox para realizar las pruebas con datos disponibles para cada proveedor
URL: https://api.sandbox.deuna.io
Producción
La producción es el entorno utilizado para procesar transacciones reales en el entorno de producción.
Se recomienda encarecidamente probar cada integración en el entorno sandbox antes de pasarla a producción.
URL: https://api.deuna.io
Colección de Postman#
DEUNA tiene la siguiente colección pública de Postman para integraciones y pruebas más convenientes: Colección DEUNA Cartero.
Gestión de usuarios#
DEUNA permite la creación de usuarios para una mejor gestión y estructuración de todos los recursos y servicios:
- Crear usuarios.
- Consigue usuarios.
- Eliminar usuarios.
- Asociar tarjetas almacenadas con usuarios.
- Asociar pagos a usuarios.
- Asociar direcciones a usuarios.
Tarjetas de tienda#
DEUNA ofrece funcionalidad de almacenamiento de tarjetas para almacenar tarjetas previamente almacenadas y brindar una mejor experiencia a sus clientes.
DEUNA genera un token único por cada tarjeta creada que se puede almacenar sin ningún riesgo.
Procesar pagos#
Procese los pagos de sus usuarios a través de una única integración utilizando nuestro motor de pago y fraude que permite orquestar pagos en tiempo real.
Procese pagos con múltiples proveedores de pago y fraude mientras mantiene la misma estructura de respuesta y estandarización de códigos de error entre proveedores.
3DS#
DEUNA apoya el flujo 3DS en todas sus integraciones.
Ganchos web#
DEUNA comunica actualizaciones sobre cambios en el estado de los pedidos a través de un webhook.
Se recomiendan webhooks para comunicar eventos asincrónicos desde métodos de pago. El resultado de aprobación o rechazo se comunica mediante esta norma.
Con nuevas tecnologías como 3DS, incluso las transacciones con tarjeta se vuelven asincrónicas y es importante estar atento a los eventos de pedidos una vez que el usuario completa la autenticación con su banco y recibe el estado de pago final.