Saltar al contenido principal
POST
Utiliza la API de cambio de divisas masivo para convertir fondos de manera eficiente entre tus propias cuentas multidivisa dentro del mismo país. Es ideal para empresas que gestionan operaciones internacionales y desean optimizar su tesorería interna.
Importante
  • account.debited.amount: La cantidad que se deducirá de la cuenta de origen.
  • account.credited.amount: La cantidad que se agregará a la cuenta de destino. El valor del campo proporcionado debe ser mayor que 0.
¿Deseas fijar un tipo de cambio antes de ejecutar la transacción?Utiliza la API de cotización de cambio de divisas para generar una cotización de tipo de cambio para el par de divisas. La respuesta incluye un exchangeRateToken inclúyelo en tu solicitud de conversión de divisas para asegurar ese tipo de cambio. El tipo de cambio cotizado está garantizado hasta el expirationDate del token, lo que lo protege tanto a ti como a tu usuario de las fluctuaciones del mercado.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token.

Cuerpo

application/json
country
string
requerido

El país donde se procesará el pago.

externalId
string
requerido

Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y con guiones). Recomendamos usar UUID4 para garantizar su unicidad.

exchangeRateToken
string
requerido

Token proporcionado por el servicio de cambio de divisas para utilizar un tipo de cambio acordado previamente

account
object
requerido

Objeto que contiene los detalles de la cuenta de la transacción.

Respuesta

OK

transactionType
string

Tipo de transacción. Para las operaciones de cambio de divisas, este valor es CurrencyExchange.

externalId
string

Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y con guiones). Recomendamos usar UUID4 para garantizar su unicidad.

internalId
string

Identificador de transacción de Localpayment.

country
string

País donde se procesa la transacción.

currency
string

La moneda original de la transacción.

exchangeRateToken
string

Un identificador único utilizado para rastrear el tipo de cambio de la transacción.

clientCode
string

Un identificador único asignado al cliente dentro del sistema Localpayment.

creationDate
string

La fecha y hora en que se creó la transacción.

errors
object[]

Un conjunto de objetos de error, en caso de que se haya producido algún error durante la transacción.

status
object
account
object
Última modificación el 10 de noviembre de 2026