Cotação

Cotação (quote) é um snapshot de preço. Ela trava a taxa BRL → USDT no momento da criação por 15 minutos. Não cria conversão, não emite QR Pix, não reserva limite. Cotar é barato e descartável.

O que a cotação carrega

• id: identificador estável da cotação.
• exchange_rate: a taxa snapshotada para o par BRL → USDT, considerando o modo de taxas configurado para sua organização (veja Modelo de taxas).
• source_amount e target_amount: valores em BRL e USDT implicados pela taxa.
• expires_at: timestamp em que a cotação deixa de ser aceitável.

Os campos exatos da resposta vão na referência da API.

O que a cotação não faz

• Não emite QR Pix. O QR só nasce quando você aceita a cotação. Veja Aceitando a cotação.
• Não reserva limite. A reserva acontece no aceite.
• Não bloqueia o cliente final. O lock por (user_id, transaction_type) é criado na conversão, não na cotação.
• Não pode ser modificada. Cotações são imutáveis. Se a taxa mudar antes do aceite, crie outra cotação.

TTL de 15 minutos

A janela curta é deliberada: a integração é programática, e a cotação serve para capturar a taxa no instante imediatamente anterior ao aceite. Se a sua UX precisa de mais tempo entre obter a taxa e o cliente final confirmar, cote de novo no aceite, não tente estender a validade.

Pré-requisitos para criar cotação

• Cliente final com KYC de plataforma aprovado.
• Endereço de destino on-chain (destination_wallet_address) e rede declarada (destination_wallet_network).
• Valor em BRL (source_amount) ou em USDT (target_amount).

Sem esses três, a chamada falha com erro de validação.

Cotação consumida

Quando você aceita uma cotação, ela transita para consumed e fica vinculada à conversão criada (consumed_by_conversion_id). Não dá para aceitar a mesma cotação duas vezes.

Próximos passos

• Conversão: para onde a cotação é levada quando você aceita.
• Criando uma cotação: o passo a passo da chamada.