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

Резервы для валют

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

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

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

Где находится раздел

Откройте панель управления и перейдите в раздел:

«Основное» — «Резервы для валют» — «Список резервов»

В списке отображаются резервы всех валют, которые не находятся в архиве.

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

Права доступа

Для управления резервами пользователю необходимо право:

«Разрешить управление резервами в админпанели»

Права настраиваются в разделе: «Пользователи» — «Список групп пользователей»

Откройте нужную группу и перейдите к редактированию её прав.

Для изменения связанных параметров также могут потребоваться права:

  • «Разрешить управление валютами в админпанели»;

  • «Разрешить доступ к направлениям в админпанели».

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

Для чего используются резервы

Резервы участвуют в следующих процессах:

  • проверка доступности обмена;

  • расчёт максимально доступной суммы;

  • отображение остатка на клиентском сайте;

  • ограничение создания заявок при недостатке средств;

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

  • возврат удержанной суммы;

  • пополнение резерва после выполнения заявки;

  • ведение истории движения средств;

  • объединение нескольких валют в общий баланс;

  • загрузка остатков из внешнего файла;

  • использование отдельного резерва для направления;

  • проверка лимитов валют и направлений.

Например, если клиент хочет получить 5 000 USDT, а доступный резерв составляет только 3 000 USDT, система не позволит создать такую заявку.


Какие виды резервов поддерживаются

В iEXExchanger используются несколько вариантов работы с резервами.

Вид резерва
Как работает

Обычный резерв

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

Общий резерв

Несколько валют используют один корневой баланс

Фиксированный резерв

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

Резерв из файла

Сумма обновляется из внешнего текстового файла

Индивидуальный резерв направления

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

1

Обычный резерв валюты

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

Например:

При создании и выполнении заявок система может:

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

  • возвращать удержанную сумму;

  • добавлять сумму валюты «Отдаю»;

  • корректировать резерв после пересчёта заявки.

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

2

Общий резерв

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

Например:

Если фактически все сети обеспечиваются одним общим запасом 100 000 USDT, создавать отдельный резерв 100 000 для каждой сети неправильно.

Без общей связи система могла бы показывать:

Визуально это создаёт резерв 300 000 USDT, хотя реально доступно только 100 000 USDT.

Правильная схема:

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

3

Фиксированный резерв

Фиксированный резерв не изменяется стандартными операциями по статусам заявок.

Он подходит для случаев, когда сумма поддерживается вручную или контролируется внешней логикой.

Менеджер всё равно может:

  • изменить сумму вручную;

  • добавить сумму через «Добавить резерв»;

  • загрузить новое значение из файла.

4

Резерв из файла

Резерв из файла получает сумму из внешнего текстового источника.

Такой вариант подходит, если остатки обновляются:

  • из внешней бухгалтерской системы;

  • из собственного кошелька;

  • из отдельного сервиса;

  • из автоматизированного файла резервов.

При синхронизации значение в iEXExchanger заменяется суммой из файла.

5

Индивидуальный резерв направления

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

Например, общий резерв USDT может составлять:

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

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

В этом случае направление использует своё значение и не учитывает общий резерв валюты.


Что отображается в списке резервов

На странице отображаются основные данные по каждому корневому резерву.

Колонка
Что означает

Валюта

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

Резерв

Текущая сохранённая сумма

Фиксация

Изменяется ли резерв автоматически по заявкам

Связи

Валюты, использующие этот резерв

Последнее изменение

Дата последнего обновления

Действия

История, редактирование и удаление

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

Какие значения используются при расчёте

При работе с резервами важно различать несколько значений:

  • сохранённую сумму;

  • заблокированную сумму;

  • доступный резерв;

  • эффективный резерв;

  • отображаемый резерв.

1

Сохранённая сумма

Это значение, указанное в карточке резерва.

Пример:

Сохранённая сумма может изменяться:

  • вручную;

  • по статусам заявок;

  • через файловую синхронизацию;

  • через дополнительные корректировки.

2

Заблокированная сумма

Часть резерва может быть временно заблокирована системой.

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

Например:

3

Доступный резерв

Доступный резерв рассчитывается так:

Пример:

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

4

Эффективный резерв

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

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

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

Пример:

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

5

Отображаемый резерв

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

Пример:

Ограничение отображения:

  • не уменьшает фактический резерв;

  • не списывает средства;

  • не создаёт отдельный баланс;

  • не заменяет внутреннюю проверку доступности.

Как добавить сумму к резерву

На странице резервов нажмите: «Добавить резерв»

Заполните:

  • «Валюта»;

  • «Сумма».

Нажмите «Добавить».

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

Пример:

Кнопка «Добавить резерв» не заменяет существующую сумму.

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

Формат суммы

Разрешены целые и дробные значения:

Запятая автоматически преобразуется в точку.

Не указывайте:

Не добавляйте код валюты, пробелы и разделители тысяч.

Быстрое изменение суммы

Сумму можно изменить непосредственно в колонке «Резерв».

  1. Нажмите на текущее значение.

  2. Введите новую сумму.

  3. Нажмите Enter или завершите редактирование.

В этом случае новое значение полностью заменяет предыдущее.

Пример:

Защита от одновременного изменения

Система отслеживает параллельное редактирование.

Если другой менеджер уже изменил резерв, появится сообщение:

Резерв уже изменён. Данные обновлены — повторите действие.

После этого:

  1. проверьте актуальную сумму;

  2. убедитесь, что новое изменение всё ещё требуется;

  3. повторно укажите значение;

  4. сохраните данные.

Это защищает более новое значение от случайной перезаписи.

Полное редактирование резерва

Чтобы открыть карточку, нажмите на название валюты.

В форме доступны:

  • «Сумма»;

  • «Фиксированный резерв»;

  • «Комментарий»;

  • «Резерв из файла»;

  • «Использовать резерв».

1

Сумма

Поле «Сумма» устанавливает точное значение резерва.

Пример:

2

Комментарий

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

Примеры:

Комментарий сохраняется в истории вместе с операцией изменения суммы.

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

Фиксированный резерв

Параметр «Фиксированный резерв» отключает стандартное автоматическое движение суммы по заявкам.

1

Если фиксация выключена

Резерв может автоматически:

  • уменьшаться при удержании суммы;

  • увеличиваться после выполнения заявки;

  • восстанавливаться при возврате;

  • корректироваться после пересчёта.

2

Если фиксация включена

Стандартные операции заявки не изменяют резерв:

  • сумма «Получаю» не удерживается;

  • сумма «Отдаю» не добавляется;

  • удержание не возвращается;

  • пересчёт не корректирует сумму.

3

Что фиксация не блокирует

Даже фиксированный резерв можно:

  • изменить вручную;

  • пополнить через «Добавить резерв»;

  • обновить из файла.

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

Рекомендуемый порядок:

  1. завершите или отмените активные заявки;

  2. проверьте историю операций;

  3. сверьте фактический остаток;

  4. установите правильную сумму;

  5. только после этого измените режим фиксации.

4

Массовая фиксация

Отметьте нужные резервы в списке.

Доступны действия:

  • «Зафиксировать»;

  • «Разблокировать».

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

Фиксация дочернего резерва не влияет на общую группу, пока дочерняя валюта использует баланс родителя.


Как создать общий резерв

Чтобы привязать валюту к другому резерву:

  1. Откройте резерв дочерней валюты.

  2. Найдите поле «Использовать резерв».

  3. Выберите основной резерв.

  4. Нажмите «Сохранить».

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

Пример:

1

Цепочки связанных резервов

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

Пример:

Корневым считается последний резерв цепочки:

Именно его сумма используется всеми валютами в группе.

Система не позволит:

  • привязать резерв к самому себе;

  • создать циклическую связь;

  • выбрать несуществующий резерв;

  • создать цепочку, которая возвращается к исходной валюте.

2

Собственная сумма дочерней валюты

При создании связи собственная сумма дочерней валюты не удаляется.

Пример:

Пока связь активна, изменение собственной суммы USDT ERC20 не изменит общий баланс группы.

После отвязки валюта снова начнёт использовать собственные 20 000 USDT.

Поэтому перед отвязкой обязательно проверьте её сохранённую сумму.

3

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

Откройте колонку «Связи» у корневого резерва.

Найдите нужную валюту и нажмите:

«Отвязать»

После отвязки:

  • валюта становится самостоятельной;

  • начинает использовать собственную сумму;

  • её дочерние резервы остаются привязанными к ней.

4

Фиксация связанных резервов

Автоматические операции выполняются с корневым резервом.

Поэтому:

  • фиксация корня влияет на всю группу;

  • фиксация дочернего резерва не влияет на общий баланс;

  • файл общего резерва лучше подключать к корню;

  • история основных операций записывается по корневому резерву.


Включение резервов из файла

На странице «Резервы для валют» нажмите: «Настройки»

Включите параметр: «Резерв из файла»

После этого появится раздел: «Основное» — «Резервы для валют» — «Резервы из файла»

Резервы из файла

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

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

Основные операции:

  • удержание суммы «Получаю»;

  • пополнение валюты «Отдаю»;

  • возврат удержания;

  • корректировка после пересчёта.

Удержание суммы «Получаю»

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

Например, при статусах:

  • «Ожидает обработки»;

  • «Оплаченная заявка».

Пример:

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

Пополнение резерва «Отдаю»

После перехода заявки в статус: «Заявка выполнена»

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

Пример:

Возврат удержанной суммы

Если заявка была удержана, а затем перешла в отклонённое, замороженное, некорректное или удалённое состояние, сумма возвращается в резерв «Получаю».

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

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

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

Пример уменьшения:

Пример увеличения:

Общий резерв и заявки

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

Пример:

Если клиент получает USDT ERC20, сумма будет удержана с резерва USDT TRC20.

Индивидуальный резерв направления

Чтобы использовать отдельный резерв для направления, откройте:

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

Выберите направление, затем перейдите: «Дополнительное» — «Резервы»

Тип резерва направления

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

Тип
Как работает

По умолчанию

Используется эффективный резерв валюты «Получаю»

Индивидуальное поле

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

После выбора «Индивидуальное поле» появится настройка: «Поле для резерва»

Укажите доступную сумму для этого направления.

Особенности индивидуального резерва

Индивидуальный резерв:

  • не использует резерв валюты;

  • не использует общий корневой резерв;

  • не обновляется по статусам заявок;

  • не загружается из файла валюты;

  • контролируется менеджером вручную.

Если значение устарело, система продолжит использовать сохранённую сумму.

Поэтому такие резервы необходимо регулярно проверять.


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

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

Для обычного режима:

Для индивидуального режима:

Пример:

Заявка не будет создана.

Почему заявка не создаётся при положительном резерве

Проверьте:

  1. какой резерв используется — собственный или общий;

  2. правильно ли определён корень;

  3. нет ли заблокированной суммы;

  4. не включён ли индивидуальный резерв;

  5. актуально ли значение индивидуального поля;

  6. не устарел ли файловый резерв;

  7. не достигнуты ли лимиты валюты;

  8. не достигнуты ли лимиты направления;

  9. правильно ли настроены минимальные и максимальные суммы;

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

Резерв, лимиты и ограничения суммы заявки — разные механизмы.

1

Настройки резерва в валюте

Откройте:

«Основное» — «Валюты» — «Список валют»

Выберите валюту и перейдите:

«Дополнительное» — «Резервы и лимиты»

2

Максимальная сумма резерва — «Отдаю»

Параметр ограничивает приём валюты, когда её эффективный резерв превышает установленное значение.

Пример:

Система может запретить новую заявку, в которой RUB используется на стороне «Отдаю».

Параметр не запрещает вручную установить резерв выше лимита.

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

3

Максимальное отображаемое значение

Ограничивает сумму, передаваемую на клиентский сайт.

Пример:

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

4

Дополнительный процент, снимаемый с резерва

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

Пример:

Настройку можно использовать для учёта:

  • внутренних расходов;

  • комиссии;

  • потерь при переводе;

  • дополнительной маржи.

5

Лимиты заявок за час

Можно ограничить количество заявок одного зарегистрированного клиента за последний час.

Доступны:

  • «Кол-во заявок со статусом “Ожидается оплата” за час»;

  • «Кол-во заявок со статусом “В процессе оплаты” за час».

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

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

6

Дневные и месячные лимиты валюты

Можно установить:

  • дневной лимит для «Отдаю»;

  • дневной лимит для «Получаю»;

  • месячный лимит для «Отдаю»;

  • месячный лимит для «Получаю».

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

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

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

7

Комиссия от перевода

Доступны:

  • процентная комиссия;

  • фиксированная комиссия в валюте.

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

Эти параметры участвуют в расчётах, но не устанавливают сумму резерва напрямую.

8

Лимиты направления

Откройте:

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

Выберите направление и перейдите:

«Дополнительное» — «Ограничения и проверки»

В блоке «Лимиты» доступны:

  • «Лимит резерва для направления»;

  • «Лимит резерва в сутки»;

  • «Лимит резерва в месяц».

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

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

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

Лимит резерва для направления

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

Лимит резерва в сутки

Учитывает выполненные заявки за текущий календарный день.

Лимит резерва в месяц

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

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

При достижении точного значения новая заявка также отклоняется.

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

Настройки раздела резервов

На странице резервов нажмите: «Настройки»

Доступны:

  • максимальное количество знаков после запятой;

  • включение резервов из файла.

Максимальная точность расчётов

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

По умолчанию:

Система учитывает:

  • точность валюты;

  • глобальный предел раздела резервов.

Используется меньшее значение.

Для криптовалют может потребоваться больше знаков, чем для фиатных валют.

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

Сортировка резервов

На странице нажмите: «Сортировка резервов»

Перетащите корневые резервы в нужном порядке.

Порядок сохраняется автоматически.

Дочерние валюты:

  • отображаются внутри корня;

  • отдельно не сортируются;

  • перемещаются только изменением связи.

История резерва

Возле нужного резерва нажмите: «История резерва»

В истории отображаются:

  • дата операции;

  • номер заявки;

  • направление;

  • тип операции;

  • сумма изменения;

  • баланс до операции;

  • баланс после операции.

Типы операций

Операция
Что означает

Отправлено клиенту

Резерв валюты «Получаю» уменьшен

Возврат в резерв

Удержанная сумма возвращена

Пополнен резерв

Резерв валюты «Отдаю» увеличен

Ручная корректировка

Сумма изменена менеджером

Операция

Служебное или файловое изменение

История в заявке

Чтобы посмотреть движения по конкретной заявке, откройте: «Заявки» — «Список заявок»

Выберите заявку и найдите блок: «История резервов»

В нём отображаются:

  • удержания;

  • возвраты;

  • пополнения;

  • суммы до и после операции.

Аналитика резервов

Для общей аналитики откройте: «Аналитика» — «Аналитика обменов»

Используйте разделы:

  • «Резервы»;

  • «Движение резервов».

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

Очистка истории

Срок хранения настраивается по пути:

«Настройки» — «Общие настройки» — «Дополнительно» — «Настройки логов»

Найдите блок: «История резервов»

Перед удалением подробных операций система должна сформировать дневные итоговые данные.

Если итоговые данные отсутствуют, подробная история сохраняется.

Не устанавливайте слишком короткий срок, если история нужна для:

  • финансовых сверок;

  • расследования спорных заявок;

  • проверки действий менеджеров;

  • аудита движения средств.

Ограничения удаления

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

Сначала:

  • отвяжите дочерние резервы;

  • привяжите их к другому корню;

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

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

Почему резерв появляется снова

Удаление резерва не архивирует валюту.

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

Чтобы полностью вывести валюту из работы, измените её статус или переместите в архив.

Диагностика резервов

Откройте: «Утилиты» — «Диагностика системы»

Запустите этап: «Баланс системы и резервы»

Диагностика проверяет:

  • наличие резерва у активных валют;

  • отрицательные суммы;

  • заблокированные значения;

  • превышение блокировки над резервом;

  • дубликаты резервов;

  • математическую корректность истории;

  • совпадение текущей суммы с последней операцией;

  • связанные резервы;

  • циклические связи;

  • целостность внутренних данных.


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

На сайте отображается нулевой резерв

Проверьте:

  • сумму корневого резерва;

  • заблокированную часть;

  • связь с родителем;

  • индивидуальный резерв направления;

  • файловый источник;

  • максимальное отображаемое значение;

  • активность валюты и направления.

Ручная сумма постоянно перезаписывается

Скорее всего, резерв связан с файловым ключом.

Чтобы остановить обновление:

  • удалите привязку к файлу;

  • либо измените значение в источнике.

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

Это штатная работа общего резерва.

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

Резерв не изменяется после заявки

Проверьте:

  • включена ли фиксация;

  • используется ли индивидуальный резерв;

  • достигла ли заявка нужного статуса;

  • какая валюта является «Отдаю»;

  • какая валюта является «Получаю»;

  • используется ли общий корень;

  • есть ли операция в истории.

Резерв изменился сильнее ожидаемого

Проверьте:

  • дополнительный процент;

  • пересчёт заявки;

  • другие заявки общей группы;

  • файловую синхронизацию;

  • ручные изменения;

  • историю операций.

Нельзя удалить резерв

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

Откройте колонку «Связи» и отвяжите их.

После удаления резерв появился снова

Валюта остаётся активной.

Система создала для неё новую запись с нулевой суммой.

Заявка не создаётся, хотя сумма положительная

Проверьте:

  • доступный, а не сохранённый резерв;

  • заблокированную сумму;

  • общий корень;

  • индивидуальный резерв;

  • лимиты валюты;

  • лимиты направления;

  • минимальные и максимальные суммы;

  • актуальность файлового значения.

Рекомендуемый порядок настройки

  1. Определите фактические независимые балансы.

  2. Создайте отдельный резерв для каждой независимой валюты.

  3. Объедините валюты, которые используют один реальный баланс.

  4. Выберите понятный корневой резерв.

  5. Проверьте собственные суммы дочерних валют.

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

  7. Оставьте резерв изменяемым, если движение должно учитываться автоматически.

  8. Не включайте фиксацию при активных заявках.

  9. Установите точность расчётов.

  10. Настройте максимальное отображаемое значение.

  11. Проверьте лимиты валют и направлений.

  12. Создайте тестовые заявки.

  13. Проверьте удержание.

  14. Проверьте возврат.

  15. Проверьте пополнение.

  16. Откройте историю операций.

  17. Запустите диагностику.

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

Убедитесь, что:

  • у каждой рабочей валюты есть резерв;

  • суммы соответствуют фактическим остаткам;

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

  • у дочерних валют проверены собственные суммы;

  • фиксация настроена на корне;

  • файловые источники работают;

  • индивидуальные резервы актуальны;

  • отображаемое значение настроено правильно;

  • дневные и месячные лимиты не блокируют обмен;

  • дополнительный процент используется осознанно;

  • история операций формируется;

  • менеджерам выданы права;

  • диагностика не показывает критических ошибок.

Коротко

Резервы определяют, сколько средств обменник может принять или выдать клиентам.

Раздел находится по пути:

«Основное» — «Резервы для валют» — «Список резервов»

Доступный резерв рассчитывается так:

Связанные валюты используют баланс корневого резерва.

Фиксированный резерв не изменяется стандартными операциями по заявкам.

Резерв из файла обновляется внешним источником.

Индивидуальный резерв направления работает отдельно от валюты.

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

Последнее обновление

Это было полезно?