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

API

На странице

Поддерживаемые валюты

Проверьте, в каких из 13 блокчейн-сетей доступны USDT, USDC, USD1, DAI и обеспеченный золотом XAUT, прежде чем включать активы.

Параметры запроса

currency — единое публичное поле API. В нём может быть код фиатной валюты, например USD, или символ криптоактива, например USDT.

Для фиатного инвойса отправляйте currency без network:

{
  "amount": "100.00",
  "currency": "USD"
}

Для прямого крипто-инвойса и вывода средств отправляйте currency вместе с network:

{
  "amount": "50.00",
  "currency": "USDT",
  "network": "TRC20"
}

Вывод средств работает только с криптоактивами и ограничен USDT и USDC — каждый на любой сети, где этот токен выпущен (см. матрицу ниже).

network — при создании прямого крипто-инвойса или вывода укажите currency вместе с network:

{
  "currency": "USDT",
  "network": "TRC20"
}

Допустимые значения network: TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, TON, AVAX, SOL, NEAR, SUI, PLASMA.

Модель ценообразования

При фиатной цене (currency = USD/EUR/…) Paymos фиксирует курс обмена в момент, когда клиент выбирает токен и сеть на странице оплаты. Клиент платит эквивалент в стейблкоине. Зафиксированный курс возвращается на инвойсе как payment.exchange_rate.

При прямой крипто-цене (currency = USDT/USDC/… с network) клиент платит точную сумму в этом токене на этой сети. Обмен валют не задействован.

Расчёт всегда в том стейблкоине, которым заплатил клиент. Paymos никогда не конвертирует крипту в фиат: вы выводите тот же стейблкоин на свой кошелёк, а конвертацию в фиат, если она нужна, делаете сами — вне Paymos.

Фиатные валюты

Группа Коды
Основные USD, EUR, GBP, CHF, CAD, AUD, NZD, JPY
Европа PLN, CZK, DKK, SEK, NOK, HUF
СНГ RUB, UAH, GEL
Азия CNY, HKD, KRW, INR, IDR, MYR, PHP, THB, VND, PKR, SGD, BDT, LKR, MMK, TWD
Америка BRL, MXN, ARS, CLP, BMD, VEF
Ближний Восток / Африка TRY, AED, ILS, NGN, ZAR, BHD, KWD, SAR

Токены

Токен Символ Сети
Tether USD USDT TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, TON, AVAX, SOL, NEAR, PLASMA
USD Coin USDC ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, AVAX, SOL, NEAR, SUI
Tether Gold XAUT ERC20
Dai DAI ERC20
World Liberty USD USD1 ERC20, SOL

Сети

Paymos дожидается финальности, соответствующей сети, и требуемая глубина зависит от суммы платежа в USD — мелкие платежи подтверждаются быстро, крупные ждут дольше. Сети с быстрой нативной финальностью (BNB Smart Chain и Polygon) используют тег finalized вместо счётчика блоков. Точные глубины подтверждений — операционные и могут меняться без предупреждения; значение, применённое к платежу, возвращается как required_confirmations в API-ответе (null для сетей с нативной финальностью).

Сеть Код Тип
Tron TRC20 L1
Ethereum ERC20 L1
BNB Smart Chain BEP20 L1
Polygon PoS POLYGON L1
Arbitrum One ARBITRUM L2
Optimism OPTIMISM L2
Base BASE L2
TON TON L1
Avalanche AVAX L1
Solana SOL L1
NEAR NEAR L1
Sui SUI L1
Plasma PLASMA L1

Матрица токен-сеть

Не каждый токен доступен в каждой сети. Таблица показывает все допустимые комбинации:

TRC20 ERC20 BEP20 POLYGON ARBITRUM OPTIMISM BASE TON AVAX SOL NEAR SUI PLASMA
USDT Да Да Да Да Да Да -- Да Да Да Да -- Да
USDC -- Да Да Да Да Да Да -- Да Да Да Да --
XAUT -- Да -- -- -- -- -- -- -- -- -- -- --
DAI -- Да -- -- -- -- -- -- -- -- -- -- --
USD1 -- Да -- -- -- -- -- -- -- Да -- -- --