Requisitos previos
Antes de solicitar cotizaciones de cambio de divisas, asegúrate de tener:- Credenciales API válidas con permisos de cambio de divisas.
- Números de cuenta activos tanto para la divisa de origen como para la divisa de cotización.
Endpoint de la API
Para cotizar un cambio, envía una solicitudGET al endpoint Obtén una cotización de divisas.
Endpoint
{type} con el tipo de transacción que coincida con tu caso de uso:
Autenticación
Incluye tu token de acceso en los encabezados de la solicitud:Parámetros clave de la solicitud
Ejemplo de solicitud
- Moneda local (PayIn)
- Moneda estable (USDC / USDT)
curl
Gestión de respuestas
Respuesta de éxito
Una solicitud exitosa devuelve información sobre el tipo de cambio con un token seguro:- Moneda local (PayIn)
- Moneda estable (USDC / USDT)
Campos de respuesta clave
Respuestas de error
Mejores prácticas
Seguridad y rendimiento
- Utiliza siempre HTTPS para las solicitudes a la API.
- Guarda los tokens de acceso de forma segura y rótalos periódicamente.
- Supervisa atentamente los tiempos de vencimiento de los tokens.
- Almacena en caché las cotizaciones adecuadamente, pero respeta las fechas de vencimiento.
Importante: Caducidad del token
Los tokens de tipo de cambio tienen una vigencia limitada. Planifica tu flujo de trabajo para que se complete dentro del plazo de vencimiento. El tipo de cambio cotizado solo está garantizado mientras el token sea válido.Consejo profesionalDiferentes métodos de pago pueden ofrecer distintos tipos de cambio. Revisa todas las opciones disponibles en el arreglo
quotes para seleccionar el tipo de cambio más favorable para tu caso de uso.Flujo de trabajo de integración
- Obtén una cotización: Solicita las tasas de cambio para el par de divisas que desees.
- Selecciona el método: Elige el método de pago óptimo entre las opciones disponibles.
- Almacena el token: Guarda el
exchangeRateTokenpara tu transacción. - Ejecutar transacción: Utiliza el token en tu llamada a la API de pago.
- Supervisa el vencimiento: Completa la transacción antes de
expirationDate.
Próximos pasos
Procesamiento de Payins
Procesa los pagos utilizando tu moneda convertida.
Procesamiento de Payouts
Procesa los pagos utilizando tu moneda convertida.
Ejecutar cambio de divisas
Utiliza tu token de tipo de cambio para realizar la conversión de divisas.
Consejo profesionalPrueba tu flujo de trabajo exhaustivamente en nuestro entorno de pruebas. Esto garantiza que tu integración gestione correctamente las fluctuaciones de tarifas, la caducidad de los tokens y los escenarios de error antes de tu lanzamiento.
¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

