Saltar al contenido principal

Qué es la conversión de moneda

El servicio de conversión de moneda de Yuno te permite liquidar pagos tanto en tu moneda como en la de tu cliente. La conversión de moneda es el proceso de convertir una moneda en otra. Implica usar tipos de cambio para determinar el monto equivalente en la moneda de destino.

Beneficios

  • Alcance global y comodidad para el cliente: Acepta y liquida pagos en varias monedas para que los clientes paguen en la moneda que prefieran.
  • Optimización de costos e ingresos: Reduce los costos de transacción y aprovecha tipos de cambio favorables.

Casos de uso comunes

  • Comercio transfronterizo: Negocios de e-commerce, remesas y viajes y hotelería que necesitan cobrar o pagar en la moneda local del cliente.
  • Plataformas de inversión: Fintechs que operan acciones, bonos o criptomonedas extranjeras en distintas monedas.

Implementación

Yuno conecta distintos proveedores de conversión de moneda, para que no tengas que preocuparte por las diferencias entre cada integración. La implementación del servicio depende del proveedor de conversión de moneda con el que elijas trabajar.

Conceptos clave

  • Tipo de cambio: La tasa a la que una moneda puede intercambiarse por otra. Puede ser una tasa fija o una tasa flotante que fluctúa según las condiciones del mercado.
  • Moneda base: La moneda desde la que conviertes.
  • Moneda del titular de la tarjeta: La moneda a la que conviertes.
  • Margen de conversión: La diferencia entre las tasas de compra y de venta, que representa el margen de ganancia de la entidad que presta el servicio de conversión.
  • Conversión en tiempo real: Uso de tipos de cambio actualizados para realizar conversiones en el momento exacto de la transacción.

Implementación de la API

Para usar el servicio de conversión de moneda, tienes dos implementaciones de API disponibles.

Servicio de tipo de cambio del proveedor

El comercio puede usar el servicio de conversión de moneda de un proveedor externo y enviar la información correspondiente directamente en el pago en Yuno. Para usarlo, contacta a tu technical account manager para asegurarte de que la información esté configurada correctamente. Ejemplo:

Servicio de tipo de cambio de Yuno

El comercio también puede usar directamente el servicio de conversión de moneda de Yuno, que obtiene la información del proveedor de su elección, y enviar en la creación del pago el id de la consulta de tipo de cambio y los datos del monto según corresponda. Si usas este servicio, también deberás enviar el id obtenido en la solicitud de pago para que podamos vincular la información. Ejemplo:
Rate service
Payment
Para usarlo, contacta a tu technical account manager para asegurarte de que la información esté configurada correctamente.

Parámetros de la solicitud

Los siguientes campos se envían dentro de amount.currency_conversion en POST /v1/payments.

Valores de proveedor

provider acepta uno de estos valores:

Reglas de validación

  • Todos los campos obligatorios deben estar presentes.
  • provider debe coincidir exactamente con uno de los valores enum permitidos.
  • cardholder_currency debe ser un código ISO 4217 alfa-3 válido y debe ser distinta de amount.currency.
  • created_at y expires_at deben ser marcas de tiempo ISO 8601 válidas.
  • expires_at, cuando se proporciona, debe ser estrictamente mayor que created_at.
  • rate_source es obligatorio siempre que rate_margin_percentage > 0.
  • Un pago con una promoción de Yuno no puede incluir una conversión de moneda: Yuno lo rechaza con 422 PROMOTION_CONTEXT_MISMATCH. Una promoción se valora en la moneda propia del pago, así que envía el pago sin la conversión.

Ejemplo de solicitud