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

Confirmar conversão entre carteiras

Confirma a cotação assinada e movimenta o ledger de forma atômica: debita a carteira de origem e credita a carteira de destino na moeda correta.

Endpoint

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

Parâmetros

Parâmetros aceitos por esta operação.
ParâmetroLocalDescrição
companyIdpathIdentificador da empresa
idempotency-keyheaderUUID único da conversão; reutilize o mesmo valor em retentativas

Corpo da requisição

Envie os campos abaixo com Content-Type: application/json.
A operação é indivisível e idempotente. Se o saldo for insuficiente, a cotação expirar ou os termos forem alterados, nenhum lançamento é persistido.
{"quoteToken":"eyJ..."}

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/confirm' \
  --header 'Accept: application/json' \
  --header 'x-api-key: {your_api_key}' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: {uuid}' \
  --data '{"quoteToken":"eyJ..."}'

Resposta

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