Создание первых направлений обмена
Следующим логическим шагом для наполнения вашего сайта после стартовых настроек админ-панели будет создание направлений обмена. Для того чтобы создать первое направление обмена, необходимо начать с создания котировок, далее - создания валют, и третим шагом необходимо непосредственно создать направление обмена, разберём что есть что, и как эти 3 шага взаимосвязаны между собой.
Создание котировок
Прежде всего разберёмся, что такое котировки? Котировки - это курсы валют, которые ваш сайт использует для расчёта обмена, например 1 BTC = 102000 USDT, 1 USDT = 0.93 EUR и так далее, по сути, это основные данные, на которых строится весь обменный процес, если котировок нет - система не понимает, по какому курсу считать курсы валют. Для создания котировок нам необходимо перейти в главном меню в раздел Курсы валют - Котировки. После покупки лицензии вам будет доступен набор из нескольких стандартных котировок, валют и направлений, дабы вам было не сложно видеть примеры их наполнения для создания собственных.
На скриншоте выше вы можете видеть список из уже созданных котировок на сайте, здесь отображается их ключевые параметры, и отсюда администратор может быстро добавлять, редактировать, активировать или деактивировать любой курс. Уже зная что котировки это курс валют который используется для расчёта курса обмена, логически становится понятно за что отвечают поля на данной страничке. Подробное описание элементов интерфейса:
Кнопка "+ Добавить" в правом верхнем углу:
Основная кнопка действия на этой странице. Нажатие на неё инициирует процесс создания новой котировки, открывая форму для заполнения.
Таблица существующих котировок:
Это ядро страницы. Она предоставляет обзор всех курсов в системе в структурированном виде. Каждая строка — отдельная котировка. Колонки дают следующую информацию:
#: Уникальный числовой идентификатор котировки в базе данных. Критически важен для технической идентификации записи. Сортируются по умолчанию от нового к старому.
Группа: Название группы, к которой привязана данная котировка. Группы служат для логической сортировки курсов (например, "Направления USDT", "Направления BTC", "Фиатные гривневые направления"). Это значительно упрощает поиск нужного курса, когда их очень много. Название группы доступно быстрой фильтрации по группам котировок.
Формула: Самое важное поле. Отображает математическое выражение, с помощью которого рассчитывается конечный курс для данного направления обмена. Это может быть как статическое число (например, 40), так и динамическая формула, состоящая из произведения других котировок (например, Whitebit:BTC_USDT * USDTTRC20_P24UAH). Система автоматически вычисляет эту формулу в реальном времени для конвертации.
Значение: Уже рассчитанный курс по созданной вами формуле, на скриншоте вы можете наблюдать примеры уже рассчитанных значений, важно понимать, что они не есть окончательными, и если в вашей формуле есть волатильные, то есть постоянно меняющие курс монеты или валюты, в системе они также будут обновлять свой курс относительно актуального, поэтому вам не стоит переживать о том, что вы вчера могли создать котировку Bitcoin - USDT по цене 90.000$ за 1 единицу BTC, а сегодня его цена превысила 100.000$ за единицу и вам придётся создавать или обновлять котировку по-новому. Статические котировки будут неизменными в том случае, если вы создадите котировку без формулы, просто со значением, например, “10”.
Действия (Колонка "Операции"):
Иконка "Карандаш" (Редактировать): Нажатие на эту иконку открывает форму редактирования выбранной котировки, где можно изменить все параметры: формулу, группу, статус.
Иконка "Корзина" (Удалить): Удаляет выбранную котировку из системы. Это действие следует выполнять осторожно, поскольку оно может быть необратимым. Система запрашивает подтверждение перед удалением.
Практическое применение: Администратор заходит на эту страницу, чтобы убедиться, что все курсы актуальны. Он может быстро найти котировку по названию группы, проверить её формулу и, при необходимости, выключить её для технического обслуживания или отредактировать, если курс требует корректировки. И так, уже зная обозначения полей котировок, приступим к непосредственному созданию одной из них, разберём весь путь до создания направления обмена на примере нескольких направлений обмена. Для создания котировки нам необходимо сначала создать группу в меню Группы, нажав на кнопку “+Добавить”, мы направимся на страничку, где необходимо заполнить поля с названием нашей группы, и описанием комфортным для нас, и соответствующим данной котировке.
Далее, возвращаясь в раздел Котировки, также жмём “+Добавить”
Форма добавления/редактирования котировки
Попав в соответсвующее меню нам необходимо прописать формулу подходящую под наши требования по созданию, а именно: В первом поле “Формула” мы прописываем первоначальную формулу расчёта, где первое слово всегда означает источник курса, в нашем случае это биржа WhiteBit, это также может быть и другая биржа, например Binance, через двоеточие мы прописываем первую расчётную формулу, а именно курс BTC на стейблкоин USDT - Whitebit:BTC_USDT. После того как система распознает математический расчёт, он будет отображаться в скобках данной котировки.
В случае если бы наше направление обмена было просто BTC на USDT нам было бы достаточно данной котировки, но так как нам необходимо иметь динамичекий расчёт BTC - PrivatBank24 UAH, нам необходимо совешить следующий шаг - создание условий для отображения курса второй половины формулы USDT-PrivatBank24 UAH. Для этого мы можем использовать либо существующий курсы по данной паре обмена из существующих динамических источников (Например Whitebit:USDT_UAH) что мы можем сделать сразу, нажав на кнопку "Выберите расчетную формулу",
либо, создать котировку со статическим значением под конкретную валюту выплаты, и под неё создавать в дальнейшем другие котировки которые всегда в формуле будут завязаны под ваше статическое значение, например - если вы создадите статическую котировку USDT - PrivatBank24 со значением "42", где 42 это единственная ваша статическая котировка, вы сможете завязать эту котировку под все последующие котировки для приёма этой валюты, например: Whitebit:BTC_USDT*(Название вашего сайта)USDT - PrivatBank24, Binance:ETH_USDT*(Название вашего сайта)USDT - PrivatBank24, где в случае изменения курса по которому вы можете совершать обмен, вы можете в ручную проводить изменения только одного значения котировки PrivatBank24, например с 42 на 41.5 или наоборот увеличить курс до 42.5 и ваши расчётные формулы по всем остальным направлениям завязанным под данную, будут также нести незамедлительные изменения в расчётном курсе. 3. И так, для создания статической формулы котировки, нам достаточно по предварительно созданной группе котировок создать новую котировку с удобным статическим значением по отношению к USDT, например 42 в случае UAH, 470 в случае KZT, 0.92 в случае EUR, 1 для создания котировки стабильной валюты для USD либо USDT, 32.5 в случае TRY (цифры есть лишь примерами, и не означают обязательное указание таких же при создании конкретной котировки, это лишь примерные соотношения стабильной монеты к валюте).
Создайте 2 котировки: Одну с формулой "42" и группой "UAH" Вторую с формулой "1" и группой "Stable" для использования котировки при создании валюты в дальнейшем После создания простой формулы, нажимайте опубликовать, чтобы котировка появилась в общем списке Котировок. 4. И так, на данном этапе ознакомления с разделом Котировки у нас должно быть 3 созданные котировку вручную - Whitebit:BTC_USDT, просто статическое значение под нужную нам валюту, в нашем случае просто "42", и значение "1" которое мы будем использовать как котировку при создании валюты USDT(trc20). Следующий шаг если мы желаем иметь формулу расчёта на которую мы всегда сможем влиять - создание условий для отображения котировки следующей части расчётной формулы, а именно USDT_42 (USDT/42). Для этого нам необходимо создать 3 валюты в разделе админ-панели Общие - Валюты. Следуйте инструкции по заполнению полей описаной в разделе для создания следующих монет: BTC, USDT, P24UAH которые будут завязаны в дальнейшем в вашем направлении обмена - https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/valyuty 5. Если Вы уже прошли весь путь следуя инструкции описаной в разделах Валюты и Направления, значит вы снова вернётесь в раздел котировки, и по остаточному принципу, будете создавать новую котировку, где увидите непривычные для вас ранее формулы, а именно *Название Вашего сайта*:USDTTRC20_P24UAH, то есть новую формулу расчёта, которая будет тянуться из созданных вами направлений обмена на сайте, и именно с использованием этой формулы, все ваши направления завязанные под эту формулу можно будет удобно редактировать внося коррективы только в эдиную изначальную котировку для UAH с формулой "42"
В случае, когда требуется простая котировка (например, BTC → USDT), достаточно подключить один парсер.
Однако для более сложных направлений, где нет прямой котировки (например, BTC → UAH), используется формула с операциями умножения или деления:
Система берёт два котирования из разных источников (либо с бирж, либо из внутреннего Self Rate Provider).
Далее они между собой перемножаются или делятся, образуя финальный курс.
Пример:
Парсер №1: BTC_USDT (с Binance или WhiteBit).
Парсер №2: USDT_UAH (с биржи, из курса НБУ или с собственного сайта).
Результат: курс BTC → UAH = BTC/USDT × USDT/UAH.
Таким образом, можно формировать так называемое “дерево зависимых котировок” и в обратном направлении, когда одна котировка базируется на другой.
Создание валют
После того как вы настроили первые котировки и поняли, как работает система расчёта курсов, следующим логическим шагом будет добавление валют. Без них обменник будет пустым: курсы есть, но клиенту просто нечего менять. Поэтому давайте разберёмся, что именно здесь нужно сделать и как правильно заполнить все поля.
Что такое валюта в админ-панели?
Валюта — это конкретный актив, с которым работает ваш обменник: Bitcoin, Ethereum, USDT в разных сетях, гривна, доллар, евро и так далее. Именно через валюты клиенты взаимодействуют с вашим сайтом — они выбирают, что хотят отдать и что получить.
Каждая валюта в системе — это не просто название. За ней скрывается целый набор параметров: код, резерв, минимальные суммы обмена, мерчант (метод приёма), правила для обмена, логотип и даже подсказки для клиентов. Всё это нужно настроить один раз, и дальше система будет использовать валюту в обменах автоматически.
🛠️ Добавляем новую валюту
1. Раздел «Валюты»
В главном меню панели откройте пункт Общие → Валюты.
Здесь вы увидите список уже созданных валют. При покупке лицензии в системе есть несколько готовых примеров, чтобы вам было проще разобраться, как всё устроено, но рекомендуем вам создавать или редактировать валюты под ваши особенности работы.
Интерфейс представлен в виде таблицы со всеми существующими валютами, системой фильтров для быстрого поиска и кнопкой добавления новых активов. Фильтры позволяют быстро найти валюту по её уникальному ID, базовой валюте (например, USDT) или краткому коду (Shorthand), что критически важно при работе с десятками активов.
Данные поля вы можете сортировать как вам угодно, зажав название соответсвующего поля и перетаскивая его в левую или правую сторону. Также, вы можете настроить отображение полей в правом верхнем меню, чтобы убрать ненужные по вашему мнению информационные поля.
Чтобы создать новую валюту, нажмите кнопку “+ Добавить”.
Форма является комплексной и разделена на логические блоки для удобства заполнения. Она содержит все необходимые поля для интеграции валюты в торговый и операционный процесс.
Детальное описание полей и их назначение:
1. Заполнение формы - основная информация:
Перед вами откроется форма, на первый взгляд довольно большая, но на деле всё логично. Рассмотрим основные поля:
Сокращение: Самый важный технический код валюты, согласно стандарта формирования экспортного файла для передачи направлений обмена, поддерживаемого мониторингом обменных пунктов BestChange (например, BTC, LTC, P24UAH). Именно этот код используется для формирования экспортного файла для мониторингов. Ошибка здесь приведёт к неправильному отображению направлений на внешних сервисах.
Экспортное сокращение: Зарезервированное поле. Для корректной работы следует использовать поле Сокращение.
Сумма: Текущий объём валюты, доступный для обменов. Эта цифра отображается пользователям на сайте и в мониторингах. Регулярное обновление резерва — ключ к привлечению клиентов, преимущественно указывают значение несколько больше чем имеется на балансах.
В настройках валют можно задавать минимальные и максимальные суммы заявки. Логика работы такова:
В эквиваленте USDT: Теперь можно указать минимальную сумму не в самой валюте, а в её эквиваленте к USDT. Это удобно, когда монета очень волатильна (например, Bitcoin, Ethereum, Dogecoin): Если задать минималку в DOGE, после роста курса она станет завышенной. Если задать минималку в USDT, она всегда останется актуальной независимо от изменений курса. Минимальные/максимальные сумы обмена (От минимальной суммы, До минимальной суммы, Максимальная сумма) - Поля можно задавать как на уровне валюты, так и на уровне направления обмена. Если значения отличаются, то приоритет всегда имеет направление. Если заполнять данные минимальной суммы обмена только в полях валюты, будет использоваться формула для среднего указанного расчёта где в расчёте принимают участие 3 значения. Рекомендуем использовать один из 2х методов - или указание только минимальной суммы в эквиваленте USD, особенно удобно с волатильной криптовалютой, но также можете и не использовать данное поле, а отталкиваться только от минимальных сум обмена в размере конкретной валюты, либо наоборот, с фиатной валютой поле в эквиваленте USD оставлять пустым, а От минимальной суммы и До минимальной суммы заполнять одинаковыми значениями, например - 10000 Расчётный минимум (фактический) Это итоговое значение, которое система берёт после всех калькуляций и сравнений. То есть учитываются:
Настройки "От минимальной суммы",
Настройки "До минимальной суммы",
Настройки "Минимальная сумма в эквиваленте USD"
и после этого формируется окончательная минималка, которая реально действует при создании заявки.
Пример:
На валюте USDT → минималка $50.
На конкретном направлении USDT → BTC → минималка $100.
Для этого направления учитывается $100.
Точность: поле, которое указывает, какое количество знаков после точки следует учитывать. Например 2 в случае использования USD или других фиатных валют, или 8 в случае использования волатильных монет с высокой стоимостью, таких как BTC, чтобы отображение оплат не ограничивалось только двумя знаками например 0.09 а было 0.09481841.
Подтверждения: количество необходимых подтверждений в сети, чтобы монета засчиталась на счёт. Например, для BTC это может быть 2, для ETH — 12. При создании фиатной валюты - можете оставлять значение "0".
2. Заполнение формы - Другое
Котировки - Поле для выбора соответствующей котировки под валюту. В нашем случае, если мы следуем инструкции из первого шага создания валют - Котировки, нужно создать 3 валюты - BTC, котировку для расчёта гривны, и котировку для USDT(стейблкоина).
Категория - Чтобы навести порядок, валюты можно объединять в категории: криптовалюты, стейблкоины, фиат, наличные. Так вы сможете быстро находить нужный актив даже при большом списке, и такие же категории будут сохранятся для клиентов в общем списке валют при поиске валюты.
Для создания валюты необходимо предварительно создать категорию в разделе Общие - Категории. Перейдя в соответсвующее меню вы также нажимаете “+Добавить” и создаёте название категории и валюту которая будет отображаться в данной категории, которую в любое время можно редактировать. Для удобства, изначально вам достаточно создать пустую категорию без списка валют, и только при создании валют выбирать уже созданные вами категории в соответствующем поле.
Базовая валюта — «главная группа», к которой относится данный актив. Например, все варианты USDT (TRC20, ERC20, BEP20) будут иметь базовую валюту USDT, UAH - соответственно UAH.
Здесь же можно загрузить иконку валюты. Это мелкая деталь, но для пользователей она очень важна — так сайт выглядит понятнее и приятнее, и вам легче ориентироваться даже при использовании админ-панели. Для вашего удобства мы собрали ссылки и файлы с распространёнными иконками валют в разделе "Полезные логотипы".
Максимальный период выплаты в часах - Это лимит времени, в течение которого вы обязуетесь выполнить заявку, если эта валюта будет в поле получения клиентом.
👉 Пример:
Для фиатных валют (UAH, USD, EUR) часто ставят 1-8 часов..
Для криптовалют (BTC, ETH, USDT) обычно достаточно 1–2 часов.
Но всегда ориентируйтесь на конкретно ваши платёжные возможности и способность выполнения заявок.
Показать поле для ввода хеша транзакции - Актуально для криптовалют. Даёт возможность пользователю указать хеш перевода, чтобы подтвердить оплату. Это упрощает проверку администратору, но не переживайте, с настроенными мерчантами приёма валют, хеш транзакции также будет отображаться в деталях заявки, функционал удобен при использовании статических кошельков для приёма средств.
Массовое редактирование - Функция для удобства администратора. Позволяет быстро изменить параметры сразу для нескольких валют. Если данная функция включена, вы в дальнейшем на этой валюте сможете разово совершать различные изменения по валюте в разделе Общие - Массовое редактирование.
👉 Пример: Если нужно одновременно обновить описание валюты для всех криптовалют, или сменить резерв валюты, достаточно сделать это через массовое редактирование впоследствии, через раздел Общие - Массовое редактирование, функционал которого описан в документации.
Проверка реквизитов - это дополнительный механизм безопасности, который обязует клиентов проходить верификацию счёта перед внесением оплаты.
Если параметр активирован, внести такую оплату смогут только залогиненые пользователи которые предварительно прошли верификацию счёта перед внесением оплаты. Преимущественно, данный функционал используется только при приёме фиатных средств, или в системах, где нет автоматической AML/KYC проверки и в паре с обязательной верификацией личности, которую можно настроить непосредственно при создании направления.
3. Заполнение формы - Мерчант
Мерчант - Здесь выбирается провайдер, через которого будут проходить транзакции. Это может быть биржа (например, WhiteBIT), сторонняя платёжная система или просто ваш кошелёк. Для каждой валюты нужно указать Тикер валюты і Сеть мерчанта — это технические параметры, без которых интеграция работать не будет. Например, для USDT TRC20: Ticker = USDT, Network = TRC20. Мерчант — провайдер, через которого будет осуществляться генерация одноразового адреса кошелька для получения оплаты от клиентов. Список доступных мерчантов вы можете увидеть нажав на выпадающий список в соответствующем поле, но будьте внимательны, если вы выбрали один из мерчантов, вам необходимо будет далее его настроить, более подробно о том, как настраивать мерчанты вы можете узнать в разделе технической документации. Также, вы можете использовать статический кошелек, о особенностях настройки которого вы можете узнать в разделе. Обратите внимание! Для направлений, в которых прием валюты осуществляется на автоматический кошелек мерчанта, работает генерация адреса для оплаты криптовалюты и QR-кода для быстрой оплаты заявки.
Если у вас будут возникать сложности при создании валюты, вы также в соседнем окне браузера можете открыть редактирование уже существующей валюты, и по примеру из неё создавать свою, внося уже подходящие для вас и вашей валюты данные.
4. Заполнение формы - Дополнительные поля
Этот раздел позволяет собрать дополнительную информацию от клиента при создании заявки, если этого требует специфика валюты или направления, настроить порядок отображаемых полей и их содержимое, определить обязательные реквизиты.
Отдать - поля по валюте которые клиент должен заполнить, если клиент выбрал ее как валюту для продажи в торговой паре.
Получить - поля по валюте которые клиент должен заполнить, если клиент выбрал ее как валюту для покупки в торговой паре.
По сути, это поля которые клиенту необходимо ввести в валютах которые он отдаёт, либо которые получает, их называют также пользовательские поля. В обеих случаях, у вас есть возможность настроить предварительно эти поля комфортно под ваши условия работы, для этого перейдите в раздел Общие - Пользовательские поля, о том, как их добавлять и как ими управлять, вы можете узнать в технической документации. В этом разделе вы можете добавить необходимое для вас количество отображаемых полей для конкретной валюты.
Пример 1: Для выплаты средств через USDT понадобится поле "Адрес", чтобы понимать по какому адресу клиент желаент получить средства.
Пример 2: Для выплаты средств через Iban понадобится поле "Iban".
Пример 3: Для выплаты UAH нам понадобятся поля "Карта" "Фио", и один из реквизитов, например, "Карта" мы можем ответить как основной реквизит, без указания которого заявка не будет создаваться.
5. Заполнение формы - Локализация контента
Примечание отдаю — общие сведения по валюте, если клиент выбрал ее как валюту для продажи в торговой паре. Например, общая техническая информация
Примечание получаю — общие сведения по валюте, если клиент выбрал ее как валюту для покупки в торговой паре.
Описание мерчанта - текст, который будет писаться клиенту после нажатия клавиши “Перейти к оплате” в самой заявке
Например, после создания валютной пары на главной странице сайта, клиент увидит соответствующие аннотации для каждой из валют в окне создания заявки на соответствующей локализации. Например, в нашем случае, если мы хотим создать направление BTC - Visa/Mastercard UAH, создавая валюту BTC нам будет достаточно ввести информацию только в поле Примечание отдаю, и Описание мерчанты подобным образом:
Описание для валюты Privat24 UAH мы заполняем в поле Примечание (получить)
После чего, на самой страничке создания заявки уже в готовом направлении будет отображаться текст который мы указывали в двух валютах подобным образом:
И так, после того как мы ознакомились со всеми полями заполнения валюты, нам необходимо продолжить логическую цепочку создания направления BTC-Privat24 UAH описаную в котировках. Для начала Вам необходимо создать валюту BTC, уже зная примеры из описания выше, это не должно быть сложным для нас, в поле Котировки в выпадающем меню вы выбираете уже ту котировку, которую создавали предварительно по инструкции.
Заполнив данные пользовательских полей, описаний, иконки под Ваши нужны и специфику работы, следующим логическим шагом будет создание следующих двух валют - USDT(сеть на ваше усмотрение. За стандарт принято считать TRC20) и валюту Privat24 UAH, ниже представлены скриншоты ориентировочного заполнения полей при создании этих валют. Privat24 UAH
Поле мерчант остаётся пустым по причине того, что на данную валюту мы не собираемся совершать приём средств, а лишь его выплату клиенту, но даже если бы мы использовали валюту для приёма, мы бы также могли оставлять это поле пустым, предупредив клиентов о том, что оплату на реквизиты они могут совершать на предоставленные реквизиты в чате/на почте, как это делают очень многие обменные сервисы, это не помешало бы нам в создании валюты, так как поле не является обязательным, оно также будет встречаться вам в следующей инструкции по созданию направлений обмена. USDT TRC20
По привычному принципу мы выбираем котировку созданную вручную предварительно, стабильную "1" для стейблкоинов, а также устанавливаем мерчант, так как в дальнейшем мы также будем использовать эту монету для приёма средств ровно также, как и BTC. Если Вы прошли все логические шаги по созданию первых направлений обмена, а именно создание трёх котировок и трёх валют, вам остаётся последний важный пункт - создание направлений, рекомендуем перейти в следующий раздел для ознакомления с инструкцией по дальнейшим шагам. Итог создание валют - это фундаментальная настройка. Если котировки отвечают за курсы, то валюты - это сами «кассы» и активы, с которыми работает ваш обменник. От них зависит, что именно увидят клиенты, какие суммы будут доступны и как пройдут заявки. Создав и настроив валюты, вы получаете полноценный набор инструментов для будущих направлений обмена.
Создание направлений
Функционал «Направления» (Общие → Направления) отвечает за настройку всех доступных на сайте маршрутов обмена валют. Именно здесь формируется связка «из какой валюты → в какую валюту», устанавливаются базовые ограничения и задаются финансовые параметры, влияющие на курс, прибыль и отображение направлений на сайте и в мониторингах (например, BestChange).
Все созданные направления отображаются в виде таблицы с возможностью сортировки и поиска по параметрам. Это позволяет удобно управлять большим количеством направлений, быстро находить нужное и редактировать его.
📋 Поля в таблице направлений
# (ID) – уникальный числовой идентификатор направления, который генерируется автоматически. Используется для поиска и внутренних связей в системе.
ID с – код (ID) валюты, которую пользователь отдает.
ID до – код (ID) валюты, которую пользователь получает.
Расчетный мин. – системное минимальное значение, которое определяется из настроек валюты.
Мин. – минимальная сумма обмена для этого направления. Если указанная минимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.
Макс. – максимальная сумма обмена. Если указанная максимальная сумма обмена будет отличаться от указанной в настройках монеты, то приоритет будет отдан заданным данным именно в направлении.
Мерчант – провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если используется статический кошелек, здесь будет указан соответствующий вариант.
Котировка – базовая формула или источник курса, который используется для расчёта обменного значения.
Курс – итоговый курс, который видит клиент на сайте и который экспортируется в мониторинги (например, BestChange).
Желаемый курс – ручная настройка курса, позволяющая фиксировать определённое значение независимо от котировок.
Процент – коэффициент, который умножается на курс из котировок. Используется для формирования финального курса, отображаемого пользователю.
Приоритет – определяет порядок отображения направления в списках на сайте. Чем меньше число, тем выше позиция.
Процент прибыли (Profit percent) – маржинальность обменника по данному направлению. Это ключевой параметр для финансовой аналитики, экспорта заявок, а также для расчёта вознаграждения рефералам, если они участвуют в сделке.
Проверка пользователя – если опция активна, пользователь должен пройти верификацию (KYC) для проведения обмена в этом направлении.
Массовое редактирование – включает возможность редактировать это направление в групповых операциях. Удобно, когда нужно обновить сразу несколько направлений.
Отключить автопродажу – позволяет выключить функцию автоматической продажи монет для конкретного направления. Если опция активна – автопродажа не выполняется.
Автогенерировано – системная отметка, указывающая, создано ли направление автоматически при добавлении новых валют.
Действия – набор инструментов для редактирования, дублирования или удаления конкретного направления. Используя поле с действиями, вы можете скопировать направление, создавая его дубликат, удалить направление или отредактировать его
Также Вы всегда можете самостоятельно выбрать желаемые отображаемые поля, воспользовавшись выпадающим окном в правом верхнем углу.
🔎 Фильтрация и поиск
В верхней части раздела доступен расширенный фильтр. Он позволяет быстро найти направление по отдельным параметрам, это значительно упрощает работу при большом количестве направлений.
➕ Добавление нового направления
Нажмите кнопку «+ Добавить» и заполните форму:
ID из – выберите валюту, которую пользователь будет отдавать;
ID в – выберите валюту, которую пользователь будет получать;
Котировка – задайте источник курса созданный вами ранее в котировках.
Процент – установите наценку/скидку относительно базовой котировочной цены, он определяет насколько от точного курса у вас будет отклонение для отображения на сайте. Например, если курс по расчёту выйдет x, он будет умножаться на заданный вами процент, то есть x*0.998, например;
Приоритет – определите место направления в списках (по умолчанию можно ставить 1, 5, 10);
Проверка пользователя – активируйте опцию при необходимости принимать заявки только от верифицированых пользователей;
Точность «отдаю/получаю» – количество знаков после запятой
Min. / Max. – минимальная и максимальная сумма обмена по направлению;
Процент прибыли – установите маржинальность.
Мерчант - провайдер или метод приёма платежей, через который происходит генерация реквизитов для этого направления. Если Вы желаете использовать статический кошелек, указывайте соответствующий вариант. Если Вы желаете использовать мерчант установленный в создании валюты, тогда можете оставлять это поле пустым
⚙️ Дополнительные параметры
Массовое редактирование позволяет одновременно обновлять несколько направлений, например, для изменения курсов или процентов. Рекомендуем ползунок поле включённым.
Также, можете выбрать Принудительное автоматическое чтобы включить отображение направления как автоматического в файле экспорта.
Включено включает или отключает отображение направления на сайте
Расширенные настройки: Секция "Города" Эта секция позволяет настроить географические коэффициенты для городов.
Місто: Название города.
Коэффициент: Коэффициент, на который будет умножен курс для пользователей из этого города (например, 1.01 для увеличения на 1%).
Минимальная сумма: сумма обмена для конкретного города.
Расширенные настройки: Секция "Withdraws" (Автовыплаты) Эта секция позволяет подключить модуль автоплатежей для этого направления.
Автоматические выводы: Выберите из выпадающего списка активный модуль автовыплат, который будет обрабатывать транзакции (если модуль подключен). В этом случае система сама осуществляет переводы клиентам в выбранной валюте.
Минимальная сумма: Минимальная сумма для срабатывания автовыплаты.
Максимальная сумма: Максимальная сумма для автовыплаты.
После заполнения всех необходимых полей нажмите кнопку «Сохранить». Направление будет добавлено в общий список и, в зависимости от статуса, станет доступно для пользователей. 📌 Таким образом, модуль «Направления» является базовым инструментом настройки работы обменника. Он позволяет управлять полным жизненным циклом направлений: от создания до редактирования параметров курсов, ограничений, прибыльности и контроля верификаций. Возвращаясь к последовательной настройке котировок, валют и направлений о которых идёт речь в соответствующих разделах, уже создав 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) редактировать процент влияния на курс в общей таблице направлений либо в редактировании конкретного направления
Последнее обновление