Поля валюты

Основной реквизит валюты, дополнительные поля, файлы, маски и валидаторы

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

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

Справочник дополнительных полей

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

«Основное» — «Валюты» — «Доп. поля валют»

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

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

Нажмите «Добавить поле» и заполните форму.

Название и расположение

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

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

Специальные значения используются только для указанного назначения:

• sender_fullname — полное имя отправителя, применяется один раз;
• recipient_fullname — полное имя получателя, применяется один раз;
• income_unk — tag или memo при отправке криптовалюты;
• outcome_unk — tag или memo при получении криптовалюты;
• income_* — дополнительное поле стороны «Отдаю»;
• outcome_* — дополнительное поле стороны «Получаю».

Замените * понятным уникальным окончанием. Изменение ключа уже используемого поля может нарушить сопоставление сохранённых данных, поэтому сначала проверьте все связанные валюты и направления.

Способ заполнения и тип поля

«Способ заполнения поля» выбирает «Стандартное поле» или «Загрузка файлов». Он фиксируется при создании и затем не меняется. Для загрузки настройте форматы, размер и количество по статье «Загрузка файлов в дополнительных полях».

Для стандартного способа «Тип поля» принимает «Текстовое поле», «Список» или «Выбор». Для списка и выбора заполните «Варианты (через запятую, с новой строки)» на нужных языках.

«Содержимое поля» ограничивает ввод вариантами «Строка и цифры», «Строка» или «Цифры». «Язык текста» может быть «Без ограничений», «Только русский» или «Только английский».

Также доступны:

• «Мин. кол-во символов» и «Макс. кол-во символов»;
• «Пример» и описание;
• «Обязательное поле» со значениями «Да» и «Нет»;
• «Удалить пробелы в поле»;
• «Начинающиеся слова (буквы)»;
• «Заканчивающиеся слова (буквы)»;
• статус поля.

Тип валидатора

Валидатор проверяет формат введённого значения. Доступны:

Значение	Что проверяет	Где применять
ФИО (Русский язык)	Имя на русском языке	Поле ФИО с русским вводом
ФИО (Английский язык)	Имя на английском языке	Поле латинского ФИО
БИК (Российский банковский идентификационный код)	Формат БИК	Банковские данные
Номер телефона с +7	Телефон с префиксом +7	Российский телефон в полном формате
Номер телефона с 7	Телефон с префиксом 7	Телефон без знака +
Ник в Telegram	Формат имени Telegram	Контакт клиента
Международный номер банковского счёта (IBAN)	Формат IBAN	Международный банковский счёт

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

Основной реквизит в карточке валюты

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

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

Откройте валюту. В группе «Общее» выберите «Доп. поля».

Подписи и видимость

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

«Скрыть номер счёта для „Отдаю“» и «Скрыть номер счёта для „Получаю“» используются, если реквизит вводится другим способом или должен появиться позже. Значения ниже продолжают определять проверку ввода, когда поле используется.

Формат и маска

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

Для ошибки длины заполните «Текст ошибки для полей (со счета/на счет)». Для ошибки валидатора используйте «Текст ошибки для валидатора». Текст должен объяснять клиенту ожидаемый формат без раскрытия внутреннего правила проверки.

Валидаторы и банки

«Валидатор поля „со счета“» и «Валидатор поля „на счет“» проверяют основной реквизит. Списки разрешённых и запрещённых названий банков настраиваются отдельно для сторон «Отдаю» и «Получаю»; значения вводятся через запятую.

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

«Включить сканирование QR-кода» также задаётся отдельно для обеих сторон. После включения проверьте ввод вручную и через QR-код на клиентском устройстве.

Привязка готовых полей

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

Проверка

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

Если поле не видно, проверьте его статус, «Где выводить?», список связанных валют, сторону валюты в направлении и порядок. Если форма отклоняет корректное значение, последовательно исключите конфликт «Содержимое поля», «Язык текста», начала и окончания, длины и «Тип валидатора».