Направления
Модуль Направления обмена
Перед прочтением в обязательном порядке ознакомьтесь с документацией раздела Котировки а также разделом Валюты.
Функционал «Направления» (Общие → Направления) отвечает за настройку всех доступных на сайте маршрутов обмена валют. Именно здесь формируется связка «из какой валюты → в какую валюту», устанавливаются базовые ограничения и задаются финансовые параметры, влияющие на курс, прибыль и отображение направлений на сайте и в мониторингах (например, BestChange).
Все созданные направления отображаются в виде таблицы с возможностью сортировки и поиска по параметрам. Это позволяет удобно управлять большим количеством направлений, быстро находить нужное и редактировать его.
📋 Поля в таблице направлений
# (ID) – уникальный числовой идентификатор направления, который генерируется автоматически. Используется для поиска и внутренних связей в системе.
ID с – код (ID) валюты, которую пользователь отдает.
ID до – код (ID) валюты, которую пользователь получает.
Расчетный мин. – системное минимальное значение, которое определяется из настроек валюты.
Мин. – минимальная сумма обмена для этого направления. Если указанная минимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.
Макс. – максимальная сумма обмена. Если указанная максимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.
Мерчант – провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если используется статический кошелек, здесь будет указан соответствующий вариант.
Котировка – базовая формула или источник курса, который используется для расчёта обменного значения.
Курс – итоговый курс, который видит клиент на сайте и который экспортируется в мониторинги (например, BestChange).
Желаемый курс – ручная настройка курса, позволяющая фиксировать определённое значение независимо от котировок.
Процент – коэффициент, который умножается на курс из котировок. Используется для формирования финального курса, отображаемого пользователю.
Приоритет – определяет порядок отображения направления в списках на сайте. Чем меньше число, тем выше позиция.
Процент прибыли (Profit percent) – маржинальность обменника по данному направлению. Это ключевой параметр для финансовой аналитики, экспорта заявок, а также для расчёта вознаграждения рефералам, если они участвуют в сделке.
Проверка пользователя – если опция активна, пользователь должен пройти верификацию (KYC) для проведения обмена в этом направлении.
Массовое редактирование – включает возможность редактировать это направление в групповых операциях. Удобно, когда нужно обновить сразу несколько направлений.
Отключить автопродажу – позволяет выключить функцию автоматической продажи монет для конкретного направления. Если опция активна – автопродажа не выполняется.
Автогенерировано – системная отметка, указывающая, создано ли направление автоматически при добавлении новых валют.
Действия – набор инструментов для редактирования, дублирования или удаления конкретного направления. Используя поле с действиями, вы можете скопировать направление, создавая его дубликат, удалить направление или отредактировать его, также,
Эти поля вы можете сортировать как вам удобно, зажав название соответствующего поля и перетаскивая его в левую или правую сторону. Также вы можете настроить отображение полей в верхнем правом меню, чтобы убрать ненужные, по вашему мнению, информационные поля.
Также, есть возможность копировать направления обмена - как по отдельности, так и массово.
⚙️ Как работает
В списке направлений администратор отмечает нужные направления галочками.
После выбора появляется меню «Действия» с опциями:
✅ Включить все
🚫 Отключить все
📋 Копировать направления
🗑 Удалить направления
При выборе «Копировать направления» открывается окно, где нужно выбрать:
копировать направления в валюту «Отдаю»,
или в валюту «Получаю».
После подтверждения отображается окно Результат копирования, в котором:
раздел Результат копирования — список успешно скопированных направлений;
раздел Уже существует — направления, которые не были скопированы, так как уже существуют.
🔎 Фильтрация и поиск
В верхней части раздела доступен расширенный фильтр. Он позволяет быстро найти направление по следующим параметрам, это значительно упрощает работу при большом количестве направлений. Также, на странице с общим списком направлений есть возможность управлять сортированием направлений от старых к новым, или наоборот
➕ Добавление нового направления
Нажмите кнопку «+ Добавить» и заполните форму:
ID из – выберите валюту, которую пользователь будет отдавать;
ID в – выберите валюту, которую пользователь будет получать;
Котировка – задайте источник курса созданный вами ранее в котировках.
Процент – установите наценку/скидку относительно базовой котировочной цены, он определяет насколько от точного курса у вас будет отклонение для отображения на сайте. Например, если курс по расчёту выйдет x, он будет умножаться на заданный вами процент, то есть x*0.998, например;
Приоритет – определите место направления в списках (по умолчанию можно ставить 1, 5, 10);
Проверка пользователя – активируйте опцию при необходимости принимать заявки только от верифицированых пользователей;
Точность «отдаю/получаю» – количество знаков после запятой, такие же
Min. / Max. – минимальная и максимальная сумма обмена по направлению;
Процент прибыли – установите маржинальность.
Мерчант - провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если Вы желаете использовать статический кошелек, указывайте соответствующий вариант. Если Вы желаете использовать мерчант установленный в создании валюты, тогда можете оставлять это поле пустым
В настройках направлений обмена появился новый раздел — Не виден в публичном экспортном файле с: Не виден в публичном экспортном файле до:, который позволяет гибко управлять видимостью направлений в публичных и внутренних экспортных файлах.
Как это работает:
В указанный промежуток времени направление будет скрыто из публичного экспортного файла. Это удобно, если вы хотите временно приостановить отображение конкретных направлений на сторонних агрегаторах (BestChange и т.п.), не удаляя их из системы.
В то же время, в админ-панели теперь можно указать отдельную ссылку для внутреннего экспортного файла, где такие направления всегда будут отображаться, независимо от ограничений по времени. Это позволяет сохранять полный список направлений для внутреннего мониторинга и аналитики, даже если часть из них скрыта публично.
Пример использования:
Вы можете настроить, чтобы определённые направления (например, редкие валютные пары или тестовые) не отображались на публичных площадках в ночное время или во время технических работ, но при этом оставались доступными в вашем внутреннем экспорте для контроля.
⚙️ Дополнительные параметры
Массовое редактирование позволяет одновременно обновлять несколько направлений, например, для изменения курсов или процентов. Рекомендуем ползунок поле включённым.
Также, можете выбрать Принудительное автоматическое чтобы включить отображение направления как автоматического в файле экспорта.
Включено включает или отключает отображение направления на сайте
Расширенные настройки: Секция "Города" Эта секция позволяет настроить географические коэффициенты для городов.
Город: Название города.
Коэффициент: Коэффициент, на который будет умножен курс для пользователей из этого города (например, 1.01 для увеличения на 1%).
Минимальная сумма: Минимальная сумма обмена для конкретного города.
Расширенные настройки: Секция "Автовыплаты" Эта секция позволяет подключить модуль автоплатежей для этого направления.
Автовыплаты: Выберите из выпадающего списка активный модуль автовыплат, который будет обрабатывать транзакции (если модуль подключен) могут быть привязаны к направлениям. В этом случае система сама осуществляет переводы клиентам в выбранной валюте.
Минимальная сумма: Минимальная сумма для срабатывания автовыплаты.
Максимальная сумма: Максимальная сумма для автовыплаты.
После заполнения всех необходимых полей нажмите кнопку «Сохранить». Направление будет добавлено в общий список и, в зависимости от статуса, станет доступно для пользователей. 📌 Таким образом, модуль «Направления» является базовым инструментом настройки работы обменника. Он позволяет управлять полным жизненным циклом направлений: от создания до редактирования параметров курсов, ограничений, прибыльности и контроля верификаций. Возвращаясь к последовательной настройке котировок, валют и направлений о которых идёт речь в соответствующих разделах, уже создав 3 котировки, и создав 3 валюты по предыдущим инструкциями, нам остаётся создать одно или несколько направлений обмена связанных с нашими котировками и валютами. Первым шагом нам необходимо создать направление обмена USDT(trc20) - Privat24 UAH выбрав ID из и ID в, и именно здесь мы укажем нашу котировку которую указывали ранее для направления UAH, заполнив данные комфортным для нас образом, вы можете сохранить и включить для отображения данное направление
После сохранения направления, в котировках мы сможем взять новый источник курса, а именно наш сайт. Что это значит? Что теперь, после того как мы добавили направление для обмена, мы можем использовать его для расчётов формул как USDTTRC20_P24UAH, введя эту команду вы увидите новое, непривычное для Вас всплывающее окно с названием Вашего сайта в начале формулы, и эту котировку мы можем корректировать в любой момент, чтобы массово влиять на расчётный курс к любой привязанной монете, не только BTC по примеру которого мы следуем.
Теперь, после того как мы создали наше первое направление, нам осталось создать направление которые мы изначально задавали себе как цель, а именно BTC - Privat24 UAH, для этого нужно создать новую котировку, с новым источником на примере из скриншота выше, где у вас появляется новая команда. По остаточному принципу, нам нужно снова создать новое направление обмена, но теперь выбрать направление не USDT(trc20) - Privat24 UAH, а BTC - Privat24 UAH, где зашито будет новая 4я котировка - Whitebit:BTC_USDT*USDTTRC20_P24UAH
Поздравляем, после внесения всех данных у Вас на сайте появится первое направление с двойной формулой расчёта курса, и по такому же принципу вы можете создавать направления и дальше, аналогично работает принцип и при обратном обмене, если вы захотите создать Privat24 UAH - BTC или любой другой аналогичный. В будущем, для изменения курсов в направлении Вы сможете использовать один из методов: 1) редактирование курсов в корне самой котировки 2) внесение "Желаемого курса" в общей таблице направлений, в таком случае система сама будет менять формулы, лишь бы получить желаемый вами курс 3) редактировать процент влияния на курс в общей таблице направлений либо в редактировании конкретного направления
Последнее обновление