Cotar conversão entre carteiras

Cria uma cotação temporária entre carteiras usando a cotação de mercado atual e o spread configurado para a empresa. Nenhum saldo é movimentado nesta etapa.

Endpoint

Esta operação usa autenticação por x-api-key e retorna JSON.

Método	Endpoint
`POST`	`/api/v2/companies/{companyId}/wallets/conversions/quote`

Parâmetros

Parâmetros aceitos por esta operação.

Parâmetro	Local	Descrição
`companyId`	`path`	`Identificador da empresa`

Corpo da requisição

Envie os campos abaixo com Content-Type: application/json.

Exiba marketRate, spreadPercentage, appliedRate, destinationAmount e expiresAt ao usuário antes da confirmação. Uma cotação expirada deve ser refeita.

{"sourceMethod":"SPEI","destinationMethod":"PIX","sourceAmount":1000}

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 '{"sourceMethod":"SPEI","destinationMethod":"PIX","sourceAmount":1000}'

Resposta

Uma operação aceita retorna o envelope padrão da API LeonaPay.

{"success":true,"onpayCode":"ONP200","data":{"sourceMethod":"SPEI","sourceCurrency":"MXN","sourceAmount":1000,"destinationMethod":"PIX","destinationCurrency":"BRL","destinationAmount":297,"marketRate":0.30,"appliedRate":0.297,"spreadPercentage":1,"expiresAt":1787700000000,"quoteToken":"eyJ..."}}