# Направления

### **Модуль Направления обмена** <a href="#xdqhz9a3avun" id="xdqhz9a3avun"></a>

**Перед прочтением в обязательном порядке ознакомьтесь с документацией раздела** [**Котировки**](https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/kursy-valyut/kotirovki) **а также разделом** [**Валюты.**](https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/valyuty)

Функционал **«Направления»** (Общие → Направления) отвечает за настройку всех доступных на сайте маршрутов обмена валют. Именно здесь формируется связка «из какой валюты → в какую валюту», устанавливаются базовые ограничения и задаются финансовые параметры, влияющие на курс, прибыль и отображение направлений на сайте и в мониторингах (например, BestChange).

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

### **📋 Поля в таблице направлений** <a href="#id-9lubr2jztyw3" id="id-9lubr2jztyw3"></a>

1. **# (ID)** – уникальный числовой идентификатор направления, который генерируется автоматически. Используется для поиска и внутренних связей в системе.<br>

2. **ID с** – код (ID) валюты, которую пользователь отдает.<br>

3. **ID до** – код (ID) валюты, которую пользователь получает.<br>

4. **Расчетный мин.** – системное минимальное значение, которое определяется из настроек валюты.<br>

5. **Мин.** – минимальная сумма обмена для этого направления. Если указанная минимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.

6. **Макс.** – максимальная сумма обмена. Если указанная максимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.

7. **Мерчант** – провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если используется статический кошелек, здесь будет указан соответствующий вариант.<br>

8. **Котировка** – базовая формула или источник курса, который используется для расчёта обменного значения.<br>

9. **Курс** – итоговый курс, который видит клиент на сайте и который экспортируется в мониторинги (например, BestChange).<br>

10. **Желаемый курс** – ручная настройка курса, позволяющая фиксировать определённое значение независимо от котировок.<br>

11. **Процент** – коэффициент, который умножается на курс из котировок. Используется для формирования финального курса, отображаемого пользователю.<br>

12. **Приоритет** – определяет порядок отображения направления в списках на сайте. Чем меньше число, тем выше позиция.<br>

13. **Процент прибыли (Profit percent)** – маржинальность обменника по данному направлению. Это ключевой параметр для финансовой аналитики, экспорта заявок, а также для расчёта вознаграждения рефералам, если они участвуют в сделке.<br>

14. **Проверка пользователя** – если опция активна, пользователь должен пройти верификацию (KYC) для проведения обмена в этом направлении.<br>

15. **Массовое редактирование** – включает возможность редактировать это направление в групповых операциях. Удобно, когда нужно обновить сразу несколько направлений.<br>

16. **Отключить автопродажу** – позволяет выключить функцию автоматической продажи монет для конкретного направления. Если опция активна – автопродажа не выполняется.<br>

17. **Автогенерировано** – системная отметка, указывающая, создано ли направление автоматически при добавлении новых валют.<br>

18. **Действия** – набор инструментов для редактирования, дублирования или удаления конкретного направления. Используя поле с действиями, вы можете скопировать направление, создавая его дубликат, удалить направление или отредактировать его, также,&#x20;

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

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2Fq0ZfLmhpWFsUeFxDR27I%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-03%20%D0%BE%2016.42.42.png?alt=media&#x26;token=9406cb2c-387c-4119-bcbb-4d1310afb652" alt="" width="363"><figcaption></figcaption></figure>

Также, есть возможность **копировать направления обмена** - как по отдельности, так и **массово**.

#### ⚙️ Как работает

1. В списке направлений администратор отмечает нужные направления галочками.
2. После выбора появляется меню **«Действия»** с опциями:
   * ✅ Включить все
   * 🚫 Отключить все
   * 📋 **Копировать направления**
   * 🗑 Удалить направления
3. При выборе **«Копировать направления»** открывается окно, где нужно выбрать:
   * копировать направления в валюту **«Отдаю»**,
   * или в валюту **«Получаю»**.
4. После подтверждения отображается окно **Результат копирования**, в котором:
   * раздел **Результат копирования** — список успешно скопированных направлений;
   * раздел **Уже существует** — направления, которые не были скопированы, так как уже существуют.

### **🔎 Фильтрация и поиск** <a href="#sdoegkfwnhjl" id="sdoegkfwnhjl"></a>

В верхней части раздела доступен расширенный фильтр. Он позволяет быстро найти направление по следующим параметрам, это значительно упрощает работу при большом количестве направлений. Также, на странице с общим списком направлений есть возможность управлять сортированием направлений от старых к новым, или наоборот<br>

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FnjvjFBZKt9o660wYoAHG%2Fimage.png?alt=media&#x26;token=70cd5b6b-e390-47c9-8c27-dbf4388fd647" alt="" width="225"><figcaption></figcaption></figure>

### **➕ Добавление нового направления** <a href="#id-76z3o77keycm" id="id-76z3o77keycm"></a>

Нажмите кнопку «+ Добавить» и заполните форму:

* **ID из** – выберите валюту, которую пользователь будет отдавать;
* **ID в** – выберите валюту, которую пользователь будет получать;
* **Котировка** – задайте источник курса созданный вами ранее в котировках.
* **Процент** – установите наценку/скидку относительно базовой котировочной цены, он определяет насколько от точного курса у вас будет отклонение для отображения на сайте. Например, если курс по расчёту выйдет x, он будет умножаться на заданный вами процент, то есть x\*0.998, например;
* **Приоритет** – определите место направления в списках (по умолчанию можно ставить 1, 5, 10);
* **Проверка пользователя** – активируйте опцию при необходимости принимать заявки только от верифицированых пользователей;
* **Точность «отдаю/получаю»** – количество знаков после запятой, такие же&#x20;
* **Min. / Max.** – минимальная и максимальная сумма обмена по направлению;
* **Процент прибыли** – установите маржинальность.
* **Мерчант** - провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если Вы желаете использовать статический кошелек, указывайте соответствующий вариант. Если Вы желаете использовать мерчант установленный в создании валюты, тогда можете оставлять это поле пустым

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2F8ejMLNIgoWQhS5ZlZRzL%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-17%20%D0%BE%2010.25.21.png?alt=media&#x26;token=db70b5ab-09a7-49c2-8acc-dc82e839ecc2" alt=""><figcaption></figcaption></figure>

В настройках направлений обмена появился новый раздел — **Не виден в публичном экспортном файле с:** **Не виден в публичном экспортном файле до:**, который позволяет гибко управлять видимостью направлений в публичных и внутренних экспортных файлах.

**Как это работает:**

* В указанный промежуток времени направление **будет скрыто из публичного экспортного файла**.\
  Это удобно, если вы хотите временно приостановить отображение конкретных направлений на сторонних агрегаторах (BestChange и т.п.), не удаляя их из системы.
* В то же время, в админ-панели теперь можно **указать отдельную ссылку для внутреннего экспортного файла**, где такие направления **всегда будут отображаться**, независимо от ограничений по времени.\
  Это позволяет сохранять полный список направлений для внутреннего мониторинга и аналитики, даже если часть из них скрыта публично.

**Пример использования:**

Вы можете настроить, чтобы определённые направления (например, редкие валютные пары или тестовые) не отображались на публичных площадках в ночное время или во время технических работ, но при этом оставались доступными в вашем внутреннем экспорте для контроля.

### **⚙️ Дополнительные параметры** <a href="#lj8f3f8x0btl" id="lj8f3f8x0btl"></a>

* **Массовое редактирование** позволяет одновременно обновлять несколько направлений, например, для изменения курсов или процентов. Рекомендуем ползунок поле включённым.
* Также, можете выбрать **Принудительное автоматическое** чтобы включить отображение направления как автоматического в файле экспорта.
* **Включено** включает или отключает отображение направления на сайте

Расширенные настройки: Секция "Города"\
Эта секция позволяет настроить географические коэффициенты для городов.

* Город: Название города.
* Коэффициент: Коэффициент, на который будет умножен курс для пользователей из этого города (например, 1.01 для увеличения на 1%).
* Минимальная сумма: Минимальная сумма обмена для конкретного города.

Расширенные настройки: Секция "Автовыплаты" \
Эта секция позволяет подключить модуль автоплатежей для этого направления.

* Автовыплаты: Выберите из выпадающего списка активный модуль автовыплат, который будет обрабатывать транзакции (если модуль подключен) могут быть привязаны к направлениям. В этом случае система сама осуществляет переводы клиентам в выбранной валюте.&#x20;
* Минимальная сумма: Минимальная сумма для срабатывания автовыплаты.
* Максимальная сумма: Максимальная сумма для автовыплаты.

\
После заполнения всех необходимых полей нажмите кнопку «Сохранить». Направление будет добавлено в общий список и, в зависимости от статуса, станет доступно для пользователей.\
📌 Таким образом, модуль «Направления» является базовым инструментом настройки работы обменника. Он позволяет управлять полным жизненным циклом направлений: от создания до редактирования параметров курсов, ограничений, прибыльности и контроля верификаций.\
\
\
Возвращаясь к последовательной настройке котировок, валют и направлений о которых идёт речь в соответствующих разделах, уже создав 3 котировки, и создав 3 валюты по предыдущим инструкциями, нам остаётся создать одно или несколько направлений обмена связанных с нашими котировками и валютами.\
\
Первым шагом нам необходимо создать направление обмена USDT(trc20) - Privat24 UAH выбрав ID из и ID в, и именно здесь мы укажем нашу котировку которую указывали ранее для направления UAH, заполнив данные комфортным для нас образом, вы можете сохранить и включить для отображения данное направление

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2FUXp45WloYhoL3150GBJi%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-24%20%D0%BE%2011.08.24.png?alt=media&#x26;token=1e648cfb-85d0-47b5-a9d2-9bedcaa56aa7" alt=""><figcaption></figcaption></figure>

После сохранения направления, в котировках мы сможем взять новый источник курса, а именно наш сайт. Что это значит? Что теперь, после того как мы добавили направление для обмена, мы можем использовать его для расчётов формул как USDTTRC20\_P24UAH, введя эту команду вы увидите новое, непривычное для Вас всплывающее окно с названием Вашего сайта в начале формулы, и эту котировку мы можем корректировать в любой момент, чтобы массово влиять на расчётный курс к любой привязанной монете, не только BTC по примеру которого мы следуем.

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2F4pBH1VLTra9A2R1Kltlg%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-24%20%D0%BE%2011.12.50.png?alt=media&#x26;token=36f5902b-761d-485a-97eb-5684d5a85839" alt="" width="563"><figcaption></figcaption></figure>

\
Теперь, после того как мы создали наше первое направление, нам осталось создать направление которые мы изначально задавали себе как цель, а именно BTC - Privat24 UAH, для этого нужно создать новую котировку, с новым источником на примере из скриншота выше, где у вас появляется новая команда.\
\
По остаточному принципу, нам нужно снова создать новое направление обмена, но теперь выбрать направление не USDT(trc20) - Privat24 UAH,  а BTC - Privat24 UAH, где зашито будет новая 4я котировка - **Whitebit:BTC\_USDT\*USDTTRC20\_P24UAH**

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2Fanj1oxoZCSe8wSirdYKP%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-09-24%20%D0%BE%2011.19.44.png?alt=media&#x26;token=aab17018-cd4a-46b3-8c11-496d8430604f" alt=""><figcaption></figcaption></figure>

Поздравляем, после внесения всех данных у Вас на сайте появится первое направление с двойной формулой расчёта курса, и по такому же принципу вы можете создавать направления и дальше, аналогично работает принцип и при обратном обмене, если вы захотите создать Privat24 UAH - BTC или любой другой аналогичный.\
\
В будущем, для изменения курсов в направлении Вы сможете использовать один из методов:\
1\) редактирование курсов в корне самой котировки\
2\) внесение "Желаемого курса" в общей таблице направлений, в таком случае система сама будет менять формулы, лишь бы получить желаемый вами курс\
3\) редактировать процент влияния на курс в общей таблице направлений либо в редактировании конкретного направления