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

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

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

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

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

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

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

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

Вывод работает только с криптоактивами. Вывести можно любой актив, по которому у вас есть баланс. Но матрица ниже — про приём, и сетей вывода меньше: `NEAR` и `SUI` работают только на приём, вывести в них нельзя. Остаются 11 сетей, а внутри них маршрут по-прежнему зависит от актива.

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

```json
{
  "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) как самостоятельные монеты не поддерживаются: принимать можно токенизированный доллар и золото, а не базовые монеты сетей. Какой набор токенов включён в конкретном магазине — настройка проекта, и смотреть её нужно в валютных настройках самого проекта.