For the complete documentation index, see llms.txt. This page is also available as Markdown.

Справочник системных настроек

Этот файл описывает реальные настройки админки простым языком. Если пользователь спрашивает про конкретную галочку или поле в разделе “Настройки”, AI должна искать здесь.

Основные настройки сайта

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Название сайта

Основное имя обменника

Укажите бренд или название проекта

Должно совпадать с логотипом и письмами

Краткое название

Короткое описание бренда

2–5 слов

Используйте в шапке или малых блоках

Description сайта

SEO-описание

1–2 предложения до 200 символов

Не пишите длинный рекламный текст

Часовой пояс

В каком времени показывать даты

Выберите часовой пояс фактической работы

Влияет на заявки, логи, CRON, отчёты

Текущий язык

Основной язык админки и сайта

Выберите рабочий язык

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

Мультиязычность

Какие языки доступны на сайте

Указывайте только реально заполненные языки

Пустые переводы ухудшают сайт

Отключить смену языка

Запретить клиенту менять язык

Включайте, если сайт должен работать на одном языке

Если включено, клиент не увидит переключатель

Вид отображения счёта

Как скрывать реквизиты пользователя

Выберите полный показ или маскирование

Маскирование снижает риск утечки реквизитов

Направление по умолчанию

Какой режим выбора направления открывается первым

Оставьте рекомендованный режим или выберите из настроек направления

Влияет на первый экран обмена

Внутренний счёт

Включает внутренний баланс клиента

Включайте только если используете личный кабинет и балансы

Нужна проверка балансов и валют

Аккордеон контента

Сворачивать длинный контент на страницах

Включайте для длинных страниц

Проверьте, что важные условия видны

Кнопки “Читать далее”

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

Включайте при длинных описаниях

Не скрывайте критичные комиссии и правила

Количество строк “Читать далее”

После скольких строк скрывать текст

Обычно 5–8

Слишком мало строк раздражает клиента

Баланс системы

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Основная валюта баланса

Валюта, в которой считается главный внутренний баланс

Выберите устойчивый код, например USDT или USD

Нельзя часто менять на рабочем проекте

Fallback-коды валют

Запасные валюты для пересчёта баланса

Укажите коды, которые можно использовать, если основной курс недоступен

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

Настройки обмена и заявок

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Публичный ID заявки

Какой номер видит клиент

Стандартный ID проще, алгоритмический сложнее угадать

Для приватности лучше алгоритмический ID

Отображение курса или даты

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

Включайте, если клиенту важно видеть курс фиксации

При спорах курс должен совпадать с заявкой

Отключить поле email

Скрыть email для новых клиентов

Включайте только если бизнес допускает технический email

Может усложнить связь с клиентом

Стратегия ошибок мерчанта

Что делать, если мерчант не выдал реквизиты

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

Для стабильности лучше иметь альтернативу, если она настроена

Способ пересчёта заявки

Когда пересчитывать заявку

При смене статуса, по CRON или оба варианта

Для плавающих курсов лучше согласовать с регламентом

Интервал обновления курсов на странице

Как часто публичный сайт обновляет курсы

Не ставьте слишком часто

Рекомендуется не меньше 15 секунд

Максимум нажатий “Оплатить и завершить”

Сколько раз клиент может нажать кнопку оплаты

0 отключает ограничение

Ограничение помогает от повторных запросов

Пересчёт после истечения времени

Можно ли пересчитать заявку после просрочки

Включайте для мерчантов с поздним подтверждением

Обязательно объясните клиенту условия

Инструкция мерчанта пустая

Что показать, если у мерчанта нет инструкции

Ничего или инструкцию направления

Лучше иметь fallback из направления

Отклонять неполную оплату через мерчант

Что делать при неполной оплате

Обычно включают, если мерчант строго проверяет сумму

Может отклонить реальную частичную оплату

Автобан за мошеннические заявки

Банить клиента при scam-отклонении

Включайте после согласования с командой

Нужны корректные причины отклонения

Режим автобана

Строгость наказаний

Мягкий, стандартный, жёсткий

Жёсткий используйте только при атаках

Блокировать за спам-заявки

Автоматически ограничивать спамеров

Включайте при частых пустых заявках

Смотрите логи, чтобы не блокировать обычных клиентов

Добавлять IP/email в черный список

Автоматически заносить данные в чёрный список

Включайте только при понятном регламенте

Ошибка оператора может заблокировать нормального клиента

Запись данных заявки в файл

Дублировать данные заявок в файл

Включайте только если это нужно для интеграции или резервной отчётности

Файл может содержать чувствительные данные

Доступ к чеку заявки

Кто может открыть чек

Для приватности выбирайте владельца или временный доступ

Слишком строгий режим может вызвать жалобы

Максимум заявок на клиента

Ограничение количества заявок

0 обычно означает без ограничения

Полезно против спама

Отображаемые статусы в ЛК

Какие заявки клиент видит в личном кабинете

Выбирайте статусы, которые нужны клиенту

Не показывайте внутренние статусы без смысла

Время на оплату заявки

Сколько времени клиенту даётся оплатить

Укажите реалистичное время по платёжным методам

Для crypto нужно учитывать подтверждения сети

Автоархив

Автоматически переносить старые заявки в архив

Включайте для больших проектов

Не архивируйте слишком рано

Через сколько дней архивировать

Возраст заявки для архива

Задайте срок по регламенту

Для споров храните рабочий доступ достаточно долго

Статусы для архива

Какие заявки архивировать

Выбирайте финальные статусы

Не архивируйте активные заявки

Антиспам заявок

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Включить антиспам

Система ограничивает подозрительные заявки

Сначала включайте мягко

Проверяйте жалобы после включения

Период частых заявок

За сколько минут считать повторы

Обычно 5 минут

При атаке можно увеличить

Разрешённое количество быстрых заявок

Сколько заявок можно создать быстро

Обычно 3–5

Слишком низко мешает клиентам

Период неоплаченных заявок

За сколько часов искать неоплаченные

Обычно 24 часа

Помогает не занимать резервы

Допустимое количество неоплаченных

Сколько неоплаченных заявок разрешить

Обычно 2–3

Для B2B-клиентов может быть больше

Период проверки личности

Окно анализа похожих пользователей

Обычно 72 часа

Нужна осторожность для офисных IP

Максимум пользователей на одну личность

Сколько аккаунтов связано с одной личностью

Обычно 2–3

Не делайте слишком жёстко без данных

Период email и направления

Окно повторов по email и паре

Обычно 30 минут

Полезно от повторов по одной паре

Максимум попыток email и направления

Сколько повторов разрешить

Обычно 5

Снижайте при атаке

Балл репутации

Порог подозрительности

Обычно 70

Не путать с AML risk score

Блокировка личности

На сколько часов ограничить подозрительную связку

Обычно 24 часа

При ошибке клиент не сможет создать заявку

Безопасность

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Google Authenticator

Код 2FA при входе

Включайте после настройки ключевых аккаунтов

Обязательно для владельца

Доверенные прокси

Откуда брать реальный IP

Выберите файл только при реальном прокси

Неверно настроенный прокси ломает IP-логи

Время жизни сессии

Сколько минут действует вход

60–240 минут

Для операторов не ставьте слишком мало

Максимум неверных входов

Лимит ошибок пароля

5–10

Защищает от перебора

Блокировка после ошибок

Пауза после неверных входов

От 10 минут

При атаке увеличьте

Контроль изменения IP

Сброс сессии при смене IP

Средний режим безопасен, высокий строже

Для мобильных операторов высокий режим может мешать

Ограничить админку по IP

Пускать только с разрешённых IP

Включайте только со стабильными IP

Можно закрыть доступ всем

Разрешённые IP

Список IP/CIDR

Добавьте все офисные и резервные IP

Храните список приватно

Сбрасывать ключ при каждом входе

Старые ключи становятся недействительными

Включайте для строгой политики

Может чаще завершать сессии

Показывать активные сессии

Пользователь видит устройства

Включайте для контроля

Требует корректного IP

CAPTCHA для входа, регистрации, заявки, админки и сброса пароля

Где включена CAPTCHA

Включайте по риску спама

Проверяйте нужную форму после включения

CAPTCHA site key

Публичный ключ

Вставьте из сервиса CAPTCHA

Не путать с secret

CAPTCHA secret

Секретный ключ

Хранить только в настройках

Нельзя добавлять в документацию

Пользователи

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Отключить автоматическую регистрацию

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

Включайте только если нужна ручная регистрация

Может мешать быстрому обмену

Защита email-доменов

Разрешать или запрещать домены email

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

Ошибка заблокирует регистрацию

Разрешённые домены email

Только эти домены могут регистрироваться

Указывайте по одному домену или через список

Используйте редко

Запрещённые домены email

Эти домены нельзя использовать

Добавляйте временные/спам-домены

Не блокируйте популярные домены без причины

Сохранять историю счетов

Запоминать реквизиты после успешной заявки

Включайте для удобства постоянных клиентов

Важно для приватности данных

Галочка “Не запоминать”

Клиент может запретить сохранение данных

Лучше включить

Повышает доверие

GeoIP пользователя

Определять страну пользователя

Включайте при необходимости региональных правил

Нужен корректный GeoIP

Автоотключение аккаунтов

Отключать неактивных пользователей

0 — без ограничения

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

Очистка неподтверждённых пользователей

Через сколько дней удалять/отключать неподтверждённых

0 — без ограничения

Полезно от мусорных регистраций

Рефералка после верификации

Бонусы доступны после email/KYC проверки

Включайте для защиты от накрутки

Уточните, какая верификация требуется

Запомнить вход

Автоматически сохранять login session

Включайте для удобства

Для высокой безопасности лучше осторожно

Валюты “Мои кошельки”

Какие валюты доступны в кошельках клиента

Выбирайте только рабочие валюты

Если валюта выключена, проверьте кабинет

Имя пользователя по умолчанию

Шаблон имени при авторегистрации

Можно использовать :id:, :random:, :randomUser:

Не используйте персональные данные

Расчёты и курсы

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Максимум знаков после запятой

Точность сумм в калькуляторе

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

Не ставьте слишком мало для BTC

Автозаполнение минимальной суммы

Что делать, если сумма пустая

Можно подставлять минимальную сумму

Удобно для клиентов

Метод суммы по умолчанию

Как выбирать сумму при открытии пары

Автоматически, из настроек, минимальная сумма

Оставьте автоматический, если нет причины

Логирование курсов

Записывать историю изменений курса

Включайте для диагностики

Увеличивает объём данных

Знаки отображения курсов

Сколько знаков показывать в админке

Укажите под точность ваших валют

Не влияет на реальную математику так же, как формат отображения

Оптимизация и кеш

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Драйвер кеша

Где хранить кеш

file, redis или memcached

Redis лучше для нагруженных проектов

Кеш приложения

Общий флаг кеширования

Включайте на production

После изменений чистите кеш

Кеш стартовых данных сайта

Кеш начальных данных сайта

Включайте при стабильных настройках

Может задержать обновления на сайте

Время кеша стартовых данных сайта

Сколько секунд хранить данные

30–300 секунд для активного сайта

Слишком долго мешает быстрым изменениям

Кеш данных обмена

Кеш данных обмена

Включайте осторожно при частых курсах

Проверьте актуальность направлений

Время кеша компонентов

Сколько хранить компоненты

Зависит от нагрузки

После контентных изменений чистите кеш

Кеш тарифов, FAQ, footer, contacts, news, banners

Кеш отдельных публичных блоков

Включайте для стабильных блоков

Если блок не обновился, чистите кеш конкретной области

Очистить кеш

Удаляет кеш

Используйте после важных изменений

Может кратко повысить нагрузку

Email-уведомления

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Драйвер почты

SMTP или Resend

Выберите используемый сервис

Нужна тестовая отправка

Email поддержки

Адрес, который видит клиент

Укажите публичный support email

Не используйте личный email владельца

Email администраторов

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

Укажите рабочие адреса через разрешённый формат

Не добавляйте реальные адреса в документацию

Центр уведомлений

Единый модуль уведомлений

Включайте для шаблонов и маршрутизации

Проверьте события

Mail enabled

Включить email-канал центр уведомлений

Да, если email должен уходить

При выключении письма не отправятся

Telegram enabled

Включить Telegram-канал центр уведомлений

Да, если Telegram используется

Требует настройки каналов

SMTP host/port/username/password/encryption

Подключение SMTP

Заполняйте по данным почтового сервиса

Пароль не документировать

From address/name

От кого приходит письмо

Укажите бренд и support email

Должно выглядеть доверенно

Resend API key

Ключ Resend

Вставлять только в закрытой админке

Нельзя раскрывать

События заявок

Какие письма отправлять по заявкам

Включайте нужные клиенту и админам события

Не спамьте клиента лишними письмами

События верификации

Уведомления успеха/отказа KYC/карты

Включайте, если проверка используется

Текст должен быть понятным

Тестовая отправка

Проверить почту

Запускайте после изменения настроек

Если тест не проходит, письма работать не будут

Online chat и чат заявок

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Включить онлайн-чат

Показывать общий чат на сайте

Включайте при наличии поддержки

Без операторов чат раздражает клиентов

Тип чата

iEXChat, JivoSite, InterCom, Tawk, Talk-me

Выберите подключенный сервис

Для внешнего сервиса нужны его ID/URL

ID приложения чата

Идентификатор виджета или приложения

Вставляйте только ID нужного сервиса, не весь HTML-код

Формат отличается у каждого провайдера

URL виджета

Адрес загрузчика iEXChat

Заполняйте только для типа iEXChat

Для JivoSite, Intercom, Tawk и Talk-Me адрес строится автоматически

Чат в заявках

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

Включайте для поддержки оплат и реквизитов

Виден в карточке заявки

Статусы показа чата

На каких статусах доступен чат

Выбирайте активные статусы

На финальных статусах чат можно скрыть

Telegram-уведомления чата

Уведомлять админов в Telegram

Включайте, если канал настроен

Иначе уведомления не придут

Email-уведомления чата

Уведомлять по email

Включайте при рабочей почте

Может создавать много писем

Файлы от клиента

Разрешить клиенту прикреплять файлы

Включайте для чеков и документов

Ограничьте типы файлов

Разрешённые расширения

Какие файлы можно отправлять

Обычно PNG, JPG, JPEG, PDF

Не разрешайте опасные форматы

Максимальный размер файла

Сколько МБ можно загрузить

5–10 МБ часто достаточно

Большие файлы грузят сервер

Индикатор печати

Показывать “печатает”

Можно включить для живого чата

Нужны настройки обновления в реальном времени

Быстрые ответы

Готовые фразы оператора

Добавьте частые ответы поддержки

Не пишите грубо и двусмысленно

Jivo: тип сообщения

Когда передавать информацию в Jivo

Выберите сценарий передачи

Проверьте с реальным Jivo

Jivo: текст сообщения

Что передавать оператору

Используйте доступные теги

Не передавайте лишние персональные данные

Jivo: информация о пользователе

Передавать данные клиента в Jivo

Включайте только если разрешено политикой

Учитывайте приватность

Точные форматы ID, порядок тестирования и ограничения описаны в странице «Онлайн-чаты: iEXChat, JivoSite, Intercom, Tawk.to, Talk-Me и Zendesk». Zendesk не входит во встроенный список типов текущей админки: для него требуется отдельная frontend-интеграция, а не подстановка скрипта в поле другого сервиса.

Интеграции, GeoIP, AI, CRON и логи

Поле / настройка
Что означает
Как правильно заполнять
Рекомендация

Yandex Metrika ID

Счётчик Яндекс.Метрики

Укажите ID из кабинета

Проверяйте публичный сайт

Google Analytics Measurement ID

ID GA4

Формат обычно начинается с G-

Не путайте с Universal Analytics

Microsoft Clarity Project ID

ID проекта Clarity

Вставьте Project ID

Не вставляйте весь скрипт, если поле ждёт ID

Bitcoin network load

Показ загруженности сети Bitcoin

Включайте, если нужно клиентам

Должна быть валюта BTC и источник данных

GeoIP enabled

Включить геолокацию

Включайте при региональных правилах

Проверьте прокси

GeoIP cache

Кешировать геоответы

Включайте для скорости

При ошибках можно очистить кеш

GeoIP pipeline

Использовать цепочку обработки GeoIP

Включайте при настроенной системе

Если источник недоступен, проверьте логи

GeoIP readonly cache

Читать только из кеша

Для аварийного режима

Новые IP могут не определяться

OpenAI API key

Ключ AI-функций

Вставляется только в закрытой админке

Нельзя документировать значение

AI-помощник в онлайн-чате

AI-помощник в чате

Включайте после подготовки базы знаний

Нужны правила безопасности ответов

AI translate

AI-переводы

Включайте для помощи с локалями

Проверяйте переводы вручную

AI translate overwrite

Перезаписывать существующие переводы

Включайте только осознанно

Может заменить ручные тексты

Режимы CRON курсов

manual, auto, event

Для production обычно auto

Смотрите CRON и фоновые процессы

Очистка логов

Удаление старых логов

Настройте по типу журнала

Не удаляйте нужные финансовые логи

Точная карта секций настроек

Эта таблица помогает AI-чату связать пользовательский вопрос с реальной секцией админки.

Если спрашивают
Открыть в админке
Что объяснить простыми словами

Название сайта, SEO, языки, часовой пояс

Настройки - Основное

Эти поля задают базовую публичную информацию и время, по которому живут заявки, логи и уведомления

Главная валюта баланса

Настройки - Баланс системы

Валюта баланса влияет на внутренние балансы, аналитику и некоторые финансовые расчеты

Номер заявки, время оплаты, архив, пересчет

Настройки - Обмен

Эти поля задают жизненный цикл заявки: как она создается, сколько живет и как пересчитывается

Спам-заявки и массовые пустые заявки

Настройки - Безопасность - Антиспам заявок

Антиспам ограничивает подозрительные повторы, неоплаченные заявки и обход через новые аккаунты

2FA, CAPTCHA, IP входа, сессии

Настройки - Безопасность

Эти поля защищают админку, вход пользователей и формы сайта

Авторегистрация, домены email, сохранение реквизитов

Настройки - Пользователи

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

Округления и поведение поля суммы

Настройки - Расчеты

Здесь задается точность и автозаполнение суммы в форме обмена

История курсов и отображаемая точность

Настройки - Курсы

Здесь включается диагностика истории курсов и удобство отображения в админке

Тема, резервы на главной, блоки сайта

Настройки - Оформление

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

Фон, favicon, логотипы

Настройки - Изображения

Здесь меняются визуальные файлы бренда

Техперерыв, приветствие, footer-текст

Настройки - Текст

Эти поля меняют публичные тексты сайта

SMTP, Resend, отправитель, события писем

Настройки - E-mail уведомления

Здесь настраивается отправка писем клиентам и администраторам

Realtime-уведомления на сайте

Настройки - Broadcast уведомления

Здесь включается модуль всплывающих realtime-сообщений

Виджет чата, чат заявки, файлы, быстрые ответы

Настройки - Онлайн чат

Здесь настраивается общая поддержка и переписка внутри заявки

Метрика, Analytics, Clarity, Bitcoin load

Настройки - Интеграции

Здесь подключаются внешние аналитические и публичные индикаторы

Обновление курсов, BestChange и файлов

Настройки - CRON

Здесь выбирается режим автообновления данных

GeoIP и кеш геолокации

Настройки - GeoIP

Здесь включается определение страны и города по IP

Автоочистка логов

Настройки - Логи

Здесь задаются сроки хранения истории по разделам

Кеш сайта и очистка кеша

Настройки - Оптимизация

Здесь ускоряются публичные блоки сайта и управляется свежесть данных

AI-чат и автоперевод

Настройки - AI

Здесь включаются AI-функции и задается ключ подключения

Какие настройки зависят от других разделов

Настройка
Не заработает корректно без
Что проверить

Включить внутренний счет

Валюты, баланс системы, личный кабинет, права пользователя

Есть ли основная валюта баланса и понятный сценарий пополнения

Скрывать валюты без резерва

Валюты, направления, резервы, кеш главной

Резерв заполнен и не равен нулю

Показ популярных направлений

Направления, статистика заявок, кеш

Есть реальные успешные обмены или ручной порядок

Включить чат заявки

Статусы заявок, права операторов, уведомления

Чат разрешен для нужных статусов

Telegram-уведомления чата

Telegram-канал, бот, события, очередь

Бот привязан и имеет права отправки

Email-уведомления чата

Почтовая служба, события писем, очередь

Тестовое письмо проходит

Пересчет заявки

Курсы, настройка направления, CRON, статусы

Понятно, когда пересчет разрешен по регламенту

Автоархив заявок

Статусы, возраст заявки, scheduler

Выбраны только финальные статусы

Антиспам заявок

Логи заявок, лимиты, идентификаторы клиента

Начинать с мягкого режима и смотреть жалобы

CAPTCHA при создании заявки

Ключи CAPTCHA, домен, публичная форма

Проверить реальную форму после включения

Очистка логов

Регламент хранения, поддержка, финансы

Не удалять нужную историю платежей и споров

Кеш публичных блоков

Контент, курсы, резервы, очистка кеша

После изменения важного блока проверить сайт

AI в онлайн-чате

База знаний, правила ответов, онлайн-чат

AI не должен отвечать по секретам и спорным платежам

Готовые ответы по частым вопросам настроек

Вопрос пользователя
Короткий ответ AI

"Где поменять название сайта?"

Откройте Настройки - Основное. Заполните название и краткое название для нужных языков, затем проверьте сайт и письма.

"Почему время в заявке неверное?"

Проверьте Настройки - Основное - Часовой пояс. После изменения смотрите новые заявки и логи, старые записи могли быть созданы в прежней зоне.

"Почему клиент видит старый текст?"