Requisitos previos
Antes de crear intercambios de divisas, asegúrate de tener:- Credenciales API válidas con permisos de cambio de divisas.
- Números de cuenta activos tanto para la moneda de origen como para la de destino.
- Saldo suficiente en tu cuenta en la moneda de origen.
Endpoint de la API
Para crear intercambios masivos, envía una solicitudPOST al endpoint Crear conversión de divisas masiva.
Endpoint
Autenticación
Incluye tu token de acceso en todas las solicitudes a la API:Parámetros clave de la solicitud
Ejemplo de solicitud (Argentina)
curl
Gestión de respuestas
Respuesta de éxito
Un cambio de divisas exitoso devuelve los detalles de la transacción:Campos de respuesta clave
Respuesta de error
Fondos insuficientes
Seguimiento del estado de las transacciones
Supervisa tus cambios de divisas a través de múltiples canales:Webhooks (recomendado)
Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.
Endpoint de la API de estado
Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.
Vista del Business Portal
Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.
Ciclo de vida del estado
Referencia completaConsulta todos los códigos de estado en nuestra documentación sobre el estado de las transacciones.
Características avanzadas
Utilización de cotizaciones de tipo de cambio
Asegura tarifas favorables generando cotizaciones con anticipación:- Generar cotización: Llamar a la API de cotización de cambio de divisas
- Obtener token: Extrae el
exchangeRateTokende la respuesta - Aplicar token: Incluye el token en tu solicitud de intercambio masivo.
Consejos para el procesamiento a granel
Optimización del rendimiento- Solicitudes por lotes: Agrupa varios intercambios en una única llamada a la API siempre que sea posible.
- Limitación de velocidad: Implementar retroceso exponencial para el procesamiento de alto volumen.
- Gestión de webhooks: Utiliza webhooks en lugar de realizar sondeos para obtener actualizaciones de estado.
- Lógica de reintento por error: Implementar mecanismos de reintento inteligentes para fallos temporales.
Pruebas y validación
Entorno de pruebas
Prueba tu integración en nuestro entorno de pruebas:Escenarios de prueba
Valida estos escenarios antes de tu lanzamiento:- Cambio de divisas exitoso con cuentas válidas
- Gestión de errores por fondos insuficientes
- Vencimiento del token de tipo de cambio
- Manejo de números de cuenta no válidos
- Escenarios de tiempo de espera de red
- Procesamiento de notificaciones de webhook
Recursos y próximos pasos
Maximiza el éxito de tu integración con estos recursos esenciales.Integración de webhooks
Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.
Portal de informes empresariales
Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.
Monitoreo de transacciones
Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.
Referencia de la API
Documentación completa del endpoint con ejemplos interactivos.
Consejo profesionalSiempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.
¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

