Pular para o conteúdo principal

Códigos de moeda e valores

Códigos de moeda​

Moedas fiat e a maioria dos criptoativos usam um único código, como USD, EUR, BTC, ETH ou TON.

Uma stablecoin existe em várias redes, então o código dela depende do que o campo representa:

  • Fundos que passam por uma blockchain. Envie a stablecoin com a rede depois de um sublinhado, por exemplo USDT_TRC20 para USDT na Tron, para que o pagamento passe pela rede desejada. Esses campos são senderCurrency nas faturas cripto, destCurrency nos pagamentos cripto, currency e desiredCurrency em Consulta de taxa de câmbio, e currency e currencyConverted em Consulta de limites mínimos.
  • Suas carteiras. Use o ticker sem rede, USDT ou USDC. Uma stablecoin tem um único saldo para todas as redes, então srcCurrency e as duas moedas de uma transferência entre carteiras da Volet.com não têm rede.

Códigos de stablecoins por rede​

RedeUSDTUSDC
Ethereum (ERC-20)USDT_ERC20USDC_ERC20
BNB Smart Chain (BEP-20)USDT_BEP20USDC_BEP20
Tron (TRC-20)USDT_TRC20Não aceito
SolanaUSDT_SOLUSDC_SOL
TONUSDT_TONNão aceito
PolygonUSDT_POLUSDC_POL
ArbitrumUSDT_ARBUSDC_ARB
OptimismUSDT_OPUSDC_OP
Avalanche C-ChainUSDT_AVAXCUSDC_AVAXC

Outros criptoativos​

Moedas que existem em uma única rede usam o ticker: BTC (Bitcoin), ETH (Ethereum), LTC (Litecoin), XRP (XRP Ledger), TRX (Tron), TON (TON), SOL (Solana), BNB (BNB Smart Chain), AVAX (Avalanche C-Chain) e POL (Polygon). Não há carteiras em BNB, AVAX e POL, então esses códigos só são aceitos onde os fundos passam por uma blockchain, como nas faturas cripto e nos pagamentos cripto com conversão.

A página de cada método mostra exatamente quais códigos cada campo aceita.

Alguns ativos, como XRP e TON, precisam de destination tag ou memo:

  • Em um pagamento cripto, envie-o em address.memo, junto ao endereço do destinatário em address.address.
  • Uma fatura cripto o retorna em destinationTag. Mostre-o ao cliente junto ao endereço.

IDs de carteira​

Requisições que enviam fundos da sua conta usam o ID da carteira de origem, por exemplo srcWalletId. O ID da carteira é o número da carteira: o código da moeda seguido de 12 dígitos, por exemplo USD123456789012. Obtenha os IDs das carteiras com Consulta de saldos das carteiras.

GIVE e GET​

Métodos que convertem moeda precisam saber a que lado o valor se refere.

ValorO valor é
GIVEO valor do lado do remetente: o que o cliente envia em uma fatura ou o que você envia em um pagamento.
GETO valor do lado do recebedor: o que é creditado na sua conta em uma fatura ou o que o destinatário recebe em um pagamento.

O campo é transferAction nas faturas cripto e action nos pagamentos. O outro lado do valor é calculado pela taxa de câmbio atual, menos as taxas aplicáveis. Para ver os dois valores antes de criar uma transação, use Verificação de fatura cripto ou Consulta de taxa de câmbio.