> 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/obmen/valyuty/upravlenie-valyutami/obshee.md). # Общее Группа **«Общее»** содержит основные параметры валюты, настройки реквизитов и тексты, которые клиент видит на форме обмена и на странице созданной заявки. Эти параметры применяются во всех направлениях, где используется валюта. Например, одна и та же настройка реквизита может работать во всех парах, в которых валюта находится на стороне **«Отдаю»** или **«Получаю»**. Отдельные настройки направления, текстовых шаблонов, мерчантов и других модулей могут иметь более высокий приоритет. Такие случаи отдельно описаны в соответствующих разделах. ## Где находятся настройки В панели управления откройте: **«Основное» — «Валюты» — «Список валют»**
Найдите нужную валюту и перейдите к её редактированию.
После изменения параметров на каждой странице отдельно нажмите **«Сохранить»**. {% hint style="info" %} Страницы сохраняются независимо друг от друга. Если перейти в соседний раздел без сохранения, внесённые изменения будут потеряны. {% endhint %} ## Основное Откройте: **«Общее» — «Основное»** Здесь определяется, как валюта называется, отображается и идентифицируется в системе. На странице настраиваются: * статус валюты; * платёжная система; * код валюты; * отображение кода; * техническое название; * обозначение для XML и API; * количество знаков после запятой; * начальная сумма калькулятора; * подзаголовок. ### Статус Поле **«Статус»** определяет доступность валюты. Доступны три значения:
СтатусРезультат
«Активная валюта»Валюта может использоваться в активных направлениях и отображаться клиентам
«Не активная валюта»Валюта остаётся в рабочем списке, но не используется для новых обменов
«Архивная валюта»Валюта переносится в архив и исключается из обычного списка
Если сохранить валюту со статусом **«Не активная валюта»** или **«Архивная валюта»**, система автоматически отключит активные направления, в которых она используется. После повторного включения валюты направления автоматически не активируются. Их необходимо проверить и включить вручную в разделе: **«Основное» — «Направления обмена» — «Список направлений»** При переводе валюты в архив после сохранения панель открывает список архивных валют. После восстановления из архива валюта возвращается в неактивном состоянии. {% hint style="warning" %} Не используйте статус валюты как временный переключатель во время активной обработки заявок без предварительной проверки. Отключение одной валюты может сразу остановить большое количество связанных направлений. {% endhint %} ### Платёжная система Поле **«Платёжная система»** связывает валюту с банком, платёжным сервисом, криптовалютой, наличным способом расчёта или другой системой. {% content-ref url="/pages/FljLdANBrcGFfSeU3i4b" %} [Платёжные системы](/guide/obmen/valyuty/platyozhnye-sistemy.md) {% endcontent-ref %} Примеры: ``` Bitcoin Tether Сбербанк Visa/Mastercard Наличные ``` Из платёжной системы могут использоваться: * публичное название; * логотип; * изображение на форме обмена; * изображение в карточке заявки; * связи со справочниками и интеграциями. Платёжные системы создаются в разделе: **«Основное» — «Платёжные системы»** Например, для валюты: ``` USDT TRC20 ``` можно выбрать платёжную систему: ``` Tether ``` а сетевое уточнение указать в техническом названии или подзаголовке. ### Код валюты Поле **«Код валюты»** связывает запись с расчётной единицей. {% content-ref url="/pages/VcUqtA2ulSzzQz9CicRP" %} [Коды валют](/guide/obmen/valyuty/kody-valyut.md) {% endcontent-ref %} Примеры: ``` RUB USD EUR BTC TRX USDT ``` Коды создаются в разделе: **«Основное» — «Коды валют»** Одна платёжная система может использоваться с разными кодами. Например, для одного банка можно создать: ``` Банк RUB Банк USD Банк EUR ``` ### Отображать код валюты Параметр определяет, показывать ли клиенту код рядом с названием платёжной системы. Если параметр включён: ``` Tron TRX ``` Если параметр выключен: ``` Tron ``` Настройка влияет на: * список валют формы обмена; * карточку заявки; * отдельные информационные блоки клиентского сайта. Если в системе несколько похожих валют, рекомендуется отображать код. Например: ``` USDT TRC20 USDT ERC20 USDT BEP20 ``` Без кода или сетевого уточнения клиенту будет сложнее выбрать правильный вариант. ### Техническое название валюты Поле **«Техническое название валюты»** используется внутри панели управления. Оно отображается: * в списке валют; * в поиске; * в настройках направлений; * в списках мерчантов и выплат; * в журналах; * в административных инструментах. Примеры: ``` USDT TRC20 Сбербанк RUB Bitcoin BTC Наличные AED ``` Название должно быть понятным и уникальным. Если поле оставить пустым, система может сформировать его автоматически из названия платёжной системы и кода валюты. Изменение технического названия: * не создаёт новую валюту; * не меняет ID записи; * не удаляет направления; * не удаляет реквизиты; * не разрывает существующие связи. Однако операторам может стать сложнее находить валюту по старому названию. ### Обозначение для XML Поле **«Обозначение для XML»** — обязательный технический идентификатор валюты.
Несмотря на название, он используется не только в XML-файлах. В списке могут предлагаться обозначения BestChange. Если внешний список временно недоступен, система может использовать ранее загруженный локальный справочник. Поле также поддерживает ручной ввод. Примеры: ``` BTC USDTTRC USDTERC SBERRUB CASHUSD ``` У каждой валюты должно быть собственное уникальное обозначение. {% hint style="warning" %} Не меняйте обозначение рабочей валюты без необходимости. После изменения могут перестать работать старые ссылки, пары курсов, файлы экспорта, мониторинги и внешние API-запросы. {% endhint %} ### Знаков после запятой Поле **«Знаков после запятой»** задаёт точность валюты.
Значение используется: * при вводе суммы клиентом; * в калькуляторе; * в карточке заявки; * при округлении; * при отображении резервов; * в API; * в файлах курсов. Рекомендуемые примеры:
Тип валютыПример точности
Фиатная валюта2
Криптовалюта6 или 8
Валюта без дробной части0
Пример для RUB: ``` 1000.50 RUB ``` Точность: ``` 2 ``` Пример для BTC: ``` 0.00125000 BTC ``` Точность: ``` 8 ``` Слишком маленькое значение приводит к заметному округлению. Слишком большое значение показывает клиенту лишние дробные знаки и может не поддерживаться платёжной системой. ### Конвертировать по Поле **«Конвертировать по»** задаёт начальную сумму для стороны **«Отдаю»** при первом открытии формы обмена.
Пример: ``` Конвертировать по: 10000 ``` Форма может открыться с суммой: ``` 10 000 RUB ``` Поле не является минимальным или максимальным лимитом. Клиент может изменить начальное значение, если другая сумма разрешена направлением. На итоговый выбор стартовой суммы также влияют: * минимальная сумма направления; * общая настройка начального значения калькулятора; * приоритет лимита направления; * сохранённая клиентом сумма. Обычно значение используется, если оно больше `1`. Если указано: ``` 0 ``` ``` 1 ``` или значение меньше `1`, клиентская часть может использовать минимальную сумму направления. {% hint style="info" %} Минимальные и максимальные суммы настраиваются в карточке направления. Поле **«Конвертировать по»** задаёт только начальное значение формы. {% endhint %} ### Подзаголовок валюты Поле **«Подзаголовок валюты»** является мультиязычным.
Оно отображается под основным названием валюты и помогает уточнить её особенности. Примеры: ``` TRC20 ERC20 По номеру карты Перевод внутри банка Наличные в Москве ``` Подзаголовок рекомендуется использовать для: * названия сети; * региона; * способа перевода; * краткого предупреждения; * отличия от похожих валют. Заполните его отдельно для каждого языка сайта. *** ## Доп. поля Откройте: **«Общее» — «Доп. поля»** Страница управляет двумя видами данных: * основным реквизитом клиента; * дополнительными полями. Основным реквизитом может быть: * номер банковской карты; * номер счёта; * IBAN; * адрес криптовалютного кошелька; * номер телефона; * другой основной идентификатор платежа. Дополнительными полями могут быть: * Ф. И. О.; * название банка; * Memo; * Tag; * код отделения; * назначение платежа; * комментарий; * номер документа. ### Стороны «Отдаю» и «Получаю» Настройки применяются в зависимости от положения валюты в направлении. {% stepper %} {% step %} #### Отдаю Используется, когда клиент передаёт эту валюту обменнику. Например: ``` Сбербанк RUB - USDT TRC20 ``` Для Сбербанк RUB применяются поля стороны **«Отдаю»**. {% endstep %} {% step %} #### Получаю Используется, когда клиент получает эту валюту. В том же направлении для USDT TRC20 применяются поля стороны **«Получаю»**. {% endstep %} {% endstepper %} ### Доп. поля для «Отдаю» и «Получаю» Поля: * **«Доп. поля для отдаю»**; * **«Доп. поля для получаю»** позволяют прикрепить к валюте записи из общего справочника.
Перед привязкой создайте их в разделе: **«Основное» — «Валюты» — «Доп. поля валют»** {% content-ref url="/pages/dfrFMxR3oFPMaDXdhp9c" %} [Доп. поля для валют](/guide/obmen/dop.-polya/dop.-polya-dlya-valyut.md) {% endcontent-ref %} Посторонние поля в запросе заявки отклоняются. ### Название и комментарий для поля «Номер счёта»
Поля: * **«Название для поля "Номер счёта"»**; * **«Комментарий для поля "Номер счёта"»** относятся к реквизиту обменника, который клиент видит после создания заявки. Например: ``` Название: Номер карты для оплаты ``` ``` Комментарий: Переведите точную сумму одним платежом ``` Это не название поля, в которое клиент вводит собственный реквизит на первоначальной форме. Для клиентского ввода используются: * **«Название поля "со счёта"»**; * **«Название поля "на счёт"»**. ### Скрыть номер счёта для «Отдаю» Если параметр включён: * основное поле реквизита стороны **«Отдаю»** скрывается; * клиент не передаёт стандартное значение; * сервер не проверяет его формат. Используйте настройку, если реквизит: * не требуется; * собирается через дополнительное поле; * определяется автоматически; * передаётся другим модулем. ### Скрыть номер счёта для «Получаю» Если параметр включён: * основное поле стороны **«Получаю»** скрывается; * стандартная серверная проверка не выполняется; * реквизит можно получить через дополнительные поля или мульт-счёт. Если для валюты настроен мульт-счёт, он также может заменить стандартный реквизит получения. {% hint style="warning" %} Скрытие основного поля не создаёт замену автоматически. Перед включением убедитесь, что все обязательные данные клиента собираются другим способом. {% endhint %} Настройки длины, маски, допустимых символов и валидатора применяются только к видимому основному реквизиту.
Если оба поля скрыты, соответствующий блок настроек может не отображаться в панели. ### Минимальное и максимальное количество символов Поля задают допустимую длину основного реквизита. Проверка диапазона выполняется, если оба значения больше `0`. Если одно поле равно `0`, совместная проверка минимальной и максимальной длины может не выполняться. Доступны готовые пресеты:
ПресетДиапазон
Карта 1614–16
Карта 1816–19
IBAN15–34
BTC26–35
ETH / ERC2033–35
TRC2033–35
Пресеты являются только заготовками. ### Текст ошибки длины Поле задаёт мультиязычное сообщение при неправильной длине реквизита. Можно использовать шорткод: ``` [currency] ``` Система заменит его названием валюты. Пример: ``` Проверьте реквизит [currency]: допустимо от 16 до 19 символов. ``` Если поле не заполнено, используется стандартное системное сообщение. ### Названия полей «со счёта» и «на счёт»
{% stepper %} {% step %} #### Название поля «со счёта» Используется, когда клиент отдаёт валюту. Примеры: ``` Номер карты отправителя Адрес кошелька отправителя IBAN отправителя ``` {% endstep %} {% step %} #### Название поля «на счёт» Используется, когда клиент получает валюту. Примеры: ``` Номер карты получателя Адрес кошелька для выплаты IBAN получателя ``` {% endstep %} {% endstepper %} Названия могут также использоваться: * в заявке; * в уведомлениях; * в административной панели; * в шаблонах. ### Комментарии для полей Комментарии отображаются рядом с реквизитом. Используйте их для коротких пояснений: ``` Укажите карту, оформленную на ваше имя. ``` ``` Используйте только сеть TRC20. ``` ``` Memo необходимо указать обязательно. ``` Не размещайте здесь длинную инструкцию по оплате. Для неё используется раздел **«Информация»**. ### QR-сканирование Параметр **«Включить сканирование QR-кода»** настраивается отдельно для сторон **«Отдаю»** и **«Получаю»**.
После включения клиент может: 1. Открыть камеру устройства. 2. Отсканировать QR-код. 3. Автоматически подставить распознанный реквизит. Если QR-код содержит URI, клиентская часть пытается извлечь из него адрес. Например: ``` bitcoin:bc1exampleaddress ``` QR-сканирование: * не создаёт QR-код для оплаты; * не заменяет валидатор; * не гарантирует правильность сети; * требует разрешения браузера на использование камеры. Проверяйте функцию на реальных QR-кодах выбранной сети. ### Валидатор Валидатор проверяет реквизит по правилам выбранной карты, банка, монеты или сети. Валидаторы сторон сохраняются отдельно: * валидатор **«со счёта»**; * валидатор **«на счёт»**. При первом выборе валидатора стороны **«Отдаю»** панель может автоматически подставить такое же значение для **«Получаю»**, если второе поле пустое. После ручного изменения значения сохраняются независимо. На публичной форме: * для стороны **«Отдаю»** используется валидатор **«со счёта»**; * для стороны **«Получаю»** используется валидатор **«на счёт»**. При серверной проверке текущая версия может дополнительно применять оба настроенных валидатора валюты. Поэтому два несовместимых правила могут привести к отклонению корректного реквизита. Пример проблемной настройки: ``` Со счёта: валидатор банковской карты ``` ``` На счёт: валидатор криптовалютного адреса ``` Если оба участвуют в серверной проверке одной валюты, правильное значение может быть отклонено. {% hint style="warning" %} Если валюта использует одинаковый формат на обеих сторонах, безопаснее выбрать один и тот же валидатор. Разные валидаторы используйте только после полного тестирования. {% endhint %} Валидатор **«со счёта»** также может использоваться при проверке реквизита партнёра для выплаты в этой валюте. После изменения проверьте: * форму обмена; * создание заявки; * партнёрскую выплату. Для каждого валидатора используйте минимум два теста: 1. Корректный реквизит. 2. Реквизит неправильного формата. ### Текст ошибки валидатора Для каждой стороны можно заполнить собственный текст ошибки. Однако в текущей версии окончательная серверная ошибка основного реквизита может формироваться стандартным системным сообщением. Поэтому обязательно проверьте реальный результат на клиентском сайте. Это ограничение не относится к ошибке минимальной и максимальной длины: её собственный текст применяется сервером. ### Маска ввода Маска помогает вводить реквизит в ожидаемом формате. Основные символы:
СимволЗначение
0Цифра
AЛатинская буква
*Любой символ
Пробел, -, /Постоянный разделитель
Пример маски банковской карты: ``` 0000 0000 0000 0000 ``` Для каждой стороны можно: * выбрать готовый пресет; * создать собственную маску; * скопировать маску; * поменять маски местами. Режим **«Связано»** синхронизирует значения только во время редактирования. На сервер отправляются две готовые маски. Отдельная постоянная связь между ними не сохраняется. ### Плейсхолдер маски Плейсхолдер показывает незаполненную часть. Примеры: ``` _ ``` ``` • ``` Также можно выбрать вариант **«Без»**. Плейсхолдер влияет только на внешний вид и не сохраняется как часть реквизита. ### Разрешённые символы Поле задаёт серверное ограничение формата. | Значение | Что разрешено | | ----------------------------- | -------------------------------------- | | **«Любые символы»** | Дополнительная проверка не применяется | | **«Цифры»** | Только цифры | | **«Буквы»** | Латинские и кириллические буквы | | **«Латинские буквы и цифры»** | Латинские буквы и цифры | | **«Латинские буквы»** | Только латинские буквы | Пробелы удаляются перед серверной проверкой. Другие разделители, например дефис, могут быть запрещены выбранным режимом. Маска не заменяет проверку разрешённых символов. Например, маска может визуально показывать дефисы, но сервер отклонит их, если разрешены только цифры. ### Удалять пробелы в реквизитах Если настройка включена, пробельные символы удаляются перед: * проверкой; * сохранением; * сравнением с чёрными списками. Полезно использовать для: * банковских карт; * IBAN; * криптовалютных адресов; * других реквизитов, которые клиент вставляет с форматированием. Не включайте настройку для данных, где пробел имеет смысловое значение. #### Пример настройки банковской карты 1. Оставьте основное поле нужной стороны видимым. 2. Укажите название **«Номер карты»**. 3. Задайте длину от `16` до `19`. 4. Выберите валидатор банковской карты. 5. Укажите маску: ``` 0000 0000 0000 0000 ``` 6. Выберите разрешённые символы **«Цифры»**. 7. Включите удаление пробелов. 8. Добавьте текст ошибки. 9. Проверьте корректную карту. 10. Проверьте слишком короткое значение. 11. Проверьте буквы. 12. Проверьте невалидный номер. #### Пример настройки криптовалютного адреса 1. Укажите актив и сеть в названии: ``` Адрес USDT TRC20 ``` 2. Оставьте поле видимым. 3. Выберите валидатор TRC20. 4. Укажите допустимую длину. 5. Выберите разрешённые символы. 6. Включите QR-сканирование. 7. Добавьте комментарий: ``` Используйте только сеть TRC20. ``` 8. Проверьте обычный адрес. 9. Проверьте адрес неправильной сети. 10. Проверьте QR-код реального кошелька. *** ## Информация Откройте: **«Общее» — «Информация»** Здесь находятся тексты для формы обмена и страницы оплаты. Все текстовые поля мультиязычные. Заполняйте каждый язык, доступный клиентам. Если перевода нет, система может использовать резервную локаль. Для важных инструкций лучше не полагаться на автоматическую подстановку. {% content-ref url="/pages/GHMaBNB2dCcPb7NMa5KY" %} [Тексты и инструкции по валютам](/guide/obmen/informaciya/teksty-i-instrukcii-po-valyutam.md) {% endcontent-ref %} *** ## Как безопасно изменить рабочую валюту Если необходимо изменить: * платёжную систему; * код; * сеть; * XML-обозначение; * назначение валюты; безопаснее не переделывать рабочую запись, а создать новую валюту. Рекомендуемый порядок: 1. Создайте новую валюту. 2. Выберите правильную платёжную систему. 3. Выберите код. 4. Настройте обозначение. 5. Настройте реквизиты и поля. 6. Настройте тексты. 7. Подключите мерчанты и выплаты. 8. Настройте резерв и лимиты. 9. Создайте новые направления. 10. Выполните тестовый обмен. 11. Отключите старую валюту. 12. После проверки перенесите её в архив. Такой порядок снижает риск нарушения: * ссылок; * курсов; * реквизитов; * мониторингов; * внешних интеграций. ## Рекомендации Для большинства валют рекомендуется: * использовать понятное уникальное техническое название; * не менять рабочее XML-обозначение без необходимости; * указывать реальную точность валюты; * различать сети через название и подзаголовок; * скрывать основной реквизит только при наличии замены; * использовать совместимые валидаторы; * включать удаление пробелов для карт и адресов; * проверять QR-сканирование реальными кошельками; * заполнять тексты на всех языках; * не дублировать длинные инструкции в нескольких полях; * создавать новую валюту при существенном изменении назначения; * выполнять тестовый обмен после важных изменений. ## Коротко Группа **«Общее»** содержит основные настройки валюты. В разделе **«Основное»** задаются: * статус; * платёжная система; * код; * техническое название; * XML-обозначение; * точность; * начальная сумма; * подзаголовок. В разделе **«Доп. поля»** настраиваются: * основные реквизиты; * дополнительные поля; * длина; * маски; * валидаторы; * QR-сканирование; * допустимые символы. В разделе **«Информация»** задаются: * инструкции; * описания; * уведомления; * тексты кнопок; * оформление валюты. После изменения настроек обязательно сохраните каждую страницу, проверьте валюту на публичном сайте и создайте новую тестовую заявку. --- # 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/obmen/valyuty/upravlenie-valyutami/obshee.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.