> 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/valyuty-i-napravleniya/directions-reference.md).

# Справочник направлений

Направление — это конкретная пара обмена, например `BTC - USDT`. Именно направление объединяет две валюты, курс, лимиты, резерв, комиссии, мерчант, автовыплату, поля, KYC, AML, города, экспорт и правила обработки заявки.

## Список направлений

| Поле / действие               | Что означает                                                 | Как использовать                    | Ошибки при неверной настройке                           |
| ----------------------------- | ------------------------------------------------------------ | ----------------------------------- | ------------------------------------------------------- |
| Фильтр по валюте “Отдаю”      | Показывает направления, где клиент отдаёт выбранную валюту   | Используйте для проверки пары       | Можно перепутать сторону пары                           |
| Фильтр по валюте “Получаю”    | Показывает направления, где клиент получает выбранную валюту | Используйте для обратной пары       | `BTC - USDT` и `USDT - BTC` — разные направления        |
| Фильтр по статусу             | Активные, выключенные, архивные                              | Быстро найти скрытые направления    | Выключенное направление не видно клиенту                |
| Массовое включение/выключение | Меняет статус нескольким направлениям                        | Используйте при технических работах | Можно случайно выключить рабочие пары                   |
| Дублировать направление       | Создаёт копию пары                                           | Удобно для похожих направлений      | После дубля обязательно поменяйте валюты, курс, лимиты  |
| Архив                         | Убирает направление из работы                                | Используйте для старых пар          | Не архивируйте пару с активными заявками                |
| Проверка проблем              | Показывает причины недоступности                             | Используйте, если пара не видна     | Причины могут быть в валюте, курсе, резерве или лимитах |

## Создание направления

| Поле / настройка           | Что означает                    | Как правильно заполнять                            | Рекомендация                            |
| -------------------------- | ------------------------------- | -------------------------------------------------- | --------------------------------------- |
| Валюта “Отдаю”             | Что клиент отправляет обменнику | Выберите активную валюту                           | Сторона важна для реквизитов и мерчанта |
| Валюта “Получаю”           | Что клиент получает             | Выберите активную валюту                           | Сторона важна для выплаты и резерва     |
| Техническое название       | Название направления в админке  | Например `BTC - USDT TRC20`                        | Не используйте непонятные сокращения    |
| Статус                     | Доступность направления         | Включайте после настройки курса, резерва и лимитов | Не включайте пустую пару                |
| Проверка существующей пары | Предупреждает о дубле           | Если пара уже есть, откройте её                    | Дубли путают сайт и операторов          |

## Основные настройки направления

| Поле / настройка     | Что означает                                   | Как правильно заполнять               | Рекомендация                                            |
| -------------------- | ---------------------------------------------- | ------------------------------------- | ------------------------------------------------------- |
| Статус               | Активность пары                                | Активно, выключено, архив             | Активируйте только после теста                          |
| Валюта 1             | Сторона “Отдаю”                                | Выберите правильную валюту            | После заявок менять сторону опасно                      |
| Валюта 2             | Сторона “Получаю”                              | Выберите правильную валюту            | Ошибка создаёт неправильные заявки                      |
| Техническое название | Внутреннее название пары                       | Используйте понятный формат           | Например `BTC - USDT TRC20`                             |
| Минимум “Отдаю”      | Минимальная сумма, которую клиент может отдать | Укажите реальный бизнес-минимум       | Слишком высокий минимум снижает заявки                  |
| Максимум “Отдаю”     | Максимальная сумма входа                       | Укажите по резерву, мерчанту и рискам | Не ставьте выше возможностей оплаты                     |
| Минимум “Получаю”    | Минимальная сумма выплаты                      | Рассчитывайте по лимитам автовыплат   | Может блокировать мелкие заявки                         |
| Максимум “Получаю”   | Максимальная сумма выплаты                     | По резерву и лимитам провайдера       | Не ставьте выше резерва                                 |
| Источник лимитов     | Откуда брать min/max                           | Базовые, профиль, вручную, без лимита | Профили удобны для массового управления                 |
| Профиль лимитов      | Готовый набор лимитов                          | Выберите подходящий профиль           | Изменение профиля влияет на все привязанные направления |
| Сделать главным      | Использовать направление как приоритетное      | Включайте для популярных пар          | Не делайте главным неготовую пару                       |

## Информация направления

| Поле / настройка        | Что означает                          | Как правильно заполнять                    | Рекомендация                                    |
| ----------------------- | ------------------------------------- | ------------------------------------------ | ----------------------------------------------- |
| Описание обмена         | Текст о конкретной паре               | Опишите особенности `BTC - USDT`           | Если правила общие, можно брать описание валюты |
| Дополнительное описание | Второй текстовый блок                 | Используйте для особых условий             | Не дублируйте одно и то же                      |
| Инструкция оплаты       | Что должен сделать клиент             | Пошагово, без технического шума            | Критично для ручных реквизитов                  |
| Текст подтверждения     | Что показывать перед созданием заявки | Укажите важные предупреждения              | Клиент должен понимать последствия              |
| Кнопка подтверждения    | Текст кнопки                          | Коротко: “Подтвердить”, “Создать заявку”   | Длинный текст плохо выглядит                    |
| Интервал подтверждения  | Задержка или время подтверждения      | Укажите только если нужен процесс ожидания | Не используйте без смысла                       |
| SEO title               | Заголовок страницы пары               | Коротко по паре                            | Полезно для публичных страниц направлений       |
| SEO description         | Описание для поиска                   | 1–2 предложения                            | Не вставляйте внутренние данные                 |
| SEO keywords            | Ключевые слова                        | Умеренно и по смыслу                       | Не перегружайте                                 |

## Поля направления и пользователя

| Поле / настройка      | Что означает              | Как правильно заполнять                          | Рекомендация                                      |
| --------------------- | ------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Доп. поля направления | Поля именно для этой пары | Например город, способ связи, банк               | Используйте, если поле нужно только для пары      |
| Пользовательские поля | Поля клиента              | Например Telegram, ФИО, комментарий              | Не собирайте лишние персональные данные           |
| Обязательность        | Нужно ли заполнить поле   | Включайте только для действительно обязательного | Чем больше обязательных полей, тем ниже конверсия |
| Название поля         | Как поле видит клиент     | Простое название                                 | Например “Ваш Telegram”                           |
| Подсказка             | Объяснение под полем      | Укажите формат                                   | Помогает снизить ошибки                           |
| Валидатор             | Проверка формата          | Выберите подходящий валидатор                    | Неверный валидатор блокирует форму                |
| Сортировка            | Порядок полей             | Важные поля выше                                 | Логичный порядок повышает удобство                |

## Верификация по направлению

| Поле / настройка        | Что означает                             | Как правильно заполнять              | Рекомендация                                        |
| ----------------------- | ---------------------------------------- | ------------------------------------ | --------------------------------------------------- |
| Верификация карты       | Требовать проверку карты именно для пары | Включайте для банковских направлений | Может переопределять или дополнять валютные правила |
| Минимальная сумма карты | Порог проверки карты                     | Укажите сумму риска                  | Не делайте ниже без причины                         |
| Текст проверки карты    | Сообщение клиенту                        | Объясните, что нужно загрузить       | Должно совпадать с инструкциями KYC                 |
| KYC по направлению      | Проверка личности для пары               | Выключено, всегда, от суммы          | Используйте для рискованных направлений             |
| Минимальная сумма KYC   | Порог проверки личности                  | Согласуйте с AML/KYC политикой       | Не путать с AML risk score                          |
| Информация KYC          | Инструкция для клиента                   | Укажите сроки и следующий шаг        | Простые формулировки уменьшают обращения            |

## Города и cash-направления

| Поле / настройка  | Что означает                    | Как правильно заполнять                     | Рекомендация                             |
| ----------------- | ------------------------------- | ------------------------------------------- | ---------------------------------------- |
| Город             | Где доступен обмен              | Выберите город из справочника               | Для cash это обязательная часть сценария |
| Информация города | Текст по городу                 | Укажите общие условия без приватных адресов | Не раскрывайте адреса до нужного этапа   |
| Комиссия города   | Надбавка или комиссия по городу | Заполняйте по фактическим условиям          | Может влиять на курс                     |
| Прибыль города    | Маржа по городу                 | Укажите по бизнес-модели                    | Не путать с общей прибылью направления   |
| Профиль городов   | Набор городских правил          | Используйте для нескольких направлений      | Изменение профиля затрагивает все связи  |

## Курсы направления

| Поле / настройка                    | Что означает                            | Как правильно заполнять                                        | Рекомендация                               |
| ----------------------------------- | --------------------------------------- | -------------------------------------------------------------- | ------------------------------------------ |
| Источник курса                      | Откуда направление берёт курс           | Источник, формула, файл, конкурент, BestChange или ручной курс | Выбирайте один понятный источник           |
| Добавка к курсу в процентах         | Процентная корректировка                | Например `1` для плюс 1 процент                                | Проверяйте итоговый курс на сайте          |
| Добавка к курсу фиксированная       | Фиксированная надбавка                  | Используйте редко, когда нужна абсолютная поправка             | Для разных сумм может вести себя грубо     |
| Ручной курс                         | Фиксированный курс направления          | Укажите только при ручном управлении                           | При ручном курсе автоисточники не помогают |
| Формула                             | Формульный источник                     | Выберите готовую формулу                                       | Формула должна возвращать число            |
| Файловый курс                       | Курс из файла                           | Выберите пару из файлового источника                           | Проверьте preview файла                    |
| Конкурент                           | Курс конкурента                         | Выберите источник конкурента                                   | Используйте для мониторинга рынка          |
| Минимальная сумма для нового курса  | Сумма, от которой применять другой курс | Заполняйте при ступенчатых курсах                              | Важно для крупных заявок                   |
| Максимальная сумма для нового курса | Верхний порог                           | Укажите диапазон                                               | Диапазоны не должны конфликтовать          |
| Новый курс при диапазоне            | Какой курс применить                    | Выберите курс или добавку                                      | Проверьте на тестовой сумме                |

## BestChange в направлении

| Поле / настройка       | Что означает                                   | Как правильно заполнять                     | Рекомендация                                    |
| ---------------------- | ---------------------------------------------- | ------------------------------------------- | ----------------------------------------------- |
| Статус BestChange-пары | Использовать ли правило                        | Включайте после проверки                    | Выключенная пара не влияет на курс              |
| Валюта входа           | Валюта BestChange “Отдаю”                      | Сопоставьте с направлением                  | Неверное сопоставление даёт неправильный рынок  |
| Валюта выхода          | Валюта BestChange “Получаю”                    | Сопоставьте с направлением                  | Проверяйте обратные пары                        |
| Город                  | Город BestChange                               | Заполняйте для cash-направлений             | Без города курс может отличаться                |
| Режим расчёта          | Позиция, медиана top N, средневзвешенный top N | Позиция проще, top N устойчивее             | Для стабильности часто лучше top N              |
| Номер позиции          | Какая строка рынка берётся                     | Например 1, 2, 3                            | Первая позиция может быть нестабильной          |
| Top N                  | Сколько обменников учитывать                   | Например 5 или 10                           | Меньше N — чувствительнее к выбросам            |
| Шаг                    | Минимальное смещение от рынка                  | Заполняйте по стратегии                     | Ошибка может сделать курс невыгодным            |
| Формула                | Доп. формула к BestChange                      | Используйте только если понимаете эффект    | Проверяйте итог                                 |
| Черный список          | Какие обменники исключить                      | Исключайте подозрительных или нерелевантных | Не исключайте слишком много                     |
| Whitelist              | Использовать только выбранных                  | Для строгого рынка                          | Если список пуст или узкий, курс может пропасть |
| Min/max reserve        | Фильтр по резерву обменника                    | Укажите реалистичные значения               | Слишком строгий фильтр уберёт рынок             |
| Min/max sum            | Фильтр по сумме                                | Укажите диапазон вашей заявки               | Помогает брать релевантный курс                 |
| Reset course           | Сбрасывать курс при ошибке                     | Используйте для защиты от старых данных     | Может временно убрать курс                      |
| Standard course        | Запасной стандартный курс                      | Укажите fallback                            | Нужен, если рынок недоступен                    |

## Кратность и ограничения

| Поле / настройка      | Что означает                         | Как правильно заполнять        | Рекомендация                             |
| --------------------- | ------------------------------------ | ------------------------------ | ---------------------------------------- |
| Тип кратности         | Как округлять сумму                  | По входу или выходу            | Для наличных часто кратность по выдаче   |
| Значение кратности    | На какое число должна делиться сумма | Например 100, 500, 1000        | Для купюр используйте номиналы           |
| Комментарий кратности | Объяснение клиенту                   | “Сумма должна быть кратна 100” | Без текста клиент не поймёт ошибку       |
| Ограничения           | Дополнительные условия пары          | Заполняйте по регламенту       | Слишком много ограничений снижает заявки |

## Комиссии и прибыль

| Поле / настройка            | Что означает                      | Как правильно заполнять                             | Рекомендация                         |
| --------------------------- | --------------------------------- | --------------------------------------------------- | ------------------------------------ |
| Процент прибыли             | Маржа обменника                   | Укажите бизнес-маржу                                | Проверяйте итоговый курс             |
| Фиксированная прибыль       | Фиксированная сумма               | Используйте для небольших сумм или сервисного сбора | Может сильно влиять на мелкие заявки |
| Дополнительная комиссия     | Комиссия сверх курса              | Укажите процент и фиксированное значение            | Клиент должен понимать итог          |
| Сторона комиссии            | Где применяется комиссия          | Отдаю или Получаю                                   | Неверная сторона меняет сумму        |
| Комиссия платёжной системы  | Комиссия провайдера               | Заполняйте по реальным условиям                     | Не путайте с прибылью обменника      |
| Минимальная комиссия        | Нижний предел комиссии            | Укажите, если провайдер берёт минимум               | Важно для малых сумм                 |
| Статус комиссии             | Включена ли комиссия              | Включайте только проверенные правила                | Выключенная комиссия не применяется  |
| Название комиссии           | Как комиссия называется           | Понятно для администратора и клиента                | Не используйте внутренний жаргон     |
| Описание комиссии           | Пояснение                         | Когда и почему берётся                              | Помогает поддержке                   |
| Комиссии по диапазону суммы | Разные правила для разных сумм    | Настройте диапазоны без пересечений                 | Тестируйте каждую границу            |
| Selector fee                | Комиссия, которую выбирает клиент | Например “обычная” и “ускоренная”                   | Опишите разницу простым языком       |

## Резервы направления

| Поле / настройка           | Что означает                       | Как правильно заполнять                 | Рекомендация                           |
| -------------------------- | ---------------------------------- | --------------------------------------- | -------------------------------------- |
| Использовать резерв валюты | Брать общий резерв валюты          | Включайте для простых пар               | Удобно, но не всегда точно             |
| Резерв направления         | Индивидуальный резерв пары         | Используйте, если лимит пары отличается | Важен для cash и отдельных поставщиков |
| Максимальный показ резерва | Сколько показывать клиенту         | Можно меньше фактического               | Защищает информацию о балансах         |
| Связанный резерв           | Резерв из другой валюты или группы | Используйте при общих балансах          | Требует осторожности                   |

## Реквизиты направления

| Поле / настройка  | Что означает                            | Как правильно заполнять          | Рекомендация                                       |
| ----------------- | --------------------------------------- | -------------------------------- | -------------------------------------------------- |
| Реквизиты пары    | Ручные реквизиты именно для направления | Выберите группу или список       | Используйте, если реквизиты отличаются от валютных |
| Группа реквизитов | Набор счетов                            | Выберите подходящую группу       | Группа должна быть активна                         |
| Лимиты реквизитов | Когда выдавать реквизит                 | Настройте по суммам и количеству | Ошибка может выдать перегруженный счёт             |
| Архив реквизитов  | Старые реквизиты                        | Не используйте в новых заявках   | Храните для истории                                |

## Пересчёт направления

| Поле / настройка             | Что означает                               | Как правильно заполнять               | Рекомендация                                   |
| ---------------------------- | ------------------------------------------ | ------------------------------------- | ---------------------------------------------- |
| Включить пересчёт            | Разрешить пересчитывать заявку             | Включайте для плавающих курсов        | Нужно объяснить клиенту                        |
| Статусы пересчёта            | На каких статусах можно пересчитать        | Выбирайте активные статусы до выплаты | Не пересчитывайте финальные заявки             |
| Направление изменения курса  | Любое, только вверх, только вниз           | Выберите по бизнес-логике             | Защищает от нежелательных пересчётов           |
| Порог роста                  | На сколько должен вырасти курс             | Укажите процент/значение              | Слишком низко создаст частые пересчёты         |
| Порог падения                | На сколько должен упасть курс              | Укажите значение                      | Согласуйте с клиентскими условиями             |
| Минимальная сумма отдачи     | Ниже какой суммы не пересчитывать          | Укажите для защиты мелких заявок      | Не усложняйте малые обмены                     |
| Тихое окно                   | Время без пересчёта после создания         | Укажите минуты                        | Защищает от мгновенных изменений               |
| Anti-storm                   | Защита от слишком частых пересчётов        | Включайте при волатильных курсах      | Без неё заявка может пересчитываться много раз |
| Максимум пересчётов          | Сколько раз можно пересчитать              | Ограничьте разумно                    | Иначе клиент не поймёт итог                    |
| Максимальный возраст статуса | Сколько минут статус может пересчитываться | Укажите по регламенту                 | Старые заявки лучше обрабатывать вручную       |
| Текст пересчёта              | Сообщение клиенту                          | Объясните, почему сумма изменилась    | Очень важно для доверия                        |

## Экспорт направления

| Поле / настройка           | Что означает                       | Как правильно заполнять              | Рекомендация                             |
| -------------------------- | ---------------------------------- | ------------------------------------ | ---------------------------------------- |
| Экспортировать направление | Показывать пару в XML/API выгрузке | Включайте для мониторингов           | Не экспортируйте неготовые пары          |
| XML-коды валют             | Как пара видна снаружи             | Должны совпадать с валютами          | Ошибка ломает мониторинги                |
| Резерв в экспорте          | Какой резерв отдавать              | Показывайте безопасное значение      | Не раскрывайте полный баланс без причины |
| Комиссии в экспорте        | Передавать ли комиссии             | Настройте по требованиям мониторинга | Должно совпадать с публичным курсом      |

## Массовый редактор направлений

| Поле / действие        | Что означает                                 | Как использовать                    | Предупреждение                              |
| ---------------------- | -------------------------------------------- | ----------------------------------- | ------------------------------------------- |
| Фильтр направлений     | Какие пары попадут в изменение               | Сначала сузьте список               | Массовая ошибка влияет на много пар         |
| Предпросмотр изменений | Предварительный просмотр массового изменения | Всегда смотрите перед применением   | Не пропускайте этот шаг                     |
| Изменить статус        | Включить/выключить несколько пар             | Используйте при технических работах | Не выключайте популярные пары случайно      |
| Изменить курс/источник | Назначить источник группе направлений        | Только если пары однотипные         | Разные пары требуют разных источников       |
| Изменить лимиты        | Массово задать min/max                       | Используйте профили лимитов         | Проверьте крупные и малые суммы             |
| Применить              | Выполнить изменение                          | Нажимайте после проверки            | Действие может быть трудно откатить вручную |

## Частые проблемы по направлениям

| Ситуация                          | Причина                                                                  | Что сделать                                   |
| --------------------------------- | ------------------------------------------------------------------------ | --------------------------------------------- |
| Пара не видна на сайте            | Статус, валюта, фильтр, курс, резерв, лимит, кеш                         | Открыть проверку ограничений и пройти цепочку |
| Форма показывает неверную сумму   | Источник курса, комиссия, selector fee или кратность                     | Проверить вкладки курсов и комиссий           |
| Клиент не может создать заявку    | Сумма вне лимитов, реквизит не прошёл проверку, KYC/AML, CAPTCHA         | Проверить ошибку на сайте и настройки пары    |
| Заявка создаётся без нужного поля | Поле не привязано к валюте или направлению                               | Проверить поля валюты и направления           |
| Мерчант не выбран                 | Нет правила, валюта не связана с мерчантом, лимит                        | Проверить правила мерчантов и валюту          |
| Автовыплата не выбрана            | Нет правила автовыплаты, валюта не связана с выплатой или превышен лимит | Проверить правила выплат и валюту             |
| Курс BestChange пропал            | Фильтры слишком строгие, черный список/whitelist, нет рынка              | Проверить BestChange-логи и фильтры           |


---

# 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/valyuty-i-napravleniya/directions-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.
