Saltar al contenido principal
La API de conversión masiva de divisas te permite realizar transacciones de individuales o múltiples de forma programática con tipos de cambio óptimos y una gran eficiencia de procesamiento.

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.
ImportantePuedes generar de antemano cotizaciones de tipo de cambio con nuestra API de cotización de cambio de divisas y fijar los tipos de cambio incluyendo el exchangeRateToken en tu solicitud masiva.

Endpoint de la API

Para crear intercambios masivos, envía una solicitud POST 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:
  1. Generar cotización: Llamar a la API de cotización de cambio de divisas
  2. Obtener token: Extrae el exchangeRateToken de la respuesta
  3. 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.

Última modificación el 10 de noviembre de 2026