Pular para o conteúdo principal
POST
Use a API de Câmbio em Massa para converter fundos com eficiência entre suas próprias contas multimoeda dentro do mesmo país. Isso é ideal para empresas que gerenciam operações internacionais e querem otimizar sua tesouraria interna.
Importante
  • account.debited.amount: O valor a ser debitado da conta de origem.
  • account.credited.amount: O valor a ser creditado na conta de destino. O valor do campo informado deve ser maior que 0.
Deseja fixar uma taxa de câmbio antes de executar a transação?Use a API de Cotação de Câmbio para gerar uma cotação de taxa para o par de moedas. A resposta inclui um exchangeRateToken; informe-o na sua solicitação de conversão de câmbio para fixar essa taxa. A taxa cotada é garantida até o expirationDate do token, protegendo você e seu usuário das flutuações do mercado.

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso.

Corpo

application/json
country
string
obrigatório

O país onde o pagamento será processado.

externalId
string
obrigatório

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade.

exchangeRateToken
string
obrigatório

Token fornecido pelo serviço de câmbio para utilizar uma taxa de câmbio previamente acordada

account
object
obrigatório

Objeto com os detalhes da conta para a transação.

Resposta

OK

transactionType
string

Tipo de transação. Para operações de câmbio, este valor é CurrencyExchange.

externalId
string

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade.

internalId
string

Identificador de transação da Localpayment.

country
string

País onde a transação é processada.

currency
string

A moeda original da transação.

exchangeRateToken
string

Um identificador único usado para rastrear a taxa de câmbio da transação.

clientCode
string

Um identificador único atribuído ao cliente dentro do sistema Localpayment.

creationDate
string

Data e hora em que a transação foi criada.

errors
object[]

Uma matriz de objetos de erro, caso tenha ocorrido algum erro durante a transação.

status
object
account
object
Última modificação em 10 de novembro de 2026