Перейти к основному содержимому

Коды валют и суммы

Коды валют​

Фиатные валюты и большинство криптоактивов обозначаются одним кодом, например USD, EUR, BTC, ETH или TON.

Стейблкоин существует в нескольких сетях, поэтому его код зависит от того, к чему относится поле:

  • Средства, которые идут через блокчейн. Передавайте стейблкоин с сетью после подчёркивания, например USDT_TRC20 для USDT в сети Tron, чтобы платёж или выплата прошли в нужной сети. Это поля senderCurrency в криптоинвойсах, destCurrency в криптовыплатах, currency и desiredCurrency в методе Получение курса обмена, currency и currencyConverted в методе Получение минимальных лимитов.
  • Ваши кошельки. Используйте тикер без сети: USDT или USDC. У стейблкоина один баланс на все сети, поэтому в srcCurrency и в обеих валютах перевода между кошельками Volet.com сеть не указывается.

Коды стейблкоинов по сетям​

СетьUSDTUSDC
Ethereum (ERC-20)USDT_ERC20USDC_ERC20
BNB Smart Chain (BEP-20)USDT_BEP20USDC_BEP20
Tron (TRC-20)USDT_TRC20Не принимается
SolanaUSDT_SOLUSDC_SOL
TONUSDT_TONНе принимается
PolygonUSDT_POLUSDC_POL
ArbitrumUSDT_ARBUSDC_ARB
OptimismUSDT_OPUSDC_OP
Avalanche C-ChainUSDT_AVAXCUSDC_AVAXC

Другие криптоактивы​

Монеты, которые существуют в одной сети, обозначаются тикером: BTC (Bitcoin), ETH (Ethereum), LTC (Litecoin), XRP (XRP Ledger), TRX (Tron), TON (TON), SOL (Solana), BNB (BNB Smart Chain), AVAX (Avalanche C-Chain) и POL (Polygon). Кошельков в BNB, AVAX и POL нет, поэтому эти коды принимаются только там, где средства идут через блокчейн, например в криптоинвойсах и криптовыплатах с конвертацией.

Какие коды принимает каждое поле, указано на странице метода.

Для некоторых активов, например XRP и TON, нужен тег назначения (destination tag) или memo:

  • В криптовыплате передайте его в address.memo, рядом с адресом получателя в address.address.
  • Криптоинвойс возвращает его в destinationTag. Покажите его клиенту рядом с адресом.

ID кошельков​

Запросы, которые отправляют средства с вашего аккаунта, используют ID кошелька-источника, например srcWalletId. ID кошелька — это номер кошелька: код валюты и 12 цифр, например USD123456789012. ID кошельков можно получить методом Получение балансов кошельков.

GIVE и GET​

Методам, которые конвертируют валюту, нужно знать, к какой стороне относится сумма.

ЗначениеСумма —
GIVEсумма на стороне отправителя: сколько отправляет клиент по инвойсу или сколько отправляете вы при выплате.
GETсумма на стороне получателя: сколько зачисляется на ваш аккаунт по инвойсу или сколько получает получатель выплаты.

Поле называется transferAction в криптоинвойсах и action в выплатах. Другая сторона суммы рассчитывается по текущему курсу за вычетом применимых комиссий. Чтобы увидеть обе суммы до создания транзакции, используйте методы Проверка криптоинвойса или Получение курса обмена.