Cotação Cambial

Atenção

As rotas de Cross Border não estão habilitadas por padrão. Antes de integrar, é necessário alinhamento prévio com os times de Risco e Desenvolvimento da Marlim.

Use esta rota para estimar, antes de criar a transação, quanto o seu cliente vai pagar e quanto você recebe, nas duas direções do câmbio.

currency	pay_currency	O que a cotação responde
USD	BRL	Preço anunciado em dólar e cliente pagando em reais. É a direção da transação Cross Border, feita com cartão de crédito. O net_value é quanto será cobrado do cliente.
BRL	USD	Preço anunciado em reais e cliente pagando em dólar. O exchange mostra quanto o cliente paga e as taxas aplicadas.

O pay_currency é sempre a outra ponta do currency, e pode ser omitido.

Importante

Os valores desta rota são uma estimativa. O câmbio só é travado no momento da transação, e alguns centavos podem variar entre a prévia e a cobrança.

Na criação da transação em dólar, informe apenas o amount e o currency. O net_value não é aceito nesse modo, porque o valor em reais é calculado pela cotação do momento.

GETv3/crossborder/quotes/preview

Request Query Params

Atributo	Tipo	Descrição
amount	int32	Preço anunciado, em centavos, na moeda informada em currency. Ex.: US$ 85,99 → 8599
currency	string	Parâmetro opcional que define a moeda do amount, ou seja, a moeda do preço anunciado. Valores aceitos: BRL e USD. Default: BRL
pay_currency	string	Parâmetro opcional que define a moeda em que o cliente paga. É sempre a outra ponta: BRL quando currency é USD, e USD quando é BRL.

Response

Atributo	Tipo	Descrição
currency	string	Moeda do amount informado.
amount	int32	O amount informado, em centavos.
net_value	int32	Estimativa, sempre em centavos de real, na cotação comercial e sem as taxas do câmbio. Com o preço anunciado em dólar, é a conversão desse valor. Com o preço já em reais, é o próprio valor informado.

Importante

O valor convertido deve ser de no mínimo 50 USD. Abaixo disso, a rota devolve o mesmo erro da criação da transação.

Exemplo de Response — preço em dólar, cliente paga em reais

{
  "currency": "USD",
  "amount": 8599,
  "net_value": 44739
}

Lendo o exemplo: o produto anunciado a US$ 85,99 será cobrado do cliente por aproximadamente R$ 447,39.

Exemplo de Response — preço em reais, cliente paga em dólar

{
  "currency": "BRL",
  "amount": 44700,
  "net_value": 44700
}

Aqui o produto anunciado a R$ 447,00 será cobrado do cliente por aproximadamente US$ 86,14.