Обмен

Группа «Обмен» содержит настройки, которые определяют курс направления, защищают его от нежелательных значений и задают дополнительные условия обмена.

Здесь можно:

• выбрать основной источник курса;
• подключить ручной или резервный курс;
• использовать формулу, файл или курс конкурента;
• настроить страховку курса;
• связать направление с BestChange API;
• добавить города для наличного обмена;
• ограничить сумму заданной кратностью;
• переключать расчёт на резервный курс при выходе за установленный диапазон.

Где находятся настройки

В панели управления откройте:

«Основное» — «Направления обмена» — «Список направлений»

Выберите нужное направление и перейдите к его редактированию.

Затем раскройте группу «Обмен» и выберите необходимый раздел.

Настройки применяются отдельно к каждому направлению. Изменение курса, кратности или ограничений в одной валютной паре не влияет на другие направления.

Курс обмена

Откройте: «Обмен» — «Курс обмена»

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

На странице доступны следующие варианты:

• курс из источников;
• ручной курс;
• курс по формуле;
• курс из файла;
• курс конкурента.

Курс BestChange настраивается на соседней странице «BestChange API», но также участвует в общем выборе источника.

Как система выбирает курс

В одном направлении можно одновременно указать несколько источников.

Система не:

• складывает их значения;
• рассчитывает среднее значение;
• использует все источники одновременно.

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

Стандартный приоритет:

1. BestChange API.
2. Курс из источников.
3. Курс по формуле.
4. Ручной курс.
5. Курс из файла.
6. Курс конкурента.

Системный администратор может изменить этот порядок в серверной конфигурации. Если порядок не менялся, используется последовательность выше.

Источник считается доступным, если:

• он привязан к направлению;
• его запись включена;
• последнее обновление завершилось без ошибки;
• данные не считаются устаревшими;
• получено корректное положительное значение.

Для ручного курса проверяется только введённое значение. Оно должно быть больше 0.

Источники с меньшим приоритетом используются только в том случае, если более приоритетный источник недоступен на этапе выбора.

Если уже выбранный источник возвращает неправильное значение непосредственно во время расчёта, система не всегда автоматически переходит к следующему источнику. Поэтому состояние основного курса необходимо регулярно контролировать.

Курс из источников

Поле «Курс из источников» позволяет выбрать готовую валютную пару, созданную в модуле внешних источников курсов.

Курсы из источников

В списке отображаются доступные группы и пары.

Выбранная пара должна соответствовать порядку валют текущего направления.

Например, для направления:

USDT - RUB

необходимо выбрать курс, который действительно показывает отношение USDT к RUB.

Одинаковые коды валют не гарантируют правильный порядок расчёта. После сохранения обязательно проверьте, сколько клиент отдаёт и сколько получает.

1

Добавить к курсу в процентах

Поле со знаком % увеличивает числовое значение полученного курса на указанный процент.

Пример:

Исходный курс: 100
Добавить к курсу: 2%

Результат:

102

Значение 0 означает, что процентное изменение не применяется.

2

Фиксированное добавление к курсу

Поле со знаком S добавляет к курсу фиксированное числовое значение.

Пример:

Исходный курс: 100
Процентное добавление: 2%
Фиксированное добавление: 3 S

Расчёт:

100 + 2% = 102
102 + 3 = 105

Итоговый результат:

105

Что означают % и S в настройках системы

Процент применяется первым, фиксированное значение — вторым.

Знак S в этом поле означает фиксированное изменение курса. Это не процент и не отдельная комиссия от суммы заявки.

Текущая логика применяет только положительные значения. Нулевые и отрицательные значения не уменьшают курс.

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

Проверяйте итог с позиции клиента — сколько он отдаёт и сколько получает.

Ручной курс обмена

Поле «Ручной курс обмена» задаёт курс непосредственно в направлении.

Форма отображается как:

1 = значение S

Это означает, что одна единица валюты «Отдаю» равна указанному количеству единиц валюты «Получаю».

Пример для направления:

USDT - RUB

Настройка:

1 = 90

означает:

1 USDT = 90 RUB

Ручной курс должен быть больше 0.

Не считаются рабочими:

• пустое поле;
• 0;
• отрицательное значение;
• текст вместо числа;
• некорректный формат.

Ручной курс не обновляется автоматически. Его необходимо контролировать и изменять самостоятельно.

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

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

Курс по формуле

Поле «Курс по формуле» позволяет выбрать заранее созданную активную формулу.

Формулы

Формула может:

• использовать несколько исходных курсов;
• выполнять арифметические операции;
• рассчитывать кросс-курс;
• добавлять процент;
• применять внутренние коэффициенты.

На странице направления выбирается уже готовая формула. Её создание и настройка выполняются в модуле курсов.

Для использования формулы:

1. Создайте формулу в модуле курсов.
2. Включите её.
3. Убедитесь, что расчёт выполняется без ошибки.
4. Выберите формулу в направлении.
5. Нажмите «Сохранить».
6. Проверьте итоговый курс.

Формула пропускается при выборе источника, если:

• она выключена;
• последнее обновление завершилось ошибкой;
• данные устарели;
• результат равен 0;
• результат отрицательный;
• отсутствует одно из необходимых исходных значений.

Курс обмена из файла

Поле «Курс обмена из файла» позволяет выбрать пару, загружаемую модулем курсов из файла.

Курсы из файла

Перед привязкой необходимо отдельно настроить:

• источник файла;
• его формат;
• валютные пары;
• период обновления;
• правила обработки данных.

В направлении выбирается уже созданная пара.

Курс из файла участвует в расчёте, если:

• запись активна;
• последняя загрузка прошла без ошибки;
• данные не устарели;
• получено положительное значение.

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

• доступность файла;
• правильность формата;
• наличие нужной пары;
• дату последнего обновления;
• резервный сценарий на случай недоступности файла.

Курс конкурента

Поле «Курс конкурента» позволяет использовать пару, полученную модулем курсов конкурентов.

Курсы конкурентов

После выбора открываются дополнительные поля:

• «Мин. курс»;
• «Макс. курс»;
• «Сбросить на курс»;
• «Добавить к курсу».

Эти параметры относятся только к выбранному курсу конкурента. Они не заменяют общий раздел «Ограничение курса».

1

Мин. курс

Нижняя допустимая граница курса конкурента.

Значение:

0

отключает нижнюю проверку.

Курс, равный минимальному значению, считается допустимым.

2

Макс. курс

Верхняя допустимая граница курса конкурента.

Значение 0 отключает верхнюю проверку.

Курс, равный максимальному значению, считается допустимым.

3

Сбросить на курс

Резервный курс из внешних источников.

Он используется, если курс конкурента:

• стал ниже установленного минимума;
• стал выше установленного максимума.

Если резервный источник не выбран, выход за границы сам по себе:

• не отключает направление;
• не блокирует заявку;
• не заменяет курс конкурента.

4

Добавить к курсу

Положительная процентная корректировка резервного курса.

Она применяется только после фактического переключения с курса конкурента на резервный источник.

Значение 0 не изменяет резервный курс.

Отрицательное значение текущей логикой не применяется.

Пример работы курса конкурента

Настроено:

Курс конкурента: 110
Минимальный курс: 95
Максимальный курс: 105
Резервный курс: 98
Добавить к резервному курсу: 1%

Курс конкурента 110 выше установленного максимума 105.

Система переключается на резервный курс:

98

и увеличивает его на 1%:

98 + 1% = 98,98

Итоговый курс:

98,98

Если конкурент возвращает 100, значение находится в диапазоне от 95 до 105, поэтому резервный курс не применяется.

Настройки курса конкурента работают только тогда, когда калькулятор действительно выбрал этот источник.

Если раньше сработал BestChange API, внешний источник, формула, ручной или файловый курс, параметры конкурента в расчёте не участвуют.

Как отключить источник курса

Чтобы источник перестал участвовать в расчёте:

• очистите выбранную пару в соответствующем поле;
• для ручного курса очистите значение или установите 0;
• для BestChange API выключите или удалите связь пары на странице «BestChange API».

После изменения нажмите «Сохранить».

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

Вернитесь в:

«Основное» — «Направления обмена» — «Список направлений»

Найдите нужное направление и откройте действие:

«Как сформирован курс»

В окне «Формирование курса» можно проверить:

• курс в списке направлений;
• значение, используемое для расчёта;
• выбранный источник;
• приоритет связанных источников;
• причины пропуска других источников;
• время последнего обновления;
• применённые изменения;
• последующие этапы формирования курса.

После этого откройте направление на публичном сайте и проверьте расчёт:

• при вводе суммы «Отдаю»;
• при вводе суммы «Получаю».

---

Страховка курса

Откройте: «Обмен» — «Страховка курса»

Страховка сравнивает сформированный курс направления с отдельным контрольным курсом.

При опасном отклонении система может:

• применить безопасный базовый курс;
• ограничить курс по рассчитанной границе;
• отключить направление.

Страховка поддерживает:

• отдельный контрольный источник;
• верхнюю и нижнюю защиту;
• минимальный абсолютный порог;
• несколько проверок подряд;
• уведомления;
• диагностику;
• историю срабатываний.

Страховка курса

---

BestChange API

Откройте: «Обмен» — «BestChange API»

Раздел связывает текущее направление с парой BestChange и позволяет настроить получение курса из мониторинга.

BestChange

Города

Откройте: «Обмен» — «Города»

Раздел используется для наличных и других географически зависимых направлений.

Наличные обмены

Кратность

Откройте: «Обмен» — «Кратность»

Кратность ограничивает допустимые суммы заданным шагом.

Например, при кратности:

100

клиент сможет указать:

100
200
300
1 000

но не сможет указать:

150
250
1 050

Кратность поддерживает целые и десятичные значения:

10
0,5
0,01

Тип суммы обмена

Поле определяет, какую сторону проверяет система.

Доступны два варианта:

• «Сумма Отдаю» — проверяется сумма, которую клиент отдаёт;
• «Сумма Получаю» — проверяется рассчитанная или введённая сумма получения.

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

Сохранённое значение шага и текст ошибки не применяются, пока не выбран тип суммы.

Кратность суммы обмена

Поле содержит положительный шаг, которому должна соответствовать выбранная сумма.

Значение должно быть больше 0.

Примеры:

Тип суммы	Кратность	Допустимые значения	Недопустимые значения
Сумма «Отдаю»	100	100, 200, 1 500	150, 1 550
Сумма «Получаю»	0,5	0,5, 1, 2,5	0,7, 2,75
Сумма «Отдаю»	0,01	0,01, 0,10, 1,25	0,015, 1,255

Проверка выполняется с точной десятичной арифметикой.

Например, значение:

0,3

при шаге:

0,1

будет распознано корректно.

Сообщение в случае ошибки

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

Пример:

Сумма «Отдаю» должна быть кратна 100 RUB.

Допустимые примеры: 100, 200, 300 или 1 000 RUB.

Заполните сообщение для всех языков, доступных клиентам.

Сообщение необходимо заполнять обязательно. Клиент должен понимать, почему сумма не принимается и как её исправить.

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

1. Клиент вводит сумму.
2. Система рассчитывает обе стороны направления.
3. Проверяется сторона, выбранная в поле «Тип суммы обмена».
4. Если сумма делится на шаг без остатка, клиент может продолжить.
5. Если сумма не соответствует кратности, показывается настроенное сообщение.
6. Создание заявки блокируется до исправления суммы.

При выборе «Сумма Получаю» проверяется именно сумма получения.

Как отключить кратность

1. Откройте «Обмен» — «Кратность».
2. Очистите поле «Тип суммы обмена».
3. Нажмите «Сохранить».

Установка шага 0 также делает проверку нерабочей, но правильный способ отключения — очистить тип суммы.

Как проверить кратность

После сохранения откройте направление на публичном сайте.

Проверьте:

1. Сумму, равную одному шагу.
2. Сумму, равную нескольким шагам.
3. Сумму между допустимыми значениями.

Пример при шаге 100:

Сумма	Результат
100	Допустима
200	Допустима
150	Ошибка
250	Ошибка

Для недопустимого значения должно появиться настроенное сообщение, а создание заявки должно быть заблокировано.

---

Ограничение курса

Откройте: «Обмен» — «Ограничение курса»

Раздел проверяет диапазон базового курса и при необходимости переключает расчёт на резервный источник.

Как работает ограничение

Система:

1. Выбирает основной источник согласно приоритету.
2. Получает от него курс.
3. Применяет внутренние корректировки источника.
4. Сравнивает результат с минимальной и максимальной границей.
5. При выходе за диапазон пытается получить резервный курс.
6. Применяет процентное добавление к резервному значению.
7. Передаёт результат на следующие этапы расчёта.

Проверка выполняется до большинства последующих комиссий, скидок и страховки.

Поэтому курс на публичном сайте может отличаться от значения, которое сравнивалось с границами.

Мин. курс

Нижняя допустимая граница.

• 0 — нижняя проверка отключена;
• значение больше 0 — основной курс должен быть равен минимуму или превышать его.

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

Пример:

Мин. курс: 90

Курс	Результат
89	Ниже границы
90	Допустим
91	Допустим

Макс. курс

Верхняя допустимая граница.

• 0 — верхняя проверка отключена;
• значение больше 0 — основной курс должен быть равен максимуму или быть ниже него.

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

Пример:

Макс. курс: 100

Курс	Результат
99	Допустим
100	Допустим
101	Выше границы

Можно использовать только одну границу.

Например:

Мин. курс: 90
Макс. курс: 0

В этом случае контролируется только падение курса.

Или:

Мин. курс: 0
Макс. курс: 100

В этом случае контролируется только рост.

Если заполнены обе границы, минимум должен быть меньше или равен максимуму.

Не устанавливайте минимальный курс выше максимального. В таком диапазоне ни одно значение не сможет считаться допустимым.

Сбросить на курс

Поле выбирает резервную пару из курсов из источников.

Резервный курс применяется при одновременном выполнении двух условий:

1. основной курс находится ниже минимума или выше максимума;
2. выбранный резервный источник возвращает положительное значение.

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

Если основной курс вышел за границы, но резервный источник не выбран, система оставляет исходный курс без изменения.

При этом:

• направление не отключается;
• заявка не блокируется;
• курс не заменяется минимумом или максимумом.

Название «Ограничение курса» не означает жёсткий запрет.

Этот раздел переключает расчёт на резервный источник. Для автоматического отключения направления используйте «Страховку курса».

Добавить к курсу

Поле появляется после выбора резервного источника.

Оно увеличивает резервный курс на указанный процент.

• 0 — резервный курс используется без изменения;
• положительное значение — курс увеличивается;
• отрицательное значение — не применяется.

Корректировка используется только при фактическом переходе на резервный источник.

Пример с двумя границами

Настроено:

Минимальный курс: 95
Максимальный курс: 105
Резервный курс: 98
Добавить к курсу: 2%

Результат:

Основной курс	Состояние	Применённый результат
94	Ниже минимума	98 + 2% = 99,96
95	Равен минимуму	95
100	В диапазоне	100
105	Равен максимуму	105
106	Выше максимума	98 + 2% = 99,96

Пример только с минимальной границей

Настроено:

Минимальный курс: 90
Максимальный курс: 0
Резервный курс: 92
Добавить к курсу: 0%

Результат:

• курс 89 будет заменён на 92;
• курс 90 останется без изменения;
• курс 150 останется без изменения, потому что верхняя граница выключена.

Пример без резервного источника

Настроено:

Минимальный курс: 95
Максимальный курс: 105
Сбросить на курс: не выбран

Если основной курс станет равен 110, система обнаружит выход за диапазон, но оставит значение 110.

Заполнение только минимума и максимума без резервного курса не создаёт защитного действия.

Как отключить ограничение курса

1. Откройте «Обмен» — «Ограничение курса».
2. Установите «Мин. курс» равным 0.
3. Установите «Макс. курс» равным 0.
4. При необходимости очистите поле «Сбросить на курс».
5. Нажмите «Сохранить».

При значениях:

0
0

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

Как проверить ограничение курса

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

1. Запомните текущий основной курс.
2. Установите границы так, чтобы курс находился внутри диапазона.
3. Убедитесь, что резервный источник не применился.
4. Измените границу так, чтобы основной курс оказался вне диапазона.
5. Проверьте переход на резервный источник.
6. Проверьте процентное добавление.
7. Верните рабочие границы.
8. Нажмите «Сохранить».
9. Откройте «Как сформирован курс».
10. Проверьте результат на публичном сайте.

---

Порядок применения настроек

В упрощённом виде курс формируется следующим образом:

1. Система выбирает первый доступный источник по установленному приоритету.
2. Применяются внутренние настройки выбранного источника.
3. «Ограничение курса» сравнивает полученный результат с установленными границами.
4. При выходе за диапазон система может перейти на резервный внешний курс.
5. Применяются прибыль, комиссии, скидки и другие расчётные параметры.
6. «Страховка курса» проверяет сформированный курс и выполняет защитное действие.
7. «Кратность» отдельно проверяет сумму клиента.

BestChange API участвует на первом этапе как один из источников курса.

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

Частые ошибки

Выбран один источник, но используется другой

Что происходит

В направлении выбран ручной курс, формула или файл, но система использует другой источник.

Почему возникает

Одновременно доступен источник с более высоким приоритетом.

Что проверить

Откройте действие «Как сформирован курс» и проверьте:

• выбранный источник;
• приоритет;
• связанные записи;
• причины пропуска остальных источников.

Как исправить

Очистите лишние привязки или отключите ненужный источник.

Ручной курс не применяется

Что происходит

Введённое значение не используется в калькуляторе.

Почему возникает

Возможные причины:

• курс равен 0;
• указано отрицательное значение;
• введён неправильный формат;
• доступен более приоритетный источник.

Как исправить

Укажите положительное значение и отключите более приоритетные источники, если требуется использовать ручной курс.

Отрицательная корректировка не уменьшает курс

Что происходит

В поле «Добавить к курсу» указано отрицательное значение, но курс не изменился.

Почему возникает

Текущая логика этих полей применяет только положительные корректировки.

Как исправить

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

Курс вышел за границы, но не изменился

Что происходит

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

Почему возникает

В поле «Сбросить на курс» не выбран рабочий резервный источник.

Минимум и максимум сами по себе не заменяют курс.

Что проверить

Проверьте:

• выбран ли резервный источник;
• активен ли он;
• возвращает ли он положительный курс;
• актуальны ли его данные.

Как исправить

Подключите рабочий резервный источник либо используйте страховку с действием «Отключить направление».

Резервный курс применяется постоянно

Что происходит

Система почти всегда переходит на резервный источник.

Почему возникает

Возможные причины:

• минимальная граница слишком высокая;
• максимальная граница слишком низкая;
• минимум больше максимума;
• границы указаны в обратном представлении курса.

Как исправить

Проверьте реальный базовый курс через «Как сформирован курс» и установите границы в том же формате.

---

Рекомендации

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

• использовать один основной источник и независимый резервный;
• не подключать лишние источники без понимания приоритета;
• регулярно проверять дату последнего обновления;
• контролировать итог через «Как сформирован курс»;
• не оставлять ручной курс без наблюдения;
• использовать ограничение курса только вместе с резервным источником;
• использовать страховку для жёсткого отключения направления;
• проверять курс с позиции клиента;
• заполнять сообщение кратности для всех языков;
• тестировать точные границы;
• создавать новую заявку после существенных изменений.

Коротко

Группа «Обмен» отвечает за получение и защиту курса направления.

Раздел «Курс обмена» определяет основной источник и его корректировки.

BestChange API, формула, ручной курс, файл и курс конкурента участвуют в расчёте согласно установленному приоритету.

Раздел «Ограничение курса» переключает расчёт на резервный источник при выходе основного курса за допустимые границы.

Раздел «Кратность» ограничивает допустимые суммы заданным шагом.

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

После настройки обязательно проверьте источник, границы, кратность, итоговый курс и создание тестовой заявки.