Pular para o conteúdo
LeonaPayDevelopers
Primeiros passosReferenciais da APIIntegraçõesv2
POST · /api/v2/companies/{companyId}/wallets/conversions/quote

Cotar conversão entre carteiras

Cria uma cotação temporária entre carteiras usando a cotação de mercado, o deságio global ou direcional e o spread comercial configurado para a empresa. Nenhum saldo é movimentado nesta etapa.

Endpoint

Esta operação usa autenticação por x-api-key e retorna JSON.
MétodoEndpoint
POST/api/v2/companies/{companyId}/wallets/conversions/quote

Parâmetros

Parâmetros aceitos por esta operação.
ParâmetroLocalDescrição
companyIdpathIdentificador da empresa

Corpo da requisição

Envie os campos abaixo com Content-Type: application/json.
Exiba marketRate, discountPercentage, localRate, spreadPercentage, appliedRate, destinationAmount e expiresAt antes da confirmação. Uma cotação expirada deve ser refeita.
{"sourceCurrency":"USDT","destinationCurrency":"BRL","sourceAmount":100}

Exemplo de requisição

Use uma chave de idempotência única em operações POST.
curl --request POST \
  --url 'https://api.leonapay.com.br/api/v2/companies/{companyId}/wallets/conversions/quote' \
  --header 'Accept: application/json' \
  --header 'x-api-key: {your_api_key}' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: {uuid}' \
  --data '{"sourceCurrency":"USDT","destinationCurrency":"BRL","sourceAmount":100}'

Resposta

Uma operação aceita retorna o envelope padrão da API LeonaPay.
{"success":true,"leonapayCode":"LP200","data":{"sourceCurrency":"USDT","sourceAmount":100,"destinationCurrency":"BRL","destinationAmount":479.18,"marketRate":5.20,"discountPercentage":5,"localRate":4.94,"spreadPercentage":3,"appliedRate":4.7918,"expiresAt":1791115500000,"quoteToken":"eyJ..."}}
LeonaPay Developers · API v2