Глоссарий

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

Базовые сущности

• Заявитель (Applicant)
  Клиент вашей системы, в отношении которого проводится идентификация и/или проверки.
  Представлен в KYC сущностью Applicant, создаётся и обновляется через API.

• Идентификация (Identification)
  Процесс удалённой проверки личности заявителя и связанных с ним данных.
  В KYC отражается сущностью Identification и набором статусов (см. справочники).

• Верификация (Verification)
  Проверка предоставленных данных по внешним или внутренним источникам (СМЭВ, скоринги, антифрод, списки и т.д.).
  В спецификации соответствует сервису Verification и его batch‑запросам.

• OCR (распознавание документов)
  Сервис, который по изображению документа возвращает структурированные данные: тип документа, страну, версию и набор полей (textFields).

• Mobile ID
  Продукт для идентификации и аутентификации абонента по данным оператора связи,
  использующий протоколы OAuth 2.0 / OpenID Connect.

Технические термины

• applicantExternalId
  Внешний идентификатор заявителя на стороне клиента. Используется для связи записей в вашей системе и в KYC.

• verificationExternalId
  Внешний идентификатор запроса на верификацию.
  Возвращается в ответах и callback‑ах Verification; может совпадать с идентификатором из других систем (например, Mobile ID).

• Workflow / workflow-instances
  Преднастроенный сценарий идентификации, в котором заранее определены шаги и проверки.
  Позволяет создавать заявки на идентификацию по «шаблону».

• Callback (HTTP‑callback)
  Обратный HTTP‑запрос от сервиса (KYC, Verification) на ваш URL с результатом операции.

• PostMessage‑интерфейс
  Механизм обмена сообщениями между встраиваемым веб‑модулем KYC и вашей страницей через window.postMessage.
  Используется для передачи статусов, событий UI и результатов без перезагрузки страницы.

• Tenant / TenantId
  Логический идентификатор клиента платформы, который может участвовать в настройке прав, логики и форматов выдачи данных (например, параметров confidence в OCR).

Форматы и данные

• documentType (OCR)
  Объект с описанием распознанного документа:
• type — тип документа (паспорт, ВУ, свидетельство и т.д.);
• countryCode — страна в формате ISO 3166‑1 alpha‑3;

• version — версия бланка документа.

• textFields (OCR)
  Массив полей, каждое из которых содержит:

• name — имя поля;
• value — значение;
• confidence — уровень уверенности (0–1, опционально);

• confidenceFlag — флаг уверенности (true/false).

• CompletionStrategy (Verification)
  Настройка стратегии завершения верификации (WaitForAll, WaitForCriticalOnly, ForceFirst) и списка критичных источников (modules).

Окружения

• Prod — продуктивная среда, работа с реальными клиентами и боевыми данными.
• Prodlike / RC / DEV — тестовые и интеграционные окружения, предназначенные для разработки и отладки.

Расширенный словарь терминов приведён в исходной спецификации KYC (раздел «Словарь»)
и в отдельных справочных разделах для KYC, Verification и OCR.