На странице
Поддерживаемые валюты
Проверьте, в каких из 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"
}
Вывод работает только с криптоактивами. Вывести можно любой актив, по которому у вас есть баланс. Но матрица ниже — про приём, и сетей вывода меньше: NEAR и SUI работают только на приём, вывести в них нельзя. Остаются 11 сетей, а внутри них маршрут по-прежнему зависит от актива.
network — при создании прямого крипто-инвойса или вывода укажите currency вместе с network:
{
"currency": "USDT",
"network": "TRC20"
}
Допустимые значения network для инвойса: TRC20, ERC20, BEP20, POLYGON, ARBITRUM, OPTIMISM, BASE, TON, AVAX, SOL, NEAR, SUI, PLASMA. Для вывода — тот же список без NEAR и SUI.
Модель ценообразования
При фиатной цене (currency = USD/EUR/…) Paymos фиксирует курс обмена в момент, когда клиент выбирает токен и сеть на странице оплаты. Клиент платит эквивалент в токене. Зафиксированный курс возвращается на инвойсе как payment.exchange_rate.
При прямой крипто-цене (currency = USDT/USDC/… с network) клиент платит точную сумму в этом токене на этой сети. Обмен валют не задействован.
Расчёт всегда в том активе, которым заплатил клиент. Автоматической конвертации в фиат нет: на кошелёк выводится тот же актив, а обмен на фиат, если он нужен, вы делаете сами — вне 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, VES |
| Ближний Восток / Африка | 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 |
Сети
Платёж зачисляется только после финальности, принятой в конкретной сети. Там, где счёт идёт по блокам, требуемая глубина зависит от суммы платежа в USD — небольшие платежи подтверждаются быстро, крупные ждут дольше. Сети с быстрой нативной финальностью — сегодня это BNB Smart Chain, Polygon, Solana, Avalanche и Plasma — используют тег 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 | -- | Да | -- | -- | -- | -- | -- | -- | -- | Да | -- | -- | -- |
Какие криптовалюты можно принимать? Поддерживается ли Bitcoin?
Paymos принимает стейблкоины и золотой токен — USDT, USDC, USD1, DAI и XAUT — на тринадцати сетях; перечень сетей для каждого токена — в матрице выше. Bitcoin (BTC) и Эфир (ETH) как самостоятельные монеты не поддерживаются: принимать можно токенизированный доллар и золото, а не базовые монеты сетей. Какой набор токенов включён в конкретном магазине — настройка проекта, и смотреть её нужно в валютных настройках самого проекта.