Saltar al contenido principal
En esta página

La funcionalidad de conversión de moneda de DEUNA permite a los comercios mostrar precios y procesar pagos en múltiples monedas, manteniendo el control sobre la moneda de liquidación, las estructuras de costos y la experiencia del usuario.
Al centralizar las integraciones con proveedores de divisas, DEUNA simplifica las operaciones transfronterizas y garantiza que los detalles de conversión fluyan de forma consistente a lo largo del ciclo de vida de la transacción.

Los comercios pueden proporcionar sus propios datos de divisas o confiar en los servicios de tasas integrados de DEUNA.

Beneficios Clave#

  • Aceptación de Múltiples Monedas
    Ofrecer precios y opciones de pago localizadas a los clientes en diferentes mercados.

  • Mejora de la Experiencia del Usuario
    Reducir la fricción al permitir que los compradores paguen en la moneda que mejor comprenden.

  • Eficiencia Operacional
    Evitar la gestión de múltiples integraciones con proveedores de divisas; DEUNA gestiona los formatos específicos del proveedor.

  • Opciones de Liquidación Flexibles
    Procesar en una moneda mientras se muestra o cobra en otra.

Cuándo utilizar la conversión de moneda#

  • Comercio Electrónico Transfronterizo – Mostrar la moneda local mientras se liquida en la moneda base del comerciante.
  • Remesas y Pagos – Convertir fondos al enviar o recibir transferencias transfronterizas.
  • Viajes y Aerolíneas – Apoyar pagos de viajeros internacionales y diferentes monedas de punto de venta.
  • Servicios Financieros – Gestionar las conversiones de divisas para activos denominados en múltiples monedas.

Conceptos Clave#

Tipo de Cambio
Determina el valor utilizado para convertir una moneda a otra. Puede ser fijo, definido por el proveedor o basado en las condiciones del mercado en tiempo real.

Moneda Base
Moneda de la cual se origina la conversión.

Moneda del Comprador
Moneda en la que se cobrará al cliente.

Margen de Divisas
Margen aplicado por el proveedor sobre el tipo de cambio subyacente.

Tasas en Tiempo Real
Tasas devueltas y aplicadas en el momento en que el comerciante o DEUNA solicitan la conversión.

Opciones de Arquitectura#

Flujo de Conversión de Moneda Propio por el Comerciante

Diagrama de flujo
1 · Periodic FX push2 · Refresh internal FXtables3 · Shopper selectscurrency and amount4 · Forward FX detailsand amount1DEUNA FX EngineRetrieves rates from themerchant's selected providers2Merchant webhookReceives updated conversioninformation3Merchant checkoutDisplays converted amountswith DEUNA-provided rates4Purchase requestPOST /purchase with the finalconverted amount5FX processor or acquirerUses the converted values andDEUNA metadata
DEUNAComercio o cliente

Conversión de Moneda en Tiempo Real

Diagrama de flujo
Merchant-provided rateDEUNA-managed rateReturns rate dataReturns FX reference1Merchant checkout2DEUNA Currency ConversionReceives an FX quote requestor merchant rate3Merchant's FX providerOption A · Merchant suppliesthe rate4DEUNA Rate ServiceOption B · DEUNA retrieves therate5FX detailsRate data6FX quote responseReusable FX reference7Payment creationUses FX data or an FX ID8Transaction
Comercio o clienteDEUNAResultado

Opciones de Integración#

DEUNA admite dos modelos para aplicar la conversión de moneda durante el procesamiento de pagos:

  1. Tipo de Cambio Proporcionado por el Comerciante
  2. Servicio de Tasas de DEUNA (recuperación de tasas de DEUNA)

Ambas opciones le permiten cobrar al comprador en una moneda y liquidar en otra, según su configuración comercial y operativa.

1. Tipo de Cambio Proporcionado por el Comerciante

Si su negocio ya obtiene tipos de cambio de un proveedor de divisas externo, puede proporcionar esta información a DEUNA como parte de la solicitud de pago.
DEUNA incluirá estos detalles de divisas al enrutar la transacción al adquirente o procesador.

Solicitud de Pago con Ejemplo de Tipo de Cambio del Comerciante

JSON
{
  "amount": {
    "currency": "COP",
    "value": 5000,
    "currency_conversion": {
      "external_rate_reference": "AAA01SADOIAJSDLAKSJM",
      "shopper_currency": "ARS",
      "shopper_amount": 1146.55
    }
  }
}

2. Servicio de Tasas de DEUNA

El Servicio de Tasas de DEUNA permite a los comercios confiar en DEUNA para obtener tipos de cambio directamente de un proveedor de divisas integrado. Esta opción es ideal cuando desea que DEUNA estandarice el flujo de trabajo de divisas en todos los proveedores sin gestionar múltiples integraciones o formatos de tasas.

Este flujo utiliza un proceso de dos pasos:

  1. Solicitar un tipo de cambio de DEUNA
  2. Use the returned FX rate ID al crear el pago

Esto garantiza que el tipo de cambio cotizado esté correctamente vinculado a la transacción final.

Convertir divisas#

1. Solicitar un Tipo de Cambio

Enviar una solicitud indicando:

  • La moneda original de la transacción
  • La moneda preferida del usuario
  • El proveedor de divisas del que DEUNA debe obtener las tasas

Solicitud

JSON
{
  "amount": 30000,
  "original_currency": "MXN",
  "destination_currency": "USD",
  "provider_info": {
     "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a"
  }
}

Respuesta

JSON
{
  "currency_conversion": {
    "id": "ccv_7b29c4ab-f61d-4e58-9dc5-1a9fceb823b3",
    "original_currency": "MXN",
    "destination_currency": "USD",
    "original_amount": 30000,
    "destination_amount": 1764.71,
    "rate": 0.0588237,
    "provider_info": {
      "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a",
      "name": "NUVEI",
      "timestamp": "2025-01-04T18:15:23Z"
    },
    "expires_at": "2025-01-04T18:20:23Z",
    "metadata": {
      "rate_type": "real_time",
      "precision": 6
    }
  }
}

2. Utilizar el ID de Tipo de Cambio en la Creación del Pago

Enviar una solicitud indicando:

  • La moneda original de la transacción
  • La moneda preferida del comprador
  • El proveedor de divisas del que DEUNA debe obtener las tasas

Ejemplo de solicitud en la API de compra

JSON
{
  ...
  "total_amount": {
      "currency_conversion": {
          "external_rate_reference": "...",
          "original_currency": "MXN",
          "destination_currency": "USD",
          "original_amount": 30000,
          "destination_amount": 1764.71
      }
  }
  ...
}

Requisitos de Activación

Para habilitar cualquier flujo de conversión de moneda, póngase en contacto con su Administrador de Implementación de DEUNA. La configuración depende del proveedor de divisas, la región y la configuración del comerciante.