Параметры

Этот раздел описывает, какие настройки доступны в редакторе сценария KYC → Web SDK, как они влияют на виджет и на каком экране отображаются. Все изменения сразу видны в превью справа, а пользователи увидят их в встраиваемом виджете.

1) Цветовая тема

Верхний переключатель задаёт, в какой теме проектируется интерфейс:

  • Тёмная / Светлая — выбранная тема используется в превью и как дефолт при запуске виджета (если не переопределена параметром theme при инициализации).
  • Логотипы и контрастные элементы настраиваются отдельно для каждой темы (см. «Общие»).

2) Общие

Вкладка «Общие» отвечает за фирменное оформление и юридические ссылки:

  • Логотип
  • *Для тёмной темы* — загрузите вариант логотипа, который хорошо читается на тёмном фоне.
  • *Для светлой темы* — отдельный вариант для светлого фона.

Рекомендации: PNG/SVG с прозрачным фоном, без тонких светло‑серых линий на светлой теме и наоборот — ради хорошей читаемости.

  • Условия & Положения (URL) — ссылка на ваши «Terms & Conditions».
  • Политика конфиденциальности (URL) — ссылка на вашу «Privacy Policy». Эти ссылки отображаются в виджете на стартовых экранах и помогают закрыть юридические требования.
  • Разрешить использование камеры десктопного ПК (чекбокс)
  • Включено — пользователю доступно прохождение на этом устройстве (кнопка «Продолжить на этом устройстве»), камера и загрузка фото работают в браузере ПК.
  • Выключено — предлагается перейти на телефон по QR‑коду/ссылке; съёмка выполняется на мобильном устройстве.

3) Цвет

Вкладка «Цвет» позволяет полностью брендировать виджет:

  • Фоны: основной, вторичный, фон блоков.
  • Текст: основной и вторичный цвета.
  • Главный цвет:
  • *Начальный* (акцент/бренд),
  • *Успех* (например, зелёный чек‑маркер),
  • *Ошибка* (цвет ошибок и предупреждений).
  • Дополнительные:
  • цвет лоадера,
  • тень (для карточек/модалок),
  • границы (бордеры/разделители).
  • Primary Button: цвет текста главной кнопки (фон тянет из главных цветов).
  • Secondary Button: цвет текста, фон и граница вторичной кнопки.

Советы по контрасту: — Проверяйте читаемость кнопок и инпутов на всех состояниях (hover/active/disabled). — Сохраняйте достаточную контрастность текста к фону (WCAG 2.1 AA).

4) Текст

Экранные тексты редактируются в нескольких группах. Все изменения сразу видны в реальном превью справа — стрелками можно пролистать шаги сценария.

4.1. Стартовый экран (онбординг + QR)

Здесь задаются:

  • Заголовок («Проверка личности»).
  • Вводные пункты‑инструкции (подготовить документ, включить камеру, убедиться в освещении и т.п.).
  • Юридическая приписка о согласии на обработку ПДн (настраивается как обычный текст).
  • Блок с QR‑кодом и подписи к нему (а также альтернативная ссылка «Скопируйте эту ссылку…»).
  • Подпись кнопки «Продолжить на этом устройстве» (появляется, если разрешена камера ПК в «Общих»).

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

4.2. Инструкции для фотографирования документа

Отдельный экран с подсказками как правильно сфотографировать документ. Примеры типовых пунктов:

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

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

4.3. Инструкции для селфи с документом

Подсказки как сделать селфи с документом:

  • Возьмите документ в руку и смотрите в камеру в момент фотографирования;
  • Документ и ваше лицо должны быть полностью видны (документ — рядом с лицом, не закрывает части лица).

4.4. Тексты статусов/успеха

Здесь можно изменить подписи на экранах после выполнения шага (например, «Спасибо, мы приняли ваш документ», текст кнопки «Продолжить» и т.п.). Если распознавание не удалось, виджет сам отрисует экран с указанием причины (см. раздел «Ошибки» в общем KYC‑разделе).

5) Языки

Во вкладке «Языки» отмечаются галочками доступные локали интерфейса. Часто включают: English, Español, Русский, Deutsch, Français, Português и др. В виджете показывается переключатель языка; пользователь может выбрать удобный язык из включённых.

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

* Включайте только те языки, которые релевантны вашей аудитории, чтобы не перегружать переключатель.

* Если вы используете собственные формулировки в «Текст», согласуйте перевод с локализаторами (для корпоративных формулировок).


Что где отображается в виджете

  • Логотипы и цвета — на всех шагах (верхняя область/хедер, кнопки, иконки успеха/ошибки).
  • Юридические ссылки — на стартовом экране и в подсказках, где предусмотрено место под disclaimer.
  • Тексты — на соответствующих шагах сценария: вступление/QR → документ → селфи → успех/результат.
  • Языки — в меню переключения языка (видно в правом верхнем углу виджета).

Практические советы по брендингу

  • Загружайте два варианта логотипа — для тёмной и светлой темы.
  • Для логотипов используйте SVG или PNG с прозрачным фоном.
  • Проверьте контраст кнопок и полей во всех состояниях.
  • Тексты делайте короткими, требования — по пунктам.
  • На экранах с камерой обязательно напоминайте про полную видимость документа и отсутствие бликов/перекрытий.

Где править поведение виджета (неоформительские параметры)

Оформление и тексты настраиваются здесь, в редакторе Web SDK. Технические параметры запуска (например, schemaId, clientKey, theme, successCb, closeCb) передаются при инициализации виджета на стороне вашего сайта/приложения — см. раздел Подключение и Работа с clientKey.


Готово. После сохранения настроек Web SDK все новые сессии KYC начнут отображать виджет с вашим брендингом и текстами.