Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

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

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

  • TRC20;

  • ERC20;

  • BEP20;

  • TON;

  • Polygon;

  • Solana.

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

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

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

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

Например:

TRC20
ERC20
BEP20
TON

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

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

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

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

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

  • клиент получит адрес не той сети;

  • клиент отправит средства в неправильную сеть;

  • система не найдёт транзакцию;

  • заявка зависнет в ожидании оплаты;

  • выплата уйдёт через неправильную сеть;

  • платёжный сервис вернёт ошибку;

  • оператору придётся разбирать заявку вручную.

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

  • USDT;

  • USDC;

  • ETH;

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

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

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

1

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

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

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

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

Пример:

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

2

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

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

Откройте:

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

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

Пример:

Это означает, что при выплате через выбранный модуль система будет использовать сеть 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.

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

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

Пример:

или:

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

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

Например:

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

1

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

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

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

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

  • сеть по умолчанию;

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

2

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

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

Пример:

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

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

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

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

Пример:

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

2

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

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

Пример:

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

3

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

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

Пример:

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

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

1

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

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

Настройка:

  1. Откройте валюту USDT.

  2. Перейдите в «Автоматизация» — «Мерчанты».

  3. Выберите нужные мерчанты.

  4. Во вкладке «Сети» укажите:

  1. Перейдите в «Автоматизация» — «Выплаты».

  2. Выберите нужные выплаты.

  3. Во вкладке «Сети» также укажите:

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

2

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

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

Настройка:

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

  2. Создайте правило для первого направления.

  3. Выберите нужный модуль выплаты.

  4. В поле «Сеть» укажите:

  1. Создайте правило для второго направления.

  2. В поле «Сеть» укажите:

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

3

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

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

Пример:

Провайдер
Ожидаемый код

Провайдер 1

TRC20

Провайдер 2

USDTTRC20

Настройка:

  1. Откройте валюту USDT.

  2. Перейдите в «Автоматизация» — «Мерчанты» или «Выплаты».

  3. Выберите оба модуля.

  4. Во вкладке «Сети» укажите индивидуальный код для каждого.

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

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

  • правильно ли выбран мерчант или модуль выплаты;

  • включён ли выбранный модуль;

  • указана ли сеть там, где она обязательна;

  • соответствует ли код сети требованиям провайдера;

  • не перепутаны ли сети приёма и выплаты;

  • нет ли конфликтов между настройкой валюты и правилом направления;

  • выполнена ли тестовая заявка на небольшую сумму.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Tether TRC-20 — USDTTRC

  • Tether BEP-20 — USDTBEP

  • USD Coin TRC-20 — USDCTRC

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

  • Tether TRC20 — TRC20

  • Tether ERC20 — ERC20

  • Tether SOL — SOL

  • Tether EOS — EOS

  • USDCoin TRC20 — TRC20

  • USDCoin ERC20 — ERC20

  • USDCoin SOL — SOL

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

  • BTC-Bitcoin — Bitcoin

  • ETH-ERC20 — Ethereum

  • TRX-TRC20 — Tron

  • USDT-TRC20 — Tether TRC20 (сеть Tron)

  • USDT-ERC20 — Tether ERC20 (сеть Ethereum)

  • USDT-BEP20 — Tether BEP20 (сеть Binance Smart Chain)

  • USDC-TRC20 — USDCoin TRC20 (сеть Tron)

  • USDC-ERC20 — USDCoin ERC20 (сеть Ethereum)

  • USDC-BEP20 — USDCoin BEP20 (сеть Binance Smart Chain)

  • BTC-BEP20 — Bitcoin BEP20 (сеть Binance Smart Chain)

  • BNB-BEP20 — Binance Coin

  • LTC-Litecoin — Litecoin

  • DAI-ERC20 — DAI (сеть Ethereum)

  • DAI-BEP20 — DAI (сеть Binance Smart Chain)

https://doc.heleket.com/ru/other/reference

Коротко

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

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

ПредыдущаяСтратегия обработки ошибок мерчантов
СледующаяAML сервисы

Последнее обновление

Это было полезно?