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
Parámetros de la solicitud
Los siguientes campos se envían dentro deamount.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.
providerdebe coincidir exactamente con uno de los valores enum permitidos.cardholder_currencydebe ser un código ISO 4217 alfa-3 válido y debe ser distinta deamount.currency.created_atyexpires_atdeben ser marcas de tiempo ISO 8601 válidas.expires_at, cuando se proporciona, debe ser estrictamente mayor quecreated_at.rate_sourcees obligatorio siempre querate_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.