> 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/help-center/ai-docs/nastroika-obmena/currency-list-and-card/currency-fields.md).

# Поля валюты

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

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

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

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

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

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

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

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

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

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

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

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

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

### Тип поля и содержимое

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## Проверка

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

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


---

# 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/help-center/ai-docs/nastroika-obmena/currency-list-and-card/currency-fields.md?ask=<question>&goal=<endgoal>
```

`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.