Saltar al contenido principal
Todos los sistemas operativosNovedadesv1
Iniciar sesión
DEUNA API

Referencia de API

Elige la operación de API, el modelo de autorización y el llamador correctos para cada flujo de integración de DEUNA.

Última actualización: October 2, 2026Colección de Postman
En esta página

La referencia de API de DEUNA cubre las operaciones de backend del comercio y de aplicaciones de cliente publicadas en la documentación anterior. Empieza por el llamador, no solo por el nombre del recurso, porque el modelo de autorización admitido cambia según la superficie. Las demás rutas del API Gateway se excluyen intencionalmente de esta referencia.

Usa la navegación de la referencia de API para explorar las operaciones publicadas por área de producto y recurso.

Ejemplos de solicitudes de órdenes y pagosCopia solicitudes completas de Purchase V2 y de creación opcional de órdenes por industria.AutenticaciónElige la credencial y el modelo de autorización correctos para cada solicitante.Crear pagoRevise el contrato de pago completo y el panel de solicitud interactivo.API de TemasCree y administre configuraciones de temas reutilizables para Checkout y Widget.

URL base#

Utilice la URL base de la zona de pruebas mientras construye. Cambie a producción solo después de recibir las credenciales de producción y completar la certificación.

Sandbox
https://api.sandbox.deuna.io
Producción
https://api.deuna.io

Elija la superficie API#

Superficiepersona que llamaAutorizaciónÚselo para
Backend comercial · servidor a servidorInfraestructura comercial confiableClave API privada en X-Api-Key; X-Store-Code y encabezados de idempotencia cuando sea necesarioÓrdenes, compras, capturas, reembolsos, anulaciones y consultas operativas
Aplicación de cliente · usuario a servidorAplicación web o móvil para comerciantes que actúa en nombre de un cliente.Contexto de aplicación pública más usuario Authorization: Bearer … después de iniciar sesión; nunca insertar una clave privadaInicio de sesión opcional, perfiles y direcciones reutilizables, y tarjetas almacenadas

Autenticación#

backend comercial

Envíe la clave API privada en X-Api-Key, no en el encabezado del portador. Guárdelo en una infraestructura de servidor confiable.

Encabezados de solicitud de servidor a servidorHTTP
X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

Cliente autenticado

Envía el token de acceso del usuario en el encabezado Bearer. Algunas operaciones de órdenes y wallets también requieren la clave de la aplicación del comercio o el contexto de la tienda; la página de cada operación indica su autorización y los encabezados reenviados.

Encabezados de solicitud de usuario a servidorHTTP
Authorization: Bearer USER_ACCESS_TOKEN
X-Api-Key: APPLICATION_API_KEY
X-Store-Code: STORE_CODE
Content-Type: application/json

Ver Autenticación para manejo de credenciales, duración de tokens y rotación.

Operaciones de backend comerciales#

POST
/merchants/orders
Crear un pedido y obtener su token de pedido
GET
/merchants/orders/{order_token}
Recuperar el pedido actual y el estado de pago
GET
/merchants/orders/{order_token}/payments-methods
Obtenga los métodos de pago disponibles para el pedido
POST
/v2/merchants/orders/purchase
Crear pago
POST
/v2/merchants/orders/{order_token}/capture
Capturar un pago autorizado
POST
/v2/merchants/orders/{order_token}/refund
Crear un reembolso total o parcial
GET
/merchants/checkout/themes
Enumere y administre temas de Checkout del comerciante

Operaciones de aplicaciones de clientes#

POST
/users/request-code
Solicite un código de inicio de sesión único
POST
/users/login
Intercambiar una OTP por un token de usuario
GET
/users/me
Leer el perfil de usuario autenticado
GET
/users/{user_id}/cards
Listar las tarjetas almacenadas para el usuario autenticado
PATCH
/users/{user_id}/cards/{card_id}/set-as-default
Establecer o eliminar la tarjeta predeterminada del usuario autenticado

Respuestas y errores#

2xxLa solicitud tuvo éxito.
4xxLos datos de autenticación, permisos, estado o solicitud deben cambiar. Inspeccione el código de error devuelto.
5xxDEUNA o un proveedor falló. Vuelva a intentarlo solo cuando la operación sea idempotente, utilizando la misma clave de idempotencia.

Explora la lista completa en Códigos de error.

Versionado de ruta#

Utilice cada ruta exactamente como se publicó. API Gateway frecuentemente expone rutas canónicas sin un interno /api/v1 prefijo. Un segmento de versión como /v2 Se incluye únicamente cuando forma parte del recorrido público mostrado en el catálogo. Los cambios compatibles con versiones anteriores se enumeran en la Registro de cambios.