> 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/guide/nastroiki/obshie/balans-sistemy.md). # Баланс системы Раздел «Баланс системы» используется для настройки основной валюты внутреннего баланса пользователей и партнёров. Эта валюта применяется в партнёрских начислениях, бонусах, выплатах, ручных корректировках баланса и отображении баланса в админке и личном кабинете клиента. Важно: баланс системы не является резервом обменника. Это не остатки ваших кошельков, не баланс мерчантов и не резервы валют для обмена. Раздел отвечает именно за внутренний пользовательский баланс платформы. ## Где находится раздел Откройте административную панель: **«Настройки» — «Общие настройки» — «Основное» — «Баланс системы»**
Доступ к разделу зависит от прав администратора на управление системными настройками. ## Для чего нужен баланс системы Баланс системы определяет, в какой валюте платформа ведёт внутренние начисления и обязательства перед пользователями. Эта настройка используется для: * партнёрских начислений; * бонусных начислений; * выплат партнёрам; * заявок на выплату бонусов; * отображения баланса пользователя в админке; * отображения баланса в личном кабинете клиента; * конвертации сумм в основную валюту баланса; * ручного изменения баланса пользователя; * статистики и истории операций по балансу. Простыми словами: если у пользователя или партнёра есть внутренний баланс в системе, его валюта берётся из раздела «Баланс системы». ## Что не относится к балансу системы Раздел «Баланс системы» не отвечает за: * резервы валют; * остатки кошельков; * балансы мерчантов; * балансы автовыплат; * реальные средства на платёжных аккаунтах; * резервы направлений обмена. Например, если в системе выбран баланс USD, это не значит, что у обменника есть резерв USD. Это означает только то, что внутренние начисления и балансы пользователей будут отображаться и рассчитываться в USD. ## Что находится в разделе В разделе доступны основные настройки: 1. Основная валюта баланса 2. Альтернативные коды валют 3. История изменений 4. Диагностика расчётов *** ## Основная валюта баланса Основная валюта баланса определяет, в какой валюте система будет вести внутренний баланс пользователей и партнёров. Пример: **Основная валюта баланса: USD** В этом случае партнёрские начисления, бонусный баланс и баланс пользователя будут отображаться в USD. Другой пример: **Основная валюта баланса: USDT** В этом случае основной баланс будет считаться и отображаться в USDT. ### Где выбрать основную валюту Откройте: **«Настройки» — «Общие настройки» — «Основное» — «Баланс системы»** В блоке **«Основная валюта баланса»** выберите нужный код валюты из списка. Список берётся из справочника кодов валют. Если нужной валюты нет в списке, сначала добавьте её в разделе: **«Основное» — «Коды валют»**
После выбора валюты нажмите **«Сохранить»**. *** ## Где используется основная валюта Основная валюта баланса используется в разных частях системы.
Где используетсяЧто означает
Список пользователейБаланс пользователя отображается в основной валюте
Карточка пользователяБаланс и ручные корректировки ведутся в основной валюте
Партнёрская программаВознаграждения приводятся к основной валюте
Бонусный центрБонусы начисляются и отображаются через баланс
Заявки на выплатуСистема берёт доступный баланс пользователя
Личный кабинетКлиент или партнёр видит баланс в выбранной валюте
Аналитика балансаИстория операций строится в основной валюте
## Почему не стоит менять валюту без необходимости Основную валюту баланса лучше выбрать один раз при первичной настройке проекта. Если проект уже работает и в системе есть начисления, смена валюты может запутать: * отображение балансов; * историю операций; * партнёрские начисления; * бонусы; * заявки на выплату; * статистику и аналитику. Пример: ``` Раньше баланс был в USD. Потом валюту изменили на USDT. ``` Визуально значения могут быть похожими, но для системы это уже другой код валюты. Если курсы и альтернативные коды настроены неправильно, пересчёты могут работать не так, как ожидается. *** ## Когда можно менять основную валюту Менять основную валюту можно, если: * проект ещё не запущен; * партнёрские начисления ещё не выполнялись; * бонусный центр ещё не использовался; * пользователям ещё не начислялся внутренний баланс; * нет активных заявок на выплату; * вы точно понимаете, как новая валюта будет использоваться в выплатах и статистике. Если проект уже работает, перед сменой валюты проверьте: * есть ли пользователи с балансом; * есть ли активные заявки на выплату бонусов; * есть ли начисления бонусного центра; * есть ли партнёрские начисления; * есть ли корректные курсы для пересчёта в новую валюту. ## Альтернативные коды валют Альтернативные коды валют помогают системе найти курс, если прямой курс к основной валюте не найден. Это дополнительная настройка. Заполнять её нужно только при необходимости. ### Простыми словами Допустим, основная валюта баланса: ``` USD ``` Клиент сделал обмен в BTC. Системе нужно найти курс: ``` BTC → USD ``` Если прямого курса нет, система может попробовать альтернативные варианты, например: ``` BTC → USDT BTC → USDC ``` Если такой курс найден, система сможет выполнить расчёт. ### Когда нужны альтернативные коды Альтернативные коды стоит добавлять, если: * основная валюта баланса USD, но курсы чаще есть к USDT; * в источниках курсов используется USDT вместо USD; * часть расчётов идёт через USDC; * партнёрские начисления не могут найти курс; * диагностика показывает проблемы с поиском курса; * в системе есть несколько близких расчётных кодов одной валютной группы. ### Когда альтернативные коды не нужны Не добавляйте альтернативные коды просто “на всякий случай”. Они не нужны, если: * все нужные курсы уже находятся напрямую; * вы не используете партнёрские начисления или бонусы; * баланс работает только в одной валюте; * нет проблем с расчётом бонусов и выплат; * вы не уверены, что альтернативный код действительно подходит. Нельзя добавлять валюты, которые не являются близкой расчётной заменой. Плохой пример: ``` Основная валюта: USD Альтернативные коды: BTC, ETH ``` BTC и ETH не являются альтернативными обозначениями USD. Такая настройка может привести к неправильным расчётам. *** ## Как добавить альтернативные коды Откройте: **«Настройки» — «Общие настройки» — «Основное» — «Баланс системы»** В поле **«Альтернативные коды валют»** введите нужные коды и сохраните настройки. Пример: ``` USDT USDC BUSD ``` Система автоматически нормализует значения: * убирает лишние пробелы; * переводит буквы в верхний регистр; * удаляет неподходящие символы; * не сохраняет одинаковые коды повторно. *** ## Примеры настройки ### Баланс в USD Подходит, если вы хотите вести партнёрские начисления и бонусы в условной долларовой валюте. ``` Основная валюта баланса: USD Альтернативные коды: USDT, USDC ``` Так система считает USD основной валютой баланса, но при поиске курса сможет использовать пары через USDT или USDC. *** ### Баланс в USDT Подходит, если проект фактически работает через USDT и партнёрские выплаты чаще выполняются в криптовалюте. ``` Основная валюта баланса: USDT Альтернативные коды: USD, USDC ``` Такой вариант можно использовать, если расчёты в проекте привязаны к USDT, но часть курсов доступна через USD или USDC. *** ## История изменений В разделе есть кнопка истории изменений. История показывает последние изменения основной валюты баланса и альтернативных кодов. В истории можно увидеть: * кто изменил настройки; * когда было изменение; * какая валюта была до изменения; * какая валюта стала после изменения; * какие альтернативные коды были указаны; * IP и технические данные изменения. История полезна, если нужно понять, почему изменились расчёты или почему баланс начал отображаться в другой валюте. *** ## Диагностика расчётов Диагностика помогает проверить, сможет ли система находить курсы для расчётов баланса. Она показывает: * сколько валют проверено; * сколько расчётов прошло 1 к 1; * где курс найден; * где использовался альтернативный код; * где есть проблемы; * какой источник курса использован; * какая пара валют фактически применялась. Диагностику особенно полезно запускать после изменения основной валюты или альтернативных кодов. *** ### Что значит расчёт 1 к 1 Если валюта операции совпадает с основной валютой баланса, пересчёт не нужен. Пример: ``` Основная валюта баланса: USD Валюта операции: USD ``` Система считает: ``` 1 USD = 1 USD ``` Такой расчёт отображается как 1 к 1. *** ### Что значит “курс найден” Если валюта операции отличается от основной валюты баланса, системе нужен курс. Пример: ``` BTC → USD ``` Если курс найден в источниках, система сможет пересчитать сумму в основную валюту баланса. *** ### Что значит “использован fallback” Fallback означает, что система не смогла найти курс по основному коду и попробовала альтернативный код. Пример: ``` Основная валюта: USD Альтернативный код: USDT ``` Если курс: ``` BTC → USD ``` не найден, но найден: ``` BTC → USDT ``` система может использовать альтернативный путь. *** ## Если диагностика показывает проблемы Если диагностика показывает, что курс не найден, проверьте: 1. Есть ли нужный код валюты в справочнике кодов валют. 2. Есть ли источник курса для нужной пары. 3. Обновляются ли курсы через CRON. 4. Правильно ли указаны альтернативные коды. 5. Не добавлены ли лишние или неправильные альтернативные коды. 6. Есть ли ручной внутренний курс у кода валюты, если он должен использоваться. 7. Не отключён ли источник курса. После исправления настроек снова запустите диагностику. *** ## Как баланс используется в партнёрской программе Когда партнёру начисляется вознаграждение, система приводит сумму к основной валюте баланса. Пример: ``` Клиент сделал обмен в BTC. Партнёр должен получить вознаграждение. Основная валюта баланса: USD. ``` Система ищет курс: ``` BTC → USD ``` Если прямого курса нет, пробует альтернативные коды: ``` BTC → USDT BTC → USDC ``` После пересчёта сумма начисляется на баланс партнёра. В личном кабинете партнёр увидит баланс в валюте, выбранной в разделе «Баланс системы». *** ## Как баланс используется при выплатах партнёрам Когда партнёр создаёт заявку на вывод бонусов, система берёт его доступный баланс в основной валюте. Пример: ``` Баланс партнёра: 120 USD Минимальная выплата: 100 ``` Партнёр может создать заявку на выплату. Если он выбирает валюту выплаты, отличную от основной валюты баланса, система может выполнить пересчёт по курсу. Пример: ``` Баланс: 120 USD Выплата: USDT ``` Система пересчитает сумму в валюту выплаты, если для этого есть курс. *** ## Как баланс отображается у пользователей В списке пользователей и в карточке пользователя баланс отображается в основной валюте. Пример: ``` Основная валюта баланса: USD Баланс пользователя: 50 USD ``` Если выбрана USDT: ``` Основная валюта баланса: USDT Баланс пользователя: 50 USDT ``` Если основная валюта не настроена, в некоторых местах код валюты может не отображаться, а операции, где валюта обязательна, могут работать некорректно. *** ## Ручное изменение баланса пользователя Менеджер может вручную изменить баланс пользователя. При ручном изменении система использует основную валюту баланса. Пример: ``` Менеджер устанавливает баланс: 50 Основная валюта баланса: USD ``` Это означает: ``` 50 USD ``` Если основная валюта баланса USDT: ``` 50 USDT ``` Поэтому перед ручными изменениями важно понимать, какая валюта выбрана в разделе «Баланс системы». *** ## Как настроить баланс системы с нуля 1. Откройте **«Основное» — «Коды валют».** 2. Убедитесь, что нужный код валюты существует, например USD или USDT. 3. Перейдите в **«Настройки» — «Общие настройки» — «Основное» — «Баланс системы»**. 4. В поле «Основная валюта баланса» выберите нужный код. 5. Если нужно, добавьте альтернативные коды валют. 6. Нажмите «Сохранить». 7. Откройте диагностику. 8. Проверьте, есть ли проблемы с поиском курсов. 9. Если диагностика показывает ошибки, настройте источники курсов или исправьте альтернативные коды. 10. После этого можно использовать партнёрские начисления, бонусы и выплаты. ## Частые ошибки
Не выбрана основная валюта баланса Если основная валюта не выбрана, система может не понимать, в какой валюте показывать и рассчитывать баланс. Из-за этого могут возникать проблемы с: * партнёрскими начислениями; * бонусами; * выводом бонусов; * отображением баланса; * ручным изменением баланса.
Добавлены неправильные альтернативные коды Пример неправильной настройки: ``` Основная валюта: USD Альтернативные коды: BTC, ETH ``` Так делать не нужно. BTC и ETH не являются альтернативными обозначениями USD. Правильнее использовать близкие расчётные коды: ``` USD, USDT, USDC ```
Валюта выбрана, но курсы не находятся Проверьте источники курсов. Система должна иметь возможность найти курс между валютой операции и основной валютой баланса. Если прямого курса нет, можно использовать альтернативные коды, но они должны быть настроены осознанно.
Основную валюту поменяли после запуска Если поменять валюту после начислений и выплат, старые и новые данные могут стать сложнее для анализа. Перед сменой валюты проверьте: * историю балансов; * активные выплаты; * партнёрские начисления; * бонусные операции; * курсы для новой валюты.
*** ## Рекомендации Выберите основную валюту баланса на этапе первичной настройки проекта. Для большинства обменников удобно использовать одну из схем:
СхемаКогда подходит
USD + альтернативные USDT, USDCЕсли хотите вести баланс в условной долларовой валюте
USDT + альтернативные USD, USDCЕсли выплаты и расчёты чаще идут через USDT
Не добавляйте альтернативные коды без понимания, зачем они нужны. После настройки обязательно запустите диагностику. Перед изменением основной валюты на рабочем проекте проверьте, есть ли уже начисления, бонусы и заявки на выплату. *** ## Коротко Баланс системы — это основная валюта внутреннего баланса пользователей и партнёров. Она используется для бонусов, партнёрских начислений, выплат, ручных корректировок и отображения баланса. Это не резерв обменника и не баланс ваших кошельков. Основную валюту лучше выбрать один раз при запуске проекта. Альтернативные коды добавляются только при необходимости, чтобы система могла найти курс через близкое расчётное обозначение. После настройки проверьте диагностику, чтобы убедиться, что система корректно пересчитывает начисления, бонусы и выплаты. --- # 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, and the optional `goal` query parameter: ``` GET https://docs.iexexchanger.com/guide/nastroiki/obshie/balans-sistemy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.