Автоматизация валют с разными сетями

Данная инструкция полезна только для случаев, когда вы подключаете Tether, USDCoin.

При работе с криптовалютами один и тот же актив может существовать в разных сетях.

Например, USDT может работать в сетях:

• TRC20;
• ERC20;
• BEP20;
• TON;
• Polygon;
• Solana.

Для клиента это выглядит как одна валюта — USDT. Но для платёжного сервиса это разные сети, разные адреса, разные правила проверки транзакций и разные способы выплаты.

Чтобы система правильно понимала, в какой сети принимать или отправлять средства, используется код сети.

Что такое код сети

Код сети — это значение, которое система передаёт мерчанту или модулю выплаты.

Например:

TRC20
ERC20
BEP20
TON

Некоторые платёжные сервисы могут использовать свои названия:

TRON
USDTTRC20
usdt-tron
TRX

Поэтому код сети нельзя указывать наугад. Его нужно брать из документации платёжного сервиса или уточнять у его поддержки.

Зачем указывать сеть

Сеть нужна, чтобы платёжный сервис понял, где именно нужно принимать или отправлять средства.

Если сеть указана неправильно, могут возникнуть серьёзные проблемы:

• клиент получит адрес не той сети;
• клиент отправит средства в неправильную сеть;
• система не найдёт транзакцию;
• заявка зависнет в ожидании оплаты;
• выплата уйдёт через неправильную сеть;
• платёжный сервис вернёт ошибку;
• оператору придётся разбирать заявку вручную.

Особенно внимательно настраивайте сети для мультисетевых активов:

• USDT;
• USDC;
• ETH;
• токены в сетях TRC20, ERC20, BEP20, TON, Polygon и других.

---

Где настраиваются сети

Сети можно указывать в нескольких местах. Это сделано для гибкости: иногда валюта всегда работает в одной сети, а иногда сеть зависит от конкретного направления обмена или платёжного провайдера.

1

Сеть для приёма средств

Используется для мерчантов, которые принимают оплату от клиента.

Откройте: «Основное» — «Валюты» — выберите валюту — «Автоматизация» — «Мерчанты»

Здесь можно указать, через какую сеть мерчант должен принимать оплату по выбранной валюте.

Пример:

USDT — TRC20

Это означает, что при оплате через выбранный мерчант система будет передавать код сети TRC20.

2

Сеть для выплат

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

Откройте:

«Основное» — «Валюты» — выберите валюту — «Автоматизация» — «Выплаты»

Здесь можно указать, через какую сеть система должна отправлять средства клиенту.

Пример:

USDT — ERC20

Это означает, что при выплате через выбранный модуль система будет использовать сеть ERC20.

3

Сеть в правилах мерчантов

Используется, если сеть приёма должна зависеть от конкретного направления обмена.

Откройте: «Основное» — «Направление обмена» — «Правила мерчантов»

Пример:

Направление	Сеть приёма
BTC — USDT	TRC20
ETH — USDT	ERC20
RUB — USDT	BEP20

В этом случае сеть задаётся не просто для валюты USDT, а отдельно для нужного направления.

4

Сеть в правилах выплат

Используется, если сеть выплаты должна зависеть от конкретного направления обмена.

Откройте: «Основное» — «Направление обмена» — «Правила выплат»

Пример:

Направление	Сеть выплаты
BTC — USDT	TRC20
ETH — USDT	ERC20
RUB — USDT	BEP20

Если для направления создано правило выплаты с указанной сетью, система будет использовать именно эту сеть.

5

Сеть в опциях мерчанта или выплаты

Некоторые платёжные модули имеют отдельное поле во вкладке «Опции».

Оно может называться так:

• Код сети;
• Код валюты;
• Код валюты/сети;
• Network code.

Эта настройка относится ко всему конкретному мерчанту или модулю выплаты.

Используйте её, если провайдер всегда требует один конкретный код.

Пример:

USDTTRC20

или:

TRC20

---

Настройка сети на уровне валюты

Настройка на уровне валюты подходит, если выбранная валюта почти всегда работает в одной сети.

Например:

USDT всегда принимается в TRC20
USDT всегда выплачивается в TRC20

В таком случае достаточно настроить сеть внутри самой валюты.

1

Сеть для мерчантов

Откройте: «Основное» — «Валюты» — выберите валюту — «Автоматизация» — «Мерчанты»

В блоке настройки мерчантов сначала выберите нужные мерчанты, затем откройте вкладку «Сети».

Здесь можно указать:

• сеть по умолчанию;
• индивидуальную сеть для конкретного мерчанта.

2

Сеть по умолчанию для мерчантов

Это общий код сети для всех выбранных мерчантов.

Пример:

TRC20

Если у конкретного мерчанта не указана отдельная сеть, система будет использовать сеть по умолчанию.

3

Индивидуальная сеть мерчанта

Если один мерчант требует один код, а другой — другой, укажите сеть отдельно для каждого.

Пример:

Мерчант	Код сети
Мерчант 1	TRC20
Мерчант 2	USDTTRC20
Мерчант 3	TRON

Индивидуальная настройка имеет приоритет над сетью по умолчанию.

4

Сеть для выплат

Откройте: «Основное» — «Валюты» — выберите валюту — «Автоматизация» — «Выплаты»

Здесь работает такая же логика:

• можно указать сеть по умолчанию для выплат;
• можно указать отдельную сеть для конкретного модуля выплаты.

Пример:

Выплата	Код сети
Выплата 1	TRC20
Выплата 2	ERC20

---

Приоритет выбора сети

Если сеть указана в нескольких местах, система выбирает её по приоритету.

1

Приоритет для приёма средств

При приёме оплаты через мерчант система использует сеть в таком порядке:

Приоритет	Откуда берётся сеть
1	Правило мерчанта направления
2	Опции самого мерчанта
3	Индивидуальная сеть мерчанта в валюте
4	Сеть по умолчанию для мерчантов в валюте
5	Код валюты, если отдельная сеть не указана

Самый высокий приоритет имеет правило направления.

2

Приоритет для выплат

При отправке средств клиенту система использует сеть в таком порядке:

Приоритет	Откуда берётся сеть
1	Правило выплаты направления
2	Опции самой выплаты
3	Индивидуальная сеть выплаты в валюте
4	Сеть по умолчанию для выплат в валюте
5	Код валюты, если отдельная сеть не указана

---

Когда использовать разные способы настройки

1

Настройка в валюте

Используйте, если валюта работает в одной сети.

Пример:

USDT только TRC20

Это самый простой вариант.

2

Правила направлений

Используйте, если сеть зависит от направления обмена.

Пример:

BTC — USDT TRC20
ETH — USDT ERC20
RUB — USDT BEP20

Такой вариант нужен, когда одной общей настройки валюты недостаточно

3

Опции мерчанта или выплаты

Используйте, если конкретный провайдер требует особый код сети или валюты.

Пример:

TRC20
USDTTRC20
usdt-tron

Эта настройка удобна, когда код зависит не от направления, а от требований самого API.

---

Примеры настройки

1

USDT работает только в TRC20

Задача: принимать и выплачивать USDT только через TRC20.

Настройка:

1. Откройте валюту USDT.
2. Перейдите в «Автоматизация» — «Мерчанты».
3. Выберите нужные мерчанты.
4. Во вкладке «Сети» укажите:

TRC20

1. Перейдите в «Автоматизация» — «Выплаты».
2. Выберите нужные выплаты.
3. Во вкладке «Сети» также укажите:

TRC20

Такой вариант подходит, если весь USDT в проекте работает только в одной сети.

2

Разные сети по направлениям

Задача: в одном направлении клиент получает USDT TRC20, а в другом — USDT ERC20.

Настройка:

1. Откройте «Основное» — «Направление обмена» — «Правила выплат».
2. Создайте правило для первого направления.
3. Выберите нужный модуль выплаты.
4. В поле «Сеть» укажите:

TRC20

1. Создайте правило для второго направления.
2. В поле «Сеть» укажите:

ERC20

Теперь система будет выбирать сеть по конкретному направлению.

3

Разные провайдеры требуют разные коды

Задача: два провайдера работают с USDT TRC20, но требуют разные значения.

Пример:

Провайдер	Ожидаемый код
Провайдер 1	TRC20
Провайдер 2	USDTTRC20

Настройка:

1. Откройте валюту USDT.
2. Перейдите в «Автоматизация» — «Мерчанты» или «Выплаты».
3. Выберите оба модуля.
4. Во вкладке «Сети» укажите индивидуальный код для каждого.

---

Что проверить перед запуском

Перед использованием на реальных заявках проверьте:

• правильно ли выбран мерчант или модуль выплаты;
• включён ли выбранный модуль;
• указана ли сеть там, где она обязательна;
• соответствует ли код сети требованиям провайдера;
• не перепутаны ли сети приёма и выплаты;
• нет ли конфликтов между настройкой валюты и правилом направления;
• выполнена ли тестовая заявка на небольшую сумму.

Частые ошибки

Сеть указана не там

Например, настроили сеть для выплаты, но забыли указать сеть для мерчанта. В результате приём оплаты может работать неправильно.

Используется неправильный код

Например, администратор указал:

Tron

а провайдер ожидает:

TRC20

Всегда используйте код из документации конкретного провайдера.

Одна валюта используется в разных сетях, но настроена только в валюте

Если USDT используется в TRC20 и ERC20, общей настройки на уровне валюты может быть недостаточно.

В таком случае используйте правила направлений.

Сеть задана в опциях модуля и забыта

Если в опциях мерчанта или выплаты указан код сети, он может влиять на все направления, где используется этот модуль.

Если нужно разное поведение по направлениям, используйте правила направлений.

Рекомендации

Если валюта работает только в одной сети, задайте сеть на уровне валюты.

Если сеть зависит от направления, используйте правила мерчантов или правила выплат.

Если провайдер требует особый формат кода, укажите его в опциях конкретного модуля.

Для всех мультисетевых активов обязательно выполняйте тестовую заявку перед запуском на реальные суммы.

Рекомендуемые значения для названий сетей

WestWallet

• Tether TRC-20 — USDTTRC
• Tether BEP-20 — USDTBEP
• USD Coin TRC-20 — USDCTRC

А для остальных случае, оставьте поле "Название сети" пустым

WhiteBit

Rapira

Heleket

---

Коротко

Код сети помогает системе понять, через какую blockchain-сеть принимать или отправлять средства.

Для простых случаев сеть можно настроить на уровне валюты. Для сложных направлений используйте правила мерчантов и выплат. Если провайдер требует собственный формат кода, укажите его в опциях конкретного модуля.