Criando uma cotação
POST /v1/quotes para onramp. O que enviar, o que recebe de volta, o que essa chamada não faz.
Ponto de partida do onramp. A chamada cria uma cotação com TTL de 15 minutos. Não cria conversão e não emite QR Pix.
Pré-requisitos
- Cliente final com KYC de plataforma aprovado. Sem KYC aprovado, a cotação falha com erro de validação. Veja KYC.
- Endereço de destino (
destination_wallet_address) e rede (destination_wallet_network) declarados. - Valor: BRL (
source_amount) ou USDT (target_amount).
A chamada
POST /v1/quotes
O corpo carrega o cliente final (user_id), o tipo (pix_onramp), o valor e o endereço de destino. Os campos exatos vão na referência da API.
O que volta
A resposta carrega:
id: identificador estável da cotação.exchange_rate: a taxa BRL → USDT aplicada, considerando o modo de taxas configurado.source_amountetarget_amount: BRL e USDT implicados.expires_at: timestamp em que a cotação deixa de ser aceitável.
A taxa exposta depende do modo de taxas da sua organização.
O que não volta
- QR Pix. O QR só é emitido no aceite. Veja Aceitando a cotação.
- Conversão. Cotação não cria conversão.
- Reserva de limite. Reserva acontece no aceite.
TTL de 15 minutos
A cotação vale 15 minutos a partir da criação. 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.
Não polle cotações
Uma cotação não muda de estado. Se você precisa de uma taxa mais nova, crie outra cotação.
Erros comuns
- KYC do cliente final pendente ou rejeitado → erro de validação com código estável.
- Endereço de destino inválido para a rede declarada →
invalid_wallet_address(422). - Rede não suportada →
unsupported_deposit_network(422). - Sem permissão para o tipo
pix_onramp→ erro de autorização.
A taxonomia completa vai na referência da API.
Próximo passo
- Aceitando a cotação: converte a cotação em conversão e emite o QR Pix.