Saltar al contenido principal
Fijar un tipo de cambio te permite garantizar el precio de conversión antes de ejecutar una transacción, protegiéndote a ti y a tus usuarios de las fluctuaciones del mercado entre la cotización y la ejecución. Los tres flujos: payins, payouts y cambio de divisas masivo: siguen el mismo patrón de dos pasos:
  1. Obtén una cotización: llama a la API de cotización de cambio de divisas especificando el tipo de operación (payin, payout o CurrencyExchange). Recibirá un exchangeRateToken con una tasa garantizada y un tiempo de vencimiento.
  2. Usa el token: incluye el exchangeRateToken en tu solicitud de payin, payout o cambio de divisas masivo. La API aplica automáticamente la tasa fijada.
Las secciones siguientes usan un payin como ejemplo, pero la estructura es similar para los payouts y el cambio de divisas masivo.
Vencimiento de la tasaLa tasa fijada solo está garantizada hasta el expirationDate del token. Si el token vence antes de que envíes la transacción, la operación utilizará la tasa de mercado de ese momento.

Cotizar un payin

Utiliza este flujo cuando desees mostrar el tipo de cambio a tu usuario antes de cobrar un pago.

Paso 1: solicitar una cotización

Solicitud
curl
Respuesta

Paso 2: enviar el payin con el token

Solicitud
curl
Respuesta


curl

Mostrar el tipo de cambio antes del checkout

Si estás creando un checkout y deseas mostrar el tipo de cambio a tu usuario antes de que confirme el pago, este es el flujo:
  1. El usuario selecciona una cantidad y una divisa.
  2. Tu backend llama a la API de cotización de cambio de divisas y recibe la tasa en el parámetro exchangeRateToken.
  3. Tu frontend muestra: “Tú pagarás 10,000 ARS ≈ 8.37 USD (tasa: 0.000837)”
  4. El usuario confirma.
  5. Tu backend envía el payin con el exchangeRateToken para aplicar la tasa fijada.
Esto garantiza que la tasa que vio tu usuario sea la tasa aplicada a la transacción, siempre que la envíes antes del expirationDate del token.
Consejo de diseño:Muestra el expirationDate en tu interfaz como una cuenta regresiva (p. ej., “Tasa válida por 8 horas”). Esto establece la expectativa correcta y reduce los tickets de soporte cuando una tasa cambia entre sesiones.

Última modificación el 10 de noviembre de 2026