Saltar al contenido principal
En esta página

Usa este catálogo para encontrar las operaciones migradas desde la referencia de API anterior de DEUNA. La matriz de migración mantiene cada método y ruta publicados representados una sola vez y excluye las demás rutas del API Gateway.

Inventario de endpoints publicados#

Este inventario se genera a partir de la configuración efectiva del API Gateway y está limitado por la matriz de migración revisada. Usa los filtros para identificar quién debe llamar una operación, qué servicio la gestiona, qué autorización admite y qué encabezados acepta o reenvía el gateway.

El catálogo incluye solo operaciones de backend del comercio y de aplicaciones de cliente que ya estaban presentes en la referencia pública de API anterior. Se excluyen las operaciones internas de Admin, de gestión, de socios, callbacks de proveedores y otras operaciones del gateway.

Las rutas a continuación /transactions/webhooks/ reciben eventos del procesador dentro de DEUNA y no son endpoints de integración del comerciante. Cuando un proveedor requiere configuración de callback del lado del comerciante, la URL y los pasos de configuración se encuentran en la guía de conexión de ese proveedor—por ejemplo, el callback de estado de pago Stripe OXXOUtilice Webhooks DEUNA para notificaciones entregadas a tu propio backend.

Inventario verificado de API publicadas56 operaciones publicadas

Generado a partir de las operaciones efectivas del API Gateway mapeadas desde la referencia pública anterior.

Backend del comercio · servidor a servidor 42Aplicación del cliente · usuario a servidor 14
Mostrando 56 de 56 operaciones
Backend del comercio · servidor a servidorÚsalo desde un backend confiable del comercio para órdenes, pagos y flujos operativos.42
GET/cards/bin/{bin}
Cards and vaultBackend del comercio · servidor a servidor

Obtener Bin

Dominio
Cards and vault
Servicio responsable
Card metadata
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
X-Api-KeyX-Merchant-Id
Probar
Ejemplo de cURL
GET/merchants/checkout/themes
CheckoutBackend del comercio · servidor a servidor

Listar u obtener Themes

Dominio
Checkout
Servicio responsable
Checkout configuration
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
POST/merchants/checkout/themes
CheckoutBackend del comercio · servidor a servidor

Crear Themes

Dominio
Checkout
Servicio responsable
Checkout configuration
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
DELETE/merchants/checkout/themes/{theme_id}
CheckoutBackend del comercio · servidor a servidor

Eliminar Themes

Dominio
Checkout
Servicio responsable
Checkout configuration
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
PATCH/merchants/checkout/themes/{theme_id}
CheckoutBackend del comercio · servidor a servidor

Actualizar Themes

Dominio
Checkout
Servicio responsable
Checkout configuration
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
GET/merchants/orders
OrdersBackend del comercio · servidor a servidor

Listar u obtener Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
POST/merchants/orders
OrdersBackend del comercio · servidor a servidor

Crear Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Idempotency-KeyX-Prediction-Id
Probar
Ejemplo de cURL
GET/merchants/orders/{order_token}
OrdersBackend del comercio · servidor a servidor

Obtener Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
AuthorizationX-Api-Keyx-merchant-id
Probar
Ejemplo de cURL
PATCH/merchants/orders/{order_token}
OrdersBackend del comercio · servidor a servidor

Actualizar Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
POST/merchants/orders/{order_token}/expire
OrdersBackend del comercio · servidor a servidor

Ejecutar Expire para Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
GET/merchants/orders/{order_token}/payments-methods
OrdersBackend del comercio · servidor a servidor

Listar u obtener Payments Methods

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada o token Bearer, según el flujo
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Store-Code
Probar
Ejemplo de cURL
POST/merchants/orders/{order_token}/transactions/verify
OrdersBackend del comercio · servidor a servidor

Ejecutar Verify para Transactions

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada o token Bearer, según el flujo
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Merchant-IDX-Store-Code
Probar
Ejemplo de cURL
POST/merchants/orders/{order_token}/void
OrdersBackend del comercio · servidor a servidor

Ejecutar Void para Orders

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/transactions/orders/{order_token}/installments
OrdersBackend del comercio · servidor a servidor

Listar u obtener Installments

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada o token Bearer, según el flujo
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Merchant-IDX-Prediction-Id
Probar
Ejemplo de cURL
POST/v2/merchants/orders/{order_token}/capture
OrdersBackend del comercio · servidor a servidor

Capturar Payment

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
POST/v2/merchants/orders/{order_token}/refund
OrdersBackend del comercio · servidor a servidor

Crear Refund

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
POST/v2/merchants/orders/purchase
OrdersBackend del comercio · servidor a servidor

Crear Payment

Dominio
Orders
Servicio responsable
Orders and checkout
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada validada; el encabezado Bearer del usuario se reenvía cuando existe
Encabezados aceptados o reenviados
AuthorizationCookieUser-AgentX-Api-KeyX-Device-IdX-Merchant-IDX-Prediction-IdX-Session-IdX-Store-Code
Probar
Ejemplo de cURL
POST/merchants/payment-links
Payment linksBackend del comercio · servidor a servidor

Crear Payment Links

Dominio
Payment links
Servicio responsable
Payment links
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/payment-links/{payment_link_id}
Payment linksBackend del comercio · servidor a servidor

Obtener Payment Links

Dominio
Payment links
Servicio responsable
Payment links
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/payment-links/{payment_link_id}/orders
Payment linksBackend del comercio · servidor a servidor

Listar u obtener Orders

Dominio
Payment links
Servicio responsable
Payment links
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/payment-links/all
Payment linksBackend del comercio · servidor a servidor

Listar u obtener All

Dominio
Payment links
Servicio responsable
Payment links
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/stores/payments-methods
PaymentsBackend del comercio · servidor a servidor

Listar u obtener Payments Methods

Dominio
Payments
Servicio responsable
Payments
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
X-Idempotency-KeyX-Merchant-IdX-Prediction-IdX-Store-Code
Probar
Ejemplo de cURL
GET/transactions/payments-methods
PaymentsBackend del comercio · servidor a servidor

Listar u obtener Payments Methods

Dominio
Payments
Servicio responsable
Payments
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/merchants/installments/plans/{installment_plan_option_id}
SubscriptionsBackend del comercio · servidor a servidor

Obtener Plans

Dominio
Subscriptions
Servicio responsable
Installments
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
X-Api-Key
Probar
Ejemplo de cURL
GET/subscriptions
SubscriptionsBackend del comercio · servidor a servidor

Listar u obtener Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions
SubscriptionsBackend del comercio · servidor a servidor

Crear Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
GET/subscriptions/{id}
SubscriptionsBackend del comercio · servidor a servidor

Obtener Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
PATCH/subscriptions/{id}
SubscriptionsBackend del comercio · servidor a servidor

Actualizar Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions/{id}/cancel
SubscriptionsBackend del comercio · servidor a servidor

Ejecutar Cancel para Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
PATCH/subscriptions/{id}/cards
SubscriptionsBackend del comercio · servidor a servidor

Actualizar Cards

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions/{id}/external-settlement
SubscriptionsBackend del comercio · servidor a servidor

Crear External Settlement

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
GET/subscriptions/{id}/history
SubscriptionsBackend del comercio · servidor a servidor

Listar u obtener History

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions/{id}/pause
SubscriptionsBackend del comercio · servidor a servidor

Ejecutar Pause para Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions/{id}/resume
SubscriptionsBackend del comercio · servidor a servidor

Ejecutar Resume para Subscriptions

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
GET/subscriptions/plans
SubscriptionsBackend del comercio · servidor a servidor

Listar u obtener Plans

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/subscriptions/plans
SubscriptionsBackend del comercio · servidor a servidor

Crear Plans

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
GET/subscriptions/plans/{id}
SubscriptionsBackend del comercio · servidor a servidor

Obtener Plans

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
PATCH/subscriptions/plans/{id}
SubscriptionsBackend del comercio · servidor a servidor

Actualizar Plans

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
GET/subscriptions/plans/statuses
SubscriptionsBackend del comercio · servidor a servidor

Listar u obtener Statuses

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
*
Probar
Ejemplo de cURL
GET/subscriptions/statuses
SubscriptionsBackend del comercio · servidor a servidor

Listar u obtener Statuses

Dominio
Subscriptions
Servicio responsable
Subscriptions
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
Authorizationx-Api-KeyX-Merchant-ID
Probar
Ejemplo de cURL
POST/users/authorize
Users and identityBackend del comercio · servidor a servidor

Ejecutar Authorize para Users

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada (`X-Api-Key`)
Encabezados aceptados o reenviados
X-Api-KeyX-Merchant-Id
Probar
Ejemplo de cURL
POST/users/external-authorize
Users and identityBackend del comercio · servidor a servidor

Crear External Authorize

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Backend del comercio · servidor a servidor
Autorización compatible
Clave API privada validada; el encabezado Bearer del usuario se reenvía cuando existe
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Auth-MessageX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
Aplicación del cliente · usuario a servidorÚsalo en flujos web o móviles para clientes con la identidad y el contexto de dispositivo indicados.14
GET/users/{user_id}/cards
Cards and vaultAplicación del cliente · usuario a servidor

Listar u obtener Cards

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Merchant-ID
Probar
Ejemplo de cURL
DELETE/users/{user_id}/cards/{card_id}
Cards and vaultAplicación del cliente · usuario a servidor

Eliminar Cards

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
Authorization
Probar
Ejemplo de cURL
GET/users/{user_id}/cards/{card_id}
Cards and vaultAplicación del cliente · usuario a servidor

Obtener Cards

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
Authorization
Probar
Ejemplo de cURL
PATCH/users/{user_id}/cards/{card_id}/set-as-default
Cards and vaultAplicación del cliente · usuario a servidor

Establecer tarjeta predeterminada

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Merchant-ID
Probar
Ejemplo de cURL
POST/v2/users/{user_id}/cards
Cards and vaultAplicación del cliente · usuario a servidor

Crear Cards

Dominio
Cards and vault
Servicio responsable
Payments
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Merchant-ID
Probar
Ejemplo de cURL
GET/users/{user_id}/addresses
Users and identityAplicación del cliente · usuario a servidor

Listar u obtener Addresses

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
POST/users/{user_id}/addresses
Users and identityAplicación del cliente · usuario a servidor

Crear Addresses

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
DELETE/users/{user_id}/addresses/{address_id}
Users and identityAplicación del cliente · usuario a servidor

Eliminar Addresses

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
PATCH/users/{user_id}/addresses/{address_id}
Users and identityAplicación del cliente · usuario a servidor

Actualizar Addresses

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
POST/users/login
Users and identityAplicación del cliente · usuario a servidor

Ejecutar Login para Users

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Flujo de credenciales público con contexto validado de la aplicación del comercio
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Device-IdX-Merchant-IdX-Qa-Api-KeyX-Recaptcha-TokenX-Session-ID
Probar
Ejemplo de cURL
POST/users/logout
Users and identityAplicación del cliente · usuario a servidor

Ejecutar Logout para Users

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
El Gateway no declara un validador de credenciales; el acceso depende del servicio responsable o de la política de red
Encabezados aceptados o reenviados
AuthorizationX-Device-IDX-Session-ID
Probar
Ejemplo de cURL
GET/users/me
Users and identityAplicación del cliente · usuario a servidor

Listar u obtener Me

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Token Bearer del usuario autenticado
Encabezados aceptados o reenviados
AuthorizationX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL
POST/users/register
Users and identityAplicación del cliente · usuario a servidor

Ejecutar Register para Users

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Clave API privada o token Bearer, según el flujo
Encabezados aceptados o reenviados
X-Api-KeyX-Merchant-Id
Probar
Ejemplo de cURL
POST/users/request-code
Users and identityAplicación del cliente · usuario a servidor

Ejecutar Request Code para Users

Dominio
Users and identity
Servicio responsable
Merchant management
Dirigido a
Aplicación del cliente · usuario a servidor
Autorización compatible
Flujo de credenciales público con contexto validado de la aplicación del comercio
Encabezados aceptados o reenviados
AuthorizationX-Api-KeyX-Device-IdX-Merchant-Id
Probar
Ejemplo de cURL

Puntos finales de integración principales#

Las operaciones siguientes conservan los anclajes estables utilizados por las guías de integración y proporcionan contexto adicional para los flujos de trabajo comerciales más comunes.

API de pedidos#

Crear un pedido

POST /merchants/orders

Crea opcionalmente una orden antes del pago y devuelve el order_token que usan los widgets y las operaciones de pago de DEUNA. Las nuevas integraciones directas pueden enviar la orden en línea a Purchase V2.

El objeto requerido varía según el tipo de pedido: los pedidos de Pago y Suscripciones requieren la matriz de artículos, mientras que los pedidos de Aerolíneas requieren información de la aerolínea. El contrato base no marca una propiedad de artículo individual como universalmente requerida. Ver el referencia de campo de artículo y guía de campo vertical.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'Content-Type: application/json' \
  --data @request.json

Obtener un pedido

GET /merchants/orders/{order_token}

Recupera el estado actual del pedido, el pago y el procesamiento de un token de pedido.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-merchant-id: MERCHANT_ID'

Obtener métodos de pago para un pedido

GET /merchants/orders/{order_token}/payments-methods

Devuelve los métodos de pago disponibles para un pedido específico y una configuración de comerciante.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Store-Code: STORE_CODE'

API de pagos#

Crear un pago

POST /v2/merchants/orders/purchase

Crea y procesa una orden en línea con el flujo recomendado de una sola llamada, o procesa un order_token existente cuando la orden se creó por separado. Consulta la guía detallada de guía de solicitud de pago.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/purchase' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Cookie: COOKIE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Session-Id: SESSION_ID' \
  --header 'X-Store-Code: STORE_CODE' \
  --header 'Content-Type: application/json' \
  --data @request.json

Capturar un pago

POST /v2/merchants/orders/{order_token}/capture

Captura todo o parte de un pago autorizado. Llámelo desde el backend del comerciante solo cuando la conexión admita autorización y captura por separado.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/capture' \
  --header 'Content-Type: application/json' \
  --data @request.json

Anular una autorización

POST /merchants/orders/{order_token}/void

Libera una autorización elegible antes de la captura. Una solicitud sincrónica exitosa devuelve HTTP 204 No Content; Los flujos de procesador asincrónicos aún deben rastrearse hasta su estado de pago final.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/void' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data @request.json

Reembolsar un pago

POST /v2/merchants/orders/{order_token}/refund

Crea un reembolso total o parcial para un pago procesado.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/refund' \
  --header 'Content-Type: application/json' \
  --data @request.json

API de red de usuario#

Estas operaciones opcionales admiten identidad de clientes, direcciones reutilizables e instrumentos de pago almacenados de forma segura. No están obsoletas, pero no son requisitos previos para Purchase V2. Las aplicaciones web y móviles usan autorización del cliente. Los backends de confianza del comercio usan la autorización indicada para cada ruta en el inventario anterior.

Autenticación

Registrar un usuario

POST /users/register

Crea opcionalmente un usuario que puede autenticarse y reutilizar de forma segura sus datos y métodos de pago almacenados.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/register' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Solicitar una OTP

POST /users/request-code

Envía el código de un solo uso utilizado por el flujo de autenticación sin contraseña.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/request-code' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Iniciar sesión con una OTP

POST /users/login

Intercambia un código único válido por un token de autorización de usuario.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/login' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Qa-Api-Key: QA_API_KEY_VALUE' \
  --header 'X-Recaptcha-Token: RECAPTCHA_TOKEN_VALUE' \
  --header 'X-Session-ID: SESSION_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Autorización externa

POST /users/external-authorize

Autentica a un usuario a través de un flujo de identidad administrado por el comerciante.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/external-authorize' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Auth-Message: AUTH_MESSAGE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

Usuarios

GET /users/me

Devuelve el perfil del usuario autenticado cuando la integración usa cuentas de cliente opcionales.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/me' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

Direcciones

GET /users/{user_id}/addresses

Enumera las direcciones reutilizables asociadas a un usuario. Esta operación opcional no es necesaria antes de Purchase V2.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

POST /users/{user_id}/addresses

Guarda opcionalmente una dirección para que un usuario autenticado la reutilice. También se puede proporcionar una dirección en línea en una solicitud de pago.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

PATCH /users/{user_id}/addresses/{address_id}

Actualiza una dirección reutilizable existente. El inventario muestra la autorización Bearer y el contexto del comercio requeridos por estas rutas opcionales.

Ejemplo de cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses/{address_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Tarjetas

guardar una tarjeta

POST /v2/users/{user_id}/cards

Tokeniza y almacena una o más tarjetas para uso futuro. El cuerpo de la solicitud es un arreglo JSON, incluso cuando contiene una sola tarjeta. Llama a este endpoint autorizado por el cliente con el token Bearer del usuario y el contexto del comercio mostrado en el inventario generado.

Los datos sin procesar de la tarjeta no deben pasar por los servidores del comercio, salvo que este tenga el alcance PCI requerido. Consulta el flujo de vaulting de la API de Cards para conocer la forma de la solicitud, el límite de seguridad, la respuesta correcta y las pautas de reintento.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

¿Qué ruta POST de tarjeta debo usar?

Solo POST /v2/users/{user_id}/cards es parte del contrato actual de la API externa de Tarjetas. Las otras rutas POST que pueden aparecer en los inventarios de Gateway sirven para diferentes propósitos de compatibilidad o de plataforma; no son tres formas intercambiables de crear una tarjeta.

RutaLo que realmente haceGuía de integración externa
POST /v2/users/{user_id}/cardsTokeniza y almacena una o más tarjetas de cliente. Su cuerpo de solicitud es un arreglo, incluso cuando contiene una sola tarjeta, y la respuesta devuelve tokens DEUNA reutilizables. card_id values.Usa esta ruta para nuevas integraciones de la API de Tarjetas autorizadas por el cliente.
POST /users/{user_id}/cardsPreserva el contrato de solicitud de tarjeta única heredado v1 para integraciones existentes.Ruta de compatibilidad; está intencionalmente excluida del catálogo actual de API externas. No inicies una nueva integración con ella a menos que DEUNA te indique explícitamente hacerlo.
POST /users/{user_id}/cards/{card_id}/tokensAgrega un token específico del procesador o un resultado de verificación a una tarjeta que ya existe. No crea una tarjeta de cliente ni reemplaza la /v2 operación de almacenamiento seguro.Operación gestionada por la plataforma; está intencionalmente excluida de la documentación externa y no debe ser llamada directamente a menos que DEUNA apruebe el flujo y el contrato.

:::info Por qué una ruta puede existir sin aparecer aquí El inventario de API Gateway incluye rutas de compatibilidad y operadas por la plataforma, así como contratos públicos de comerciante. La presencia en el Gateway no convierte por sí misma a una operación en una API externa soportada. El catálogo publica solo operaciones que ya son parte de la referencia externa o tienen aprobación explícita del equipo propietario. :::

Enumerar tarjetas almacenadas

GET /users/{user_id}/cards

Devuelve las tarjetas asociadas al usuario autenticado.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID'

Obtener una tarjeta almacenada

GET /users/{user_id}/cards/{card_id}

Devuelve una tarjeta asociada al usuario autenticado.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

Establecer una tarjeta como predeterminada

PATCH /users/{user_id}/cards/{card_id}/set-as-default

Establece o elimina la tarjeta guardada seleccionada como predeterminada del usuario autenticado. Cuando una tarjeta pasa a ser la predeterminada, DEUNA elimina ese estado de las demás tarjetas del usuario. Consulta Establecer una tarjeta como predeterminada para conocer el cuerpo de solicitud opcional, la respuesta y los pasos de verificación.

Ejemplo de cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Obtener información del BIN de la tarjeta

GET /cards/bin/{bin}

Devuelve metadatos de red, emisor y tipo de tarjeta para un BIN de seis dígitos.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/cards/bin/{bin}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID'

API comercial#

API de Temas

La API de Temas está soportada y no está deprecada. Gestiona configuraciones JSON con nombre y alcance del comerciante que pueden aplicarse a las experiencias DEUNA Checkout y Widget. Llama a estas operaciones solo desde un backend de comerciante confiable con la clave privada X-Api-Key; el servicio de Configuración de Checkout deriva el alcance del comerciante de esa credencial.

Recurso Tema

campoDevueltocrearActualizarDescripción
idSíGeneradoParámetro de rutaUUID del tema generado por DEUNA. Úsalo como theme_id para actualizar y eliminar.
nameSíRequeridoOpcional cuando config se proporcionaNombre único para el comerciante que contiene letras, números o guiones bajos.
configSíRequeridoOpcional cuando name se proporcionaObjeto JSON que contiene la configuración del tema consumida por la experiencia Checkout o Widget.

La operación de creación rechaza nombres duplicados y aplica el conteo máximo de temas del servicio de Configuración de Checkout. La actualización y eliminación devuelven un error cuando theme_id no pertenece a un tema existente en la configuración del comerciante.

curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/checkout/themes' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "checkout_default",
    "config": {
      "theme": {
        "mainColor": "#1479A8",
        "secondaryColor": "#111827",
        "backgroundColor": "#FFFFFF"
      }
    }
  }'
TemaJSON
{
  "id": "bfcabe59-48c9-4c36-b041-71597478689c",
  "name": "checkout_default",
  "config": {
    "theme": {
      "mainColor": "#1479A8",
      "secondaryColor": "#111827",
      "backgroundColor": "#FFFFFF"
    }
  }
}

La operación de lista devuelve la misma forma de recurso en data[]. La creación y actualización devuelven el tema afectado. La eliminación tiene éxito con una respuesta vacía.

:::note Esquema de configuración de tema El servicio valida que config es un objeto JSON pero no valida sus claves anidadas. Usa la forma de configuración soportada por la versión de Checkout o Widget que consumirá el tema. No asumas que un objeto config de la API de Temas y un objeto CustomStyle del SDK son intercambiables. :::

Métodos de pago

GET /merchants/stores/payments-methods

Devuelve los métodos de pago habilitados para una tienda. Pase el código de la tienda en el requerido X-Store-Code header.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/stores/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Store-Code: STORE_CODE'

POST /merchants/payment-links

Crea un enlace de pago desde un backend comercial confiable.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links' \
  --header 'Content-Type: application/json' \
  --data @request.json

GET /merchants/payment-links/{payment_link_id}

Recupera un enlace de pago y su estado actual.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}'

GET /merchants/payment-links/all

Lista los enlaces de pago asociados con la tienda del comercio autenticado.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/all'

GET /merchants/payment-links/{payment_link_id}/orders

Lista las órdenes asociadas con un enlace de pago.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}/orders'

Ver el Guía de integración de enlaces de pago para el flujo de extremo a extremo.

API de suscripciones#

Planes

GET /subscriptions/plans

Enumera los planes de suscripción disponibles para el comerciante autenticado.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

POST /subscriptions/plans

Crea un plan de suscripción.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Suscripciones

Listar suscripciones

GET /subscriptions

Devuelve las suscripciones disponibles para el comerciante autenticado.

Ejemplo de cURL
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

Crear una suscripción

POST /subscriptions

Crea una suscripción utilizando un plan y un método de pago existentes.

Ejemplo de cURL
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

Actualizar una suscripción

PATCH /subscriptions/{id}

Actualiza los atributos admitidos de una suscripción activa.

Ejemplo de cURL
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/subscriptions/{id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json