Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Дополнительные поля

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

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

Например:

Номер карты
2202 2000 0000 0000

Получатель
Иван Иванович Иванов

Банк
Сбербанк

Комментарий
Оплачивайте одним переводом

Дополнительные поля предназначены для отображения информации. Клиент не заполняет их самостоятельно.

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

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

«Основное» — «Платёжные реквизиты» — «Доп. поля»

На странице отображается общий список дополнительных полей, созданных для валют и отдельных платёжных реквизитов.

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

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

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

Право находится в группе:

«Платёжные реквизиты»

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

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

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

  • Memo;

  • Tag;

  • Destination Tag;

  • название банка;

  • ФИО получателя;

  • номер телефона получателя;

  • назначение платежа;

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

  • дополнительный идентификатор перевода;

  • постоянные данные конкретной карты или счёта;

  • предупреждение или пояснение к значению.

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

Например, при отправке XRP клиенту может потребоваться не только адрес, но и Destination Tag:

Без дополнительного идентификатора платёж может не определиться автоматически.

Чем дополнительные поля отличаются от других настроек

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

Настройка
Для чего используется

Дополнительные поля реквизитов

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

Поля валюты

Заполняются клиентом при создании заявки

Дополнительные поля направления

Собирают сведения для конкретного направления обмена

Реквизиты по запросу

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

Инструкция к оплате

Показывает общий порядок выполнения перевода

Примечание мерчанта

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

Дополнительное поле не создаёт новый реквизит. Оно дополняет уже выбранный способ оплаты.

Как работают дополнительные поля

Общая последовательность выглядит так:

  1. Администратор создаёт дополнительное поле.

  2. Выбирает тип поля.

  3. Указывает название, значение и комментарий.

  4. Привязывает поле к валютам или конкретным реквизитам.

  5. Включает поле.

  6. Система формирует платёжные данные заявки.

  7. Подходящие дополнительные поля добавляются к реквизитам.

  8. Рассчитанные значения сохраняются внутри заявки.

  9. Клиент видит их на странице оплаты.

После сохранения в заявке значение становится частью выданных платёжных данных.

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

Типы дополнительных полей

При создании необходимо выбрать один из двух типов:

  • «Для валют»;

  • «Статическое для реквизитов».

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

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

1

Для валют

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

Такое поле подходит для:

  • Memo или Tag, получаемого от мерчанта;

  • названия банка, возвращаемого платёжным сервисом;

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

  • общего текста для выбранной валюты;

  • дополнительных данных автоматического мерчанта;

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

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

Например, поле «Memo» можно привязать ко всем криптовалютам, где подключённый мерчант возвращает дополнительный идентификатор платежа.

Для полей этого типа можно использовать автоматические подстановки:

2

Статическое для реквизитов

Тип «Статическое для реквизитов» создаёт постоянное поле для конкретного ручного реквизита.

Он подходит для:

  • ФИО владельца определённой карты;

  • названия банка конкретного реквизита;

  • номера телефона получателя;

  • постоянного назначения платежа;

  • дополнительной информации для конкретного счёта или кошелька.

Пример:

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

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

Если нужный реквизит отсутствует, проверьте:

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

  • заполнено ли поле «Номер счёта»;

  • сохранён ли реквизит;

  • доступен ли он в разделе платёжных реквизитов.

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

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

В списке дополнительных полей можно увидеть:

  • название;

  • системный ключ;

  • тип поля;

  • значение;

  • связанные валюты или реквизиты;

  • статус;

  • порядок;

  • кнопки редактирования и удаления.

Из списка также можно быстро:

  • включить или отключить поле;

  • изменить привязки;

  • открыть форму редактирования;

  • удалить поле;

  • изменить порядок каталога.

Для настройки порядка, который увидит клиент, используется отдельное окно «Порядок полей».

Настройки дополнительного поля

1

Тип поля

Определяет, к чему будет привязано поле.

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

  • «Для валют»;

  • «Статическое для реквизитов».

После создания тип изменить нельзя.

2

Название

Название — это заголовок поля, который увидит клиент.

Примеры:

3

Значение

Значение — основное содержимое поля, которое увидит клиент и сможет скопировать.

Примеры:

Для типа «Для валют» можно использовать автоматические подстановки.

Например:

или:

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

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

4

Комментарий

Комментарий — это дополнительное пояснение, которое отображается под значением.

Примеры:

Комментарий заполнять необязательно.

Он также поддерживает несколько языков.

Используйте комментарий для предупреждений и пояснений, а не для самого платёжного значения.

5

Валюты

Поле отображается для типа «Для валют».

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

Можно выбрать:

  • одну валюту;

  • несколько валют;

  • все подходящие валюты.

Выбирается валюта, которую клиент отдаёт обменнику.

Пример:

Если поле привязано к XRP, но клиент отдаёт USDT, оно не будет показано.

6

Реквизиты

Поле отображается для типа «Статическое для реквизитов».

Выберите конкретные карты, счета или кошельки, вместе с которыми должно выводиться поле.

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

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

7

Статус

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

Статус
Что означает

Включено

Поле может добавляться в новые платёжные данные

Выключено

Поле не добавляется в новые платёжные данные

Одного включённого статуса недостаточно.

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

Системный ключ

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

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

Системный ключ используется для:

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

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

  • связи поля с платёжными данными;

  • предотвращения смешивания разных значений.

Изменить системный ключ после создания нельзя.

Обычному администратору не нужно задавать или редактировать его вручную.

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

Автоматические подстановки работают только для полей типа «Для валют».

Они указываются в поле «Значение».

Подстановки не обрабатываются:

  • в названии;

  • в комментарии;

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

1

Подстановка [auto]

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

В зависимости от платёжного сервиса это может быть:

  • Memo;

  • Memo ID;

  • Tag;

  • Destination Tag;

  • другой дополнительный идентификатор перевода.

Пример:

Если мерчант не вернул дополнительное значение и в поле находится только [auto], поле не будет показано клиенту.

Подстановка [auto] не создаёт Memo самостоятельно. Она выводит только значение, которое уже вернул подключённый мерчант.

2

Подстановка [auto_bank_name]

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

Пример:

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

3

Подстановка [order_id]

Подставляет внутренний номер заявки в системе.

Пример:

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

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

4

Подстановка [public_id]

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

Пример:

Клиент может использовать это значение при выполнении банковского перевода.

Правила использования подстановок

При настройке учитывайте:

  • используйте точное написание;

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

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

  • они обрабатываются только в поле «Значение»;

  • в названии и комментарии они не работают;

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

  • [auto] выводит только значение, полученное от мерчанта;

  • пустые итоговые значения не показываются клиенту.

Правильно:

Неправильно:

Как создать дополнительное поле

  1. Откройте «Основное» — «Платёжные реквизиты» — «Доп. поля».

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

  3. Выберите тип поля.

  4. Заполните «Название».

  5. Заполните «Значение».

  6. При необходимости добавьте «Комментарий».

  7. Выберите валюты или конкретные реквизиты.

  8. Установите статус «Включено».

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

  10. При необходимости настройте порядок отображения.

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

После сохранения поле появится в общем списке.

Как изменить дополнительное поле

  1. Откройте раздел «Доп. поля».

  2. Нажмите на название нужного поля.

  3. Измените название, значение или комментарий.

  4. При необходимости измените привязки.

  5. Проверьте статус.

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

После создания нельзя изменить:

  • тип поля;

  • системный ключ.

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

Уже сформированные заявки продолжат использовать сохранённые ранее значения.

Быстрое управление из списка

В общем списке доступны:

  • переключение статуса;

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

  • изменение привязанных реквизитов;

  • открытие формы редактирования;

  • удаление поля;

  • сортировка каталога.

Изменения в колонке «Привязано к» сохраняются автоматически.

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

Настройка порядка отображения

Порядок дополнительных полей на странице оплаты настраивается отдельно для каждой валюты или каждого реквизита.

Чтобы изменить порядок:

  1. Откройте «Основное» — «Платёжные реквизиты» — «Доп. поля».

  2. Нажмите «Порядок полей».

  3. Выберите тип поля.

  4. Выберите валюту или реквизит.

  5. Перетащите поля в нужной последовательности.

  6. Дождитесь сообщения о сохранении.

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

Например, для одной валюты порядок может быть таким:

Для другой валюты:

Перетаскивание строк в основном списке изменяет порядок самого каталога полей.

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

Как поля сохраняются в заявке

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

В заявке фиксируются:

  • название поля;

  • рассчитанное значение;

  • комментарий;

  • порядок отображения;

  • системный ключ.

Это защищает уже выданные платёжные данные от последующих изменений.

Например:

  1. Клиенту выдана карта и дополнительное поле «Получатель».

  2. Значение сохранено в заявке.

  3. Администратор изменил ФИО в настройках поля.

  4. Старая заявка продолжит показывать прежнее ФИО.

  5. Новые заявки будут использовать обновлённое значение.

Так платёжные данные не изменяются после того, как были выданы клиенту.

Где отображаются дополнительные поля

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

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

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

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

  • в уведомлении о создании заявки;

  • в других шаблонах, где используются сформированные платёжные данные.

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

1

Memo для криптовалюты

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

Настройка:

После создания заявки клиент увидит:

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

2

Название банка от мерчанта

Настройка:

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

3

ФИО для конкретной карты

Настройка:

ФИО будет показано только вместе с выбранной картой.

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

4

Назначение платежа

Настройка:

Клиент увидит:

5

Постоянный комментарий для карты

Настройка:

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

Когда дополнительное поле не отображается

Поле выключено

Проверьте, что установлен статус:

Отключённые поля не добавляются в новые платёжные данные.

Не выбрана привязка

Проверьте колонку «Привязано к».

Поле без валют или реквизитов остаётся в системе, но клиентам не показывается.

Выбрана неправильная валюта

Для типа «Для валют» выбирается валюта, которую клиент отдаёт обменнику.

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

Выдан другой ручной реквизит

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

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

Используется внешняя страница оплаты

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

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

Мерчант не вернул значение

Подстановки:

не создают данные самостоятельно.

Проверьте:

  • поддерживает ли мерчант нужное значение;

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

  • успешно ли созданы платёжные данные;

  • нет ли ошибки интеграции.

Итоговое значение пустое

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

Например, если используется только:

а мерчант ничего не вернул, клиент поле не увидит.

Проверяется старая заявка

Дополнительные поля сохраняются внутри заявки.

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

Старая заявка продолжит использовать ранее сохранённые данные.

Не заполнен перевод

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

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

Реквизит отсутствует в списке привязки

Проверьте, что реквизит:

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

  • имеет заполненный номер счёта;

  • сохранён;

  • доступен в разделе платёжных реквизитов.

Автоматическая подстановка отображается как текст

Например, клиент видит:

Возможные причины:

  • поле создано как «Статическое для реквизитов»;

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

  • допущена ошибка в написании;

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

Автоматические подстановки работают только в поле «Значение» для типа «Для валют».

Как временно отключить поле

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

Отключённое поле:

  • остаётся в панели управления;

  • сохраняет настройки и привязки;

  • не добавляется в новые платёжные данные;

  • может быть включено повторно.

Используйте отключение, если поле может понадобиться позднее.

Уже сформированные заявки продолжат использовать сохранённые значения.

Как удалить поле

  1. Откройте общий список дополнительных полей.

  2. Найдите нужное поле.

  3. Нажмите кнопку удаления.

  4. Подтвердите действие.

При удалении:

  • поле удаляется из общего списка;

  • его привязки удаляются;

  • оно не используется в новых платёжных данных;

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

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

Требования безопасности

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

Не размещайте в них:

  • пароли;

  • API-ключи;

  • секретные токены;

  • данные для входа в банк;

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

  • закрытые ключи;

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

  • данные, которые клиент не должен видеть.

Клиент может:

  • увидеть значение;

  • скопировать его;

  • сохранить снимок экрана;

  • передать данные третьему лицу.

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

Не используйте дополнительные поля как хранилище секретных данных. Они предназначены для вывода информации клиенту.

Рекомендации

Для Memo, Tag и Destination Tag используйте поле типа «Для валют» с подстановкой:

Для названия банка от мерчанта используйте:

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

Для постоянного ФИО владельца карты используйте тип «Статическое для реквизитов».

Не добавляйте автоматические подстановки в статические поля.

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

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

После изменения настройки всегда создавайте новую тестовую заявку.

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

Не удаляйте поле, если оно ещё используется в активной конфигурации.

Коротко

Дополнительные поля выводят информацию рядом с основным платёжным реквизитом.

Раздел находится по пути: «Основное» — «Платёжные реквизиты» — «Доп. поля»

Тип «Для валют» используется для общих и автоматических значений.

Тип «Статическое для реквизитов» используется для постоянных данных конкретной карты, счёта или кошелька.

Поддерживаются автоматические подстановки:

После формирования платёжных данных значения сохраняются внутри заявки.

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

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

ПредыдущаяПлатёжные реквизитыСледующаяРеквизиты по запросу

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

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