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étodo	Endpoint
`POST`	`/api/v2/companies/{companyId}/wallets/conversions/confirm`

Parâmetros

Parâmetros aceitos por esta operação.

Parâmetro	Local	Descrição
`companyId`	`path`	`Identificador da empresa`
`idempotency-key`	`header`	`UUID ú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,"onpayCode":"ONP200","data":{"conversionId":"fx_01J...","sourceMethod":"SPEI","sourceCurrency":"MXN","sourceAmount":1000,"destinationMethod":"PIX","destinationCurrency":"BRL","destinationAmount":297,"marketRate":0.30,"appliedRate":0.297,"spreadPercentage":1,"status":"COMPLETED"}}