Conversions
Aceitar Conversão
POST /v2/rfq/accept — aceita uma cotação existente, escolhendo o dia de liquidação e o destino.
Aceita uma cotação criada via Criar Conversão, travando a taxa e agendando a entrega. O saldo em
Response
Um
Códigos de retorno:
from_currency precisa estar disponível no momento do aceite — ele não é reservado quando a cotação é criada.
Corpo da requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
rfq_id | string | Sim | ID retornado por Criar Conversão |
settlement_day | string | Sim | "d0" ou "d1" |
wallet_id | string | Condicional | ID da wallet cripto de destino (pagamento em cripto) |
pix_key | string | Condicional | Chave Pix de destino (pagamento em BRL) |
Response 200 OK (aceito)
| Campo | Tipo | Descrição |
|---|---|---|
rfq_id | string | ID da conversão |
state | string | DONE assim que aceito |
amount_from | float | Montante confirmado enviado |
amount_to | float | Montante confirmado a receber |
rate | float | Taxa confirmada |
quote_pair | string | Identificador do par de cotação |
settlement_eta | string | Horário de liquidação confirmado (RFC 3339) |
200 aqui significa que a operação está travada e a entrega agendada — não significa que os fundos já chegaram. A entrega é concluída em settlement_eta; use Consultar Conversão ou o webhook para acompanhar.
Respostas de erro
| HTTP | Estado | Motivo |
|---|---|---|
409 Conflict | EXPIRED | A taxa expirou e a cotação foi renovada — consulte a conversão via GET e reenvie o aceite com a nova taxa |
410 Gone | DEPRECATED | A janela de renovação foi encerrada — crie uma nova cotação |
422 Unprocessable Entity | ERROR | Saldo insuficiente, limite excedido ou outra falha de regra de negócio |
202 Accepted | outro | Ainda em processamento — tente aceitar novamente, ou consulte via GET, até atingir um estado final |
200, 202, 400, 401, 409, 410, 422, 500

