Pular para o conteúdo principal

A cotação é apenas preço

  • Nenhum remetente é enviado na cotação. O mesmo preço vale para qualquer remetente seu.
  • O remetente é informado e validado no withdrawal. Um remetente não elegível é recusado lá, com SENDER_NOT_ELIGIBLE ou SENDER_LIMIT_EXCEEDED.
  • Para evitar isso, confira o status e os limites do remetente antes de pedir a cotação.

Valor fixo de origem ou de destino

  • You send (USD): a MSB fixa o valor em USD. A cotação calcula quanto o beneficiário recebe em BRL.
  • Recipient gets (BRL): a MSB fixa o valor em BRL. A cotação calcula quanto é necessário em USD.
  • Só um dos dois pode ser informado. Deve ser maior que zero.

O que a cotação mostra

Um preço, igual para PREFUNDED e CREDIT. O valor em BRL que o beneficiário recebe não depende da modalidade de funding.

Validade e uso

  • A cotação tem validade curta, exibida como horário de expiração. Cotação expirada não pode ser usada.
  • Uma cotação só pode ser usada por um withdrawal. O status passa de AVAILABLE para USED, ou para EXPIRED se não for usada a tempo.
  • A modalidade de funding é escolhida no withdrawal. Limite de crédito e saldo em USD são verificados nesse momento. Você pode consultá-los antes em Credit Line e Wallets.
  • Validade da cotação: [A DEFINIR em contrato].

Uso da cotação

  • usage indica para que serve a cotação. REMITTANCE (padrão): usada por um withdrawal. INVENTORY: usada uma única vez para criar um Inventory Lot em POST /v1/inventories. Veja USDC Inventory.
  • Cotações sem usage são REMITTANCE.
  • Usar a cotação na operação errada retorna QUOTE_USAGE_MISMATCH (422): cotação INVENTORY em withdrawal, ou cotação REMITTANCE em POST /v1/inventories.
  • Cotações INVENTORY também trazem inventoryExpiresAt, a validade que o lote terá. É diferente de expiresAt, a validade da própria cotação.
O que você faz
  • Confira o status do remetente e os limites do remetente e do beneficiário antes da cotação.
  • Peça a cotação com valor fixo em USD ou BRL. Não envie remetente.
  • Crie o withdrawal antes do horário de expiração. Se expirar, peça uma nova cotação.