> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/ai-base/administrirovanie/settings-field-reference.md).

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

Этот файл описывает реальные настройки админки простым языком. Если пользователь спрашивает про конкретную галочку или поле в разделе “Настройки”, 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 приложения чата              | Идентификатор виджета                      | Вставляйте из сервиса                      | Не добавляйте приватные данные в документации |
| URL виджета                     | Ссылка на скрипт/виджет                    | Используйте только доверенный URL          | Неверный URL ломает виджет                    |
| Чат в заявках                   | Включить переписку по конкретной заявке    | Включайте для поддержки оплат и реквизитов | Виден в карточке заявки                       |
| Статусы показа чата             | На каких статусах доступен чат             | Выбирайте активные статусы                 | На финальных статусах чат можно скрыть        |
| Telegram-уведомления чата       | Уведомлять админов в Telegram              | Включайте, если канал настроен             | Иначе уведомления не придут                   |
| Email-уведомления чата          | Уведомлять по email                        | Включайте при рабочей почте                | Может создавать много писем                   |
| Файлы от клиента                | Разрешить клиенту прикреплять файлы        | Включайте для чеков и документов           | Ограничьте типы файлов                        |
| Разрешённые расширения          | Какие файлы можно отправлять               | Обычно PNG, JPG, JPEG, PDF                 | Не разрешайте опасные форматы                 |
| Максимальный размер файла       | Сколько МБ можно загрузить                 | 5–10 МБ часто достаточно                   | Большие файлы грузят сервер                   |
| Индикатор печати                | Показывать “печатает”                      | Можно включить для живого чата             | Нужны настройки обновления в реальном времени |
| Быстрые ответы                  | Готовые фразы оператора                    | Добавьте частые ответы поддержки           | Не пишите грубо и двусмысленно                |
| Jivo: тип сообщения             | Когда передавать информацию в Jivo         | Выберите сценарий передачи                 | Проверьте с реальным Jivo                     |
| Jivo: текст сообщения           | Что передавать оператору                   | Используйте доступные теги                 | Не передавайте лишние персональные данные     |
| Jivo: информация о пользователе | Передавать данные клиента в Jivo           | Включайте только если разрешено политикой  | Учитывайте приватность                        |

## Интеграции, 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 и фоновые процессы             |
| Очистка логов                   | Удаление старых логов                | Настройте по типу журнала              | Не удаляйте нужные финансовые логи           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iexexchanger.com/help-center/ai-base/administrirovanie/settings-field-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
