# Unico Developer Documentation

> Документация платформы верификации личности Unico: сценарии использования, возможности, SDK и справочник по API.

## Документация

- [IDCloud](https://developer.unico.io/ru/index.md): Портал разработчика Unico — документация по API верификации личности IDCloud, SDK и возможностям для web, Android, iOS и Flutter.
- Создать
  - [Регистрация](https://developer.unico.io/ru/products/sign-up.md): Подтверждайте личность новых клиентов в любой точке мира и обеспечивайте безопасную регистрацию. Набор возможностей в рамках единого пути, адаптированного под нужный вам сценарий.
    - [Onboarding](https://developer.unico.io/ru/products/sign-up/onboarding/index.md): Верификация личности в любом регионе с liveness, биометрической верификацией личности, оценкой риска мошенничества и повторным использованием документов.
    - [Верификация без документа](https://developer.unico.io/ru/products/sign-up/non-document-verification/index.md): Верификация личности в любом регионе с liveness, биометрической верификацией личности и оценкой риска мошенничества.
    - [Определение уровня риска мошенничества](https://developer.unico.io/ru/products/sign-up/fraud-risk-level-detection/index.md): Подтверждает, что регистрацию выполняет реальный человек, объединяя Liveness с поведенческим анализом — без захвата документа или государственного идентификатора.
    - [Мультиаккаунт](https://developer.unico.io/ru/products/sign-up/multi-accounts.md): Проверяйте принцип «Одно лицо — один контракт», сопоставляя биометрию лица пользователя с регистрационной базой вашего оператора.
  - [Адаптивная аутентификация](https://developer.unico.io/ru/products/step-up-authentication.md): Верифицируйте личность клиентов в любой точке мира в транзакционных потоках и обеспечивайте безопасный процесс. Набор возможностей в рамках единого сценария, адаптированного под нужную ситуацию.
    - [Умная ревалидация](https://developer.unico.io/ru/products/step-up-authentication/smart-revalidation/index.md): Повторно аутентифицирует пользователей в транзакциях после регистрации, позволяя варьировать методы аутентификации в зависимости от желаемого опыта и критичности потока.
  - [Региональные решения](https://developer.unico.io/ru/products/regional-solutions.md): Продукты, разработанные для решения задач, обусловленных региональным законодательством и правовыми нормами, — потоки верификации личности, адаптированные к местным регуляторным требованиям.
    - [Верификация возраста](https://developer.unico.io/ru/products/regional-solutions/age-verification/index.md): Позволяет подтвердить, что пользователь соответствует минимально допустимому возрасту, полностью биометрическим способом, без предъявления документов.
    - [Верификация данных](https://developer.unico.io/ru/products/regional-solutions/data-verification/index.md): Предоставляет необходимую информацию о человеке, чтобы компании могли соблюдать действующие нормативные требования для финансовых услуг и iGaming.
    - [Верификация без предъявления карты](https://developer.unico.io/ru/products/regional-solutions/card-not-present-verification/index.md): Проверьте, что человек, совершающий транзакцию без предъявления карты, является законным держателем кредитной карты, с помощью биометрии лица и проверки владения картой.
- Возможности
  - [Проверка живости](https://developer.unico.io/ru/capabilities/liveness.md): Возможность, которая проверяет, что пользователь является реальным и живым человеком в момент съёмки селфи. Биометрическая основа практически каждого потока IDCloud.
  - [Проверка личности](https://developer.unico.io/ru/capabilities/identity-verification.md): Возможность, проверяющая, что захваченное лицо принадлежит владельцу документа, удостоверяющего личность.
  - [Повторное использование и распознавание документов](https://developer.unico.io/ru/capabilities/document-reuse-and-capture.md): Возможность, которая запрашивает, хранит и повторно использует документы. Снижает трение в процессах с захватом документов, предлагая классификацию, OCR, FaceMatch и проверку CPF.
  - [Классификация рисков мошенничества](https://developer.unico.io/ru/capabilities/fraud-risk-classification.md): Обнаруживает поведенческие аномалии и мошенничество с идентификационными данными с использованием сетевого эффекта, оценивая транзакцию во временном измерении.
  - [Риск-скор](https://developer.unico.io/ru/capabilities/risk-score.md): Возможность, которая генерирует вероятностный показатель мошенничества, используемый совместно с проверкой личности, когда результат — «неопределённый».
  - [Валидация 1:1](https://developer.unico.io/ru/capabilities/1-1-validation.md): Возможность, которая подтверждает, что текущее лицо совпадает с лицом, использованным в эталонном процессе. Характерна для транзакционных потоков.
  - [Мультиаккаунты](https://developer.unico.io/ru/capabilities/multi-accounts.md): Выполняет биометрический поиск 1:N в базе оператора для определения того, не привязано ли лицо уже к другому активному аккаунту.
  - [Результат проверки сходства Serpro](https://developer.unico.io/ru/capabilities/serpro-similarity-return.md): Возможность, специфичная для кредитов под залог зарплаты (INSS) и операций, требующих сравнения с базой данных Serpro. Возвращает оценку сходства между сделанным селфи и фотографией в базе Serpro.
  - [Умная ревалидация](https://developer.unico.io/ru/capabilities/smart-revalidation.md): Повторно аутентифицирует пользователей в транзакциях после регистрации, позволяя варьировать методы аутентификации в зависимости от желаемого опыта и критичности потока.
  - [Проверка возраста](https://developer.unico.io/ru/capabilities/age-verification.md): Возможность, определяющая, является ли человек перед камерой совершеннолетним, на основе биометрического анализа.
  - [Human Token](https://developer.unico.io/ru/capabilities/human-token.md): Формирует стабильный непрозрачный идентификатор personId на основе селфи — личность является результатом вызова, а не входными данными. Пользователь не указывает никакого идентификатора.
  - [Cardholder Verification](https://developer.unico.io/ru/capabilities/cardholder-verification.md): Возможность, которая подтверждает, что карта принадлежит заявленному владельцу, используя ранее проверенный процесс вместе с CPF и данными карты человека.
  - [Доступные потоки](https://developer.unico.io/ru/capabilities/available-flows.md): Полный каталог предварительно составленных потоков платформы IDCloud — каждый поток представляет собой готовую комбинацию возможностей, передаваемую в поле `flow` запроса POST /v1/process.
- Ресурсы
  - [Глоссарий](https://developer.unico.io/ru/resources/glossary.md): Глоссарий терминов, используемых в документации IDCloud — биометрия, проверка живости, процессы, токены и ключевые понятия.
  - [Часто задаваемые вопросы](https://developer.unico.io/ru/resources/faq.md): Часто задаваемые вопросы об IDCloud — интеграция, аутентификация, коды ошибок и поддерживаемые платформы.
  - [Бэктесты](https://developer.unico.io/ru/resources/backtests.md): Запускайте исторические симуляции для оценки производительности функций на основе прошлых данных.
  - [Повторная обработка и импорт биометрической базы](https://developer.unico.io/ru/resources/reprocessing.md): Руководство по повторной обработке биометрических записей или импорту биометрической базы на платформу Unico.

## Разработчики

- [Справочник API](https://developer.unico.io/ru/developers/api-reference.md): Справочник по IDCloud API — два публичных контракта (Web & SDK и API).
  - [Аутентификация](https://developer.unico.io/ru/developers/api-reference/authentication.md): Поток OAuth2 JWT Bearer, используемый во всех контрактах IDCloud. Узнайте, как получить учётные данные, создать JWT assertion и обменять его на токен доступа.
  - [Среды](https://developer.unico.io/ru/developers/api-reference/environments.md): Хосты sandbox и production для контрактов Web & SDK, API и Magic Link Mexico.
  - [Web и нативный](https://developer.unico.io/ru/developers/api-reference/web-sdk.md): Используется, когда биометрический захват выполняется на стороне Unico (iFrame, Redirect или нативный SDK).
    - [Создание процесса](https://developer.unico.io/ru/developers/api-reference/web-sdk/post-process.md): Создание процесса верификации. Возвращает URL пути и токены SDK, которые передают пользователя на захват, размещённый на стороне Unico.
    - [Получение процесса](https://developer.unico.io/ru/developers/api-reference/web-sdk/get-process.md): Получение текущего состояния и результата процесса верификации.
    - [Потоки](https://developer.unico.io/ru/developers/api-reference/web-sdk/flows.md): Каталог рецептов возможностей, доступных для Web SDK, сгруппированных по продуктам, и значения результата, которые может вернуть каждый из них.
    - [Установка документа процесса](https://developer.unico.io/ru/developers/api-reference/web-sdk/post-process-document.md): Установка документа удостоверения личности для процесса, созданного без него. Запускает возможности, требующие документ.
    - [Получить селфи](https://developer.unico.io/ru/developers/api-reference/web-sdk/get-selfie.md): Получить селфи с водяным знаком, захваченное в ходе процесса верификации.
    - [Получить набор доказательств](https://developer.unico.io/ru/developers/api-reference/web-sdk/get-evidence-set.md): Получение полного пакета доказательств захвата для процесса — используется для соответствия требованиям и регуляторного аудита.
  - [API](https://developer.unico.io/ru/developers/api-reference/api.md): Контракт TCA / Check.Integration — используется, когда клиент управляет захватом и отправляет изображение непосредственно в запросе.
    - [Создание процесса](https://developer.unico.io/ru/developers/api-reference/api/post-processes.md): Создание процесса верификации путём отправки захваченного изображения напрямую. Возвращает синхронный результат.
    - [Получение процесса](https://developer.unico.io/ru/developers/api-reference/api/get-process.md): Получение существующего процесса API-контракта по его идентификатору. Используется для повторных запросов, так как результаты возвращаются синхронно при создании.
    - [Потоки](https://developer.unico.io/ru/developers/api-reference/api/flows.md): Каталог рецептов возможностей, доступных для API-контракта, сгруппированных по продуктам, и значения результата, которые может вернуть каждый из них.
    - [Получение документов для повторного использования](https://developer.unico.io/ru/developers/api-reference/api/get-document.md): Проверьте, есть ли у пользователя документ, доступный для повторного использования, прежде чем начинать новый процесс захвата.
    - [Создание процесса с документом](https://developer.unico.io/ru/developers/api-reference/api/post-processes-document.md): Захватите новый документ или повторно используйте ранее захваченный, привязанный к биометрическому процессу.
    - [Верификация данных](https://developer.unico.io/ru/developers/api-reference/api/get-lists.md): Запрос регистрационных данных, проверки по спискам PEP/AML и связей со спортивными организациями для указанного CPF.
    - [Проверка возраста](https://developer.unico.io/ru/developers/api-reference/api/post-processes-age-validation.md): Создание процесса проверки возраста. Опционально объединяет проверку живости и проверку личности в одном запросе.
  - [SSO / SAML](https://developer.unico.io/ru/developers/api-reference/sso-saml.md): Настройте единый вход (Single Sign-On) через SAML, чтобы ваши пользователи проходили аутентификацию через собственный провайдер идентификации вашей компании вместо отдельных учётных данных Unico.
  - [Коды ошибок](https://developer.unico.io/ru/developers/api-reference/error-codes.md): Сводный каталог кодов ошибок HTTP и платформы для контрактов Web & SDK, API и Magic Link.
  - [Ограничения частоты запросов](https://developer.unico.io/ru/developers/api-reference/rate-limits.md): Ограничения частоты запросов по контракту, заголовок Retry-After и шаблоны для соблюдения лимитов.
  - [Коллекция Postman](https://developer.unico.io/ru/developers/api-reference/postman.md): Готовые к использованию коллекции Postman для контрактов Authentication, Web & SDK и API.
- [SDK и инструменты](https://developer.unico.io/ru/developers/sdks-and-tools/overview.md): Обзор SDK и инструментов интеграции IDCloud — Web SDK, Android SDK, iOS SDK, Flutter SDK и REST API.
  - [Android SDK](https://developer.unico.io/ru/developers/sdks-and-tools/android/requirements.md): | Требование | Версия / значение |
    - [Установка](https://developer.unico.io/ru/developers/sdks-and-tools/android/installation.md): Шаг 1 — Добавьте репозиторий Maven
      - [Специфическая настройка](https://developer.unico.io/ru/developers/sdks-and-tools/android/installation/specific-setup.md): SDK Key
    - [Инициализация](https://developer.unico.io/ru/developers/sdks-and-tools/android/initialization.md): Инициализируйте SDK при запуске приложения — как правило, в классе Application или в методе onCreate вашей входной Activity. Аутентификация SDK с бэкендом занимает несколько секунд, поэтому ранняя инициализация исключает задержку между нажатием кнопки захвата и открытием камеры. Подробности см. в разделе Рекомендации.
    - Процесс захвата
      - Типы захвата
        - [Liveness (биометрическое селфи)](https://developer.unico.io/ru/developers/sdks-and-tools/android/capture-flow/capture-types/liveness.md): Биометрический захват селфи со встроенной проверкой живости. SDK сопровождает пользователя до получения биометрически валидного кадра через SmartFrames и возвращает изображение в формате Base64 + JWT.
        - [Пользовательские сценарии](https://developer.unico.io/ru/developers/sdks-and-tools/android/capture-flow/capture-types/user-journeys.md): Пользовательские сценарии — это многоэтапные сессии захвата, организованные SDK совместно с настроенным потоком. Например, поток с Liveness + Risk Score + Document Capture + Electronic Signature выполняет селфи, захват документа и подпись в одной сессии.
        - [Тихая ревалидация](https://developer.unico.io/ru/developers/sdks-and-tools/android/capture-flow/capture-types/silent-revalidation.md): Использует движок Тихая ревалидация, который анализирует поведенческий контекст пользователя в рамках сетевого эффекта Unico и выдаёт сигнал уверенности для текущей транзакции. Другими словами, мы предоставляем уровень уверенности в том, что это именно тот пользователь, который ожидается в транзакции.
      - [Получение результата](https://developer.unico.io/ru/developers/sdks-and-tools/android/capture-flow/receiving-the-result.md): SDK возвращает результат захвата через обратные вызовы (callbacks), определённые в интерфейсе слушателя, используемом во время сеанса захвата.
    - [Настройка](https://developer.unico.io/ru/developers/sdks-and-tools/android/customization.md): Эти настройки доступны только в том случае, если поток захвата — document-capture или liveness.
    - [Обработка ошибок](https://developer.unico.io/ru/developers/sdks-and-tools/android/error-handling.md): Вся обработка ошибок для Android SDK централизована в этом разделе. Обратный вызов onErrorAcessoBio получает объект ErrorBio с полями code (Int) и description (String).
    - Справочник API
      - [API инициализации](https://developer.unico.io/ru/developers/sdks-and-tools/android/api-reference/initialization-api.md): | Класс | Описание |
      - [API захвата](https://developer.unico.io/ru/developers/sdks-and-tools/android/api-reference/capture-api.md): Вызывайте эти методы на интерфейсе UnicoCheckCamera, полученном из builder'а SDK. После подготовки коллбэк CameraListener.onCameraReady(cameraOpener) предоставляет opener для запуска захвата.
      - [Интерфейсы Callback / Listener](https://developer.unico.io/ru/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces.md): Коллбэки жизненного цикла сессии SDK. Передайте реализацию в конструктор AcessoBio.
      - [API кастомизации](https://developer.unico.io/ru/developers/sdks-and-tools/android/api-reference/customization-api.md): Передайте реализацию темы в builder с помощью setTheme():
      - [Перечисления](https://developer.unico.io/ru/developers/sdks-and-tools/android/api-reference/enums.md): Определяет тип документа для захвата. Передаётся в prepareDocumentCamera для настройки сессии захвата.
    - [Ресурсы](https://developer.unico.io/ru/developers/sdks-and-tools/android/resources.md): - Инициализируйте SDK при загрузке приложения, а не при нажатии кнопки захвата. Аутентификация с бэкендом занимает несколько секунд и, если выполняется одновременно с открытием камеры, создаёт ощущение задержки.
      - [Известные проблемы](https://developer.unico.io/ru/developers/sdks-and-tools/android/resources/known-issues.md): - Release-сборка завершается ошибкой, а debug работает — вероятно, проблема с обфускацией. Проверьте правила ProGuard/DexGuard.
      - [История изменений](https://developer.unico.io/ru/developers/sdks-and-tools/android/resources/release-notes.md): Всегда поддерживайте Android SDK в актуальном состоянии с последней доступной версией. Для нумерации версий мы используем семантическое версионирование.
  - [iOS SDK](https://developer.unico.io/ru/developers/sdks-and-tools/ios/requirements.md): | Требование | Версия / значение |
    - [Установка](https://developer.unico.io/ru/developers/sdks-and-tools/ios/installation.md): Шаг 1 — Использование CocoaPods
      - [Особая настройка](https://developer.unico.io/ru/developers/sdks-and-tools/ios/installation/specific-setup.md): SDK Key
    - [Инициализация](https://developer.unico.io/ru/developers/sdks-and-tools/ios/initialization.md): Реализуйте протокол AcessoBioConfigDataSource в вашем классе:
    - Процесс захвата
      - Типы захвата
        - [Liveness (биометрическое селфи)](https://developer.unico.io/ru/developers/sdks-and-tools/ios/capture-flow/capture-types/liveness.md): Захват биометрического селфи со встроенной проверкой liveness, возвращающий захваченный кадр в формате Base64 и JWT.
        - [Пользовательские сценарии](https://developer.unico.io/ru/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys.md): Пользовательские сценарии — это многоэтапные сессии захвата, организованные SDK совместно с настроенным потоком. Например, поток с Liveness + Risk Score + Document Capture + Electronic Signature выполняет захват селфи, документа и подписи в одной сессии.
        - [Тихая ревалидация](https://developer.unico.io/ru/developers/sdks-and-tools/ios/capture-flow/capture-types/silent-revalidation.md): Использует движок Тихая ревалидация, который анализирует поведенческий контекст пользователя в рамках сетевого эффекта Unico и выдаёт сигнал уверенности для текущей транзакции. Другими словами, мы предоставляем уровень уверенности в том, что это именно тот пользователь, который ожидается в транзакции.
      - [Получение результата](https://developer.unico.io/ru/developers/sdks-and-tools/ios/capture-flow/receiving-the-result.md): SDK возвращает результат захвата через обратные вызовы, определённые в интерфейсах делегатов, используемых во время сеанса захвата.
    - [Настройка](https://developer.unico.io/ru/developers/sdks-and-tools/ios/customization.md): Эти настройки доступны только в том случае, если поток захвата — document-capture или liveness.
    - [Обработка ошибок](https://developer.unico.io/ru/developers/sdks-and-tools/ios/error-handling.md): Вся обработка ошибок iOS SDK централизована в этом разделе. Обратный вызов onErrorAcessoBioManager получает объект ErrorBio, предоставляющий методы getCode() и getDescription().
    - Справочник API
      - [API инициализации](https://developer.unico.io/ru/developers/sdks-and-tools/ios/api-reference/initialization-api.md): | Класс | Описание |
      - [API захвата](https://developer.unico.io/ru/developers/sdks-and-tools/ios/api-reference/capture-api.md): | Метод | Описание |
      - [Интерфейсы Callback / Listener](https://developer.unico.io/ru/developers/sdks-and-tools/ios/api-reference/callback-listener-interfaces.md): | Метод | Событие |
      - [API настройки](https://developer.unico.io/ru/developers/sdks-and-tools/ios/api-reference/customization-api.md): | Метод | Описание |
      - [Перечисления](https://developer.unico.io/ru/developers/sdks-and-tools/ios/api-reference/enums.md): Определяет тип документа для захвата. Передаётся в openDocument для настройки сессии захвата.
    - [Ресурсы](https://developer.unico.io/ru/developers/sdks-and-tools/ios/resources.md): - Инициализируйте SDK при загрузке приложения (как правило, в didFinishLaunchingWithOptions или viewDidLoad в AppDelegate), а не при нажатии кнопки захвата. Аутентификация с бэкендом занимает несколько секунд, и если выполнять её одновременно с открытием камеры, возникает ощущение задержки.
      - [Известные проблемы](https://developer.unico.io/ru/developers/sdks-and-tools/ios/resources/known-issues.md): - Тень в конце потока — управление потоком делегируется вызывающей стороне SDK. Если после успешного захвата появляется тень или экран не закрывается, реализуйте сброс внутри onSuccessSelfie:
      - [Примечания к выпуску](https://developer.unico.io/ru/developers/sdks-and-tools/ios/resources/release-notes.md): Всегда поддерживайте ваш iOS SDK в актуальном состоянии с последней доступной версией. Для нумерации версий мы используем семантическое версионирование.
  - [Flutter SDK](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/requirements.md): | Требование | Версия / значение |
    - [Установка](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/installation.md): Для настройки Unico SDK для Flutter выполните следующие шаги:
      - [Специальная настройка](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/installation/specific-setup.md): Ключ SDK
    - [Инициализация](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/initialization.md): Инициализируйте SDK при загрузке приложения — как правило, в main() или в initState() вашего корневого виджета. Подробности о том, почему не следует инициализировать при нажатии кнопки захвата, см. в разделе Рекомендации.
    - Процесс захвата
      - Типы захвата
        - [Liveness (биометрическое селфи)](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/capture-flow/capture-types/liveness.md): Захват биометрического селфи со встроенной проверкой liveness. SDK направляет пользователя до получения биометрически валидного кадра с помощью SmartFrames и возвращает изображение в формате Base64 + JWT.
        - [Пользовательские сценарии](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/capture-flow/capture-types/user-journeys.md): Пользовательские сценарии (User Journeys) — это многоэтапные сессии захвата, организуемые SDK совместно с настроенным потоком. Например, поток idchecktrustdocssign выполняет селфи + документ + подпись в рамках одной сессии.
        - [Тихая ревалидация](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/capture-flow/capture-types/silent-revalidation.md): Использует движок Тихая ревалидация, который анализирует поведенческий контекст пользователя в рамках сетевого эффекта Unico и выдаёт сигнал уверенности для текущей транзакции. Другими словами, мы предоставляем уровень уверенности в том, что это именно тот пользователь, который ожидается в транзакции.
      - [Получение результата](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/capture-flow/receiving-the-result.md): SDK возвращает результат захвата через колбэки, определённые в интерфейсе слушателя, используемом во время сессии захвата.
    - [Настройка](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/customization.md): Эти настройки доступны только в том случае, если поток захвата — document-capture или liveness.
    - [Обработка ошибок](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/error-handling.md): Вся обработка ошибок для Flutter SDK сосредоточена в этом разделе. Коллбэки onErrorUnico, onErrorSelfie и onErrorDocument получают объект UnicoError, предоставляющий методы getCode() и getDescription().
    - Справочник API
      - [API инициализации](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/api-reference/initialization-api.md): | Класс | Описание |
      - [API захвата](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/api-reference/capture-api.md): | Метод | Описание |
      - [Интерфейсы обратного вызова и слушателей](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/api-reference/callback-listener-interfaces.md): | Метод | Триггер |
      - [API настройки](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/api-reference/customization-api.md): | Метод | Описание |
      - [Перечисления](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/api-reference/enums.md): Определяет тип документа для захвата. Передаётся в openCameraDocument для настройки сессии захвата.
    - [Ресурсы](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/resources.md): - Используйте официальный Flutter-плагин. Не реализуйте нативные SDK через мосты — такой подход порождает ошибки, не отображённые в Engineering-команде Unico.
      - [Известные проблемы](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/resources/known-issues.md): - Release-сборка завершается с ошибкой, а debug работает — вероятнее всего, это проблема обфускации на стороне Android. Нативные SDK не могут быть обфусцированы. Проверьте правила ProGuard/DexGuard.
      - [Примечания к выпуску](https://developer.unico.io/ru/developers/sdks-and-tools/flutter/resources/release-notes.md): Журнал изменений Unico Flutter SDK — история версий, новые функции, исправления ошибок и обновления нативных SDK Android и iOS.
  - [Веб-интеграция](https://developer.unico.io/ru/developers/sdks-and-tools/web.md): Варианты интеграции на стороне клиента для контракта Web & SDK — redirect-потоки, iFrame SDK и JavaScript-библиотека захвата.
    - [Web SDK](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/requirements.md): Фрейм захвата поддерживает WebRTC и более новые версии браузеров, перечисленных ниже. Корректная работа на очень старых версиях не гарантируется.
      - [Установка](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/installation.md): Настройте CSP, установите пакет Web SDK и загрузите файлы ресурсов, необходимые для функции «Проверка живости».
        - [Специальная настройка](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/installation/specific-setup.md): SDK Key
      - [Инициализация](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/initialization.md): Инициализируйте SDK как можно раньше — как правило, при загрузке страницы или компонента, содержащего рамку захвата. Подробнее о том, почему не следует инициализировать по нажатию кнопки захвата, см. в разделе Лучшие практики.
      - Процесс захвата
        - Типы захвата
          - [Liveness (биометрическое селфи)](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/liveness.md): Захват биометрического селфи со встроенной проверкой признаков живого присутствия. SDK ведёт пользователя до получения биометрически валидного кадра через SmartFrames и возвращает изображение в формате Base64 + JWT.
          - [Захват документа](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/document-capture.md): Захват документов, удостоверяющих личность. SDK отображает рамку, помогающую пользователю правильно расположить документ; после позиционирования пользователь нажимает кнопку для съёмки фото.
        - [Получение результата](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/capture-flow/receiving-the-result.md): SDK возвращает результат захвата через объект callback, переданный в open(). Оба обработчика — success и error — обязательны.
        - [Сбор данных мониторинга](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection.md): Необязательные метаданные, которые можно прикрепить к любому сеансу захвата для идентификации пользователя и потока в инструментах мониторинга и наблюдаемости.
      - [Настройка](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/customization.md): Web SDK поддерживает два направления настройки: язык и визуальная тема.
      - [Обработка ошибок](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/error-handling.md): Вся обработка ошибок Web SDK сосредоточена в этом разделе. Callback error получает объект ErrorBio, предоставляющий методы getCode() и getDescription().
      - [Доступность](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/accessibility.md): SDK реализует компоненты, подготовленные с HTML-атрибутами для обеспечения доступности — aria-label, tabindex, role и другими — которые позволяют осуществлять навигацию с клавиатуры между элементами, активируют звуковое сопровождение и используются программами чтения с экрана.
      - Справочник API
        - [API инициализации](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api.md): | Класс | Описание |
        - [API захвата](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/api-reference/capture-api.md): | Метод | Описание |
        - [Интерфейсы колбэков / обработчиков событий](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/api-reference/callback-listener-interfaces.md): Web SDK использует единственный объект callback, передаваемый в open(), вместо платформо-специфичных интерфейсов обработчиков событий.
        - [API настройки внешнего вида](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/api-reference/customization-api.md): | Метод | Описание |
        - [Перечисления](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/api-reference/enums.md): Определяет режим камеры для захвата селфи. Передаётся в prepareSelfieCamera.
      - [Ресурсы](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/resources.md): - Инициализируйте SDK при загрузке страницы, а не по нажатию кнопки захвата. Аутентификация с бэкендом занимает несколько секунд, и если выполнять её одновременно с открытием камеры, возникает ощущение задержки.
        - [Известные проблемы](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/resources/known-issues.md): - CSP блокирует загрузку SDK — без необходимых директив CSP (worker-src, script-src и др.) Web SDK не может загрузить Web Workers и дополнительные ресурсы. Проверьте конфигурацию CSP.
        - [История изменений](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-sdk/resources/release-notes.md): Всегда обновляйте Web SDK до последней доступной версии. Мы используем семантическое версионирование для нумерации версий.
    - [Интеграция веб-приложений](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-integration.md): Как реализовать интеграцию контракта Web & SDK на стороне клиента — редиректы и настройка iFrame SDK.
      - [Ресурсы](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-integration/resources.md): Лучшие практики и история изменений для интеграции с Unico Web App Integration SDK (unico-journey-sdk).
        - [История изменений](https://developer.unico.io/ru/developers/sdks-and-tools/web/web-integration/resources/release-notes.md): Список изменений SDK интеграции веб-приложения Unico (unico-journey-sdk) — история версий, новые возможности и заметки по обновлению.
  - [Стандарт захвата](https://developer.unico.io/ru/developers/sdks-and-tools/capture-standard.md): Для оптимальной производительности возможностей платформы IDCloud мы рекомендуем использовать наши SDK (Web, Android, iOS, Flutter). Они обеспечивают наилучшее функционирование продукта в целом — как с точки зрения процента отказов, так и в части проверки Liveness.
  - [Лучшие практики](https://developer.unico.io/ru/developers/sdks-and-tools/best-practices-for-sdk-implementation.md): Рекомендации по интеграции, обновлению, тестированию и безопасному выпуску SDK Unico, включая правила безопасности тестовой среды (UAT).
  - [Политика обновлений](https://developer.unico.io/ru/developers/sdks-and-tools/update-policy.md): Политика обновления SDK Unico: зачем она нужна, минимальные сроки для клиентов и как сохранить поддержку и защиту.
- [Вебхуки и события](https://developer.unico.io/ru/developers/webhooks-and-events.md): Введение в вебхуки IDCloud — получайте уведомления в реальном времени о событиях процесса верификации личности.
  - [Настройка](https://developer.unico.io/ru/developers/webhooks-and-events/setup.md): Пошаговое руководство по настройке вебхуков IDCloud — самостоятельная настройка через портал для Web и SDK, а также настройка по клиенту для API-интеграций с использованием Check orchestration (только для Бразилии).
  - [Типы событий](https://developer.unico.io/ru/developers/webhooks-and-events/event-types.md): Справочник по типам событий вебхуков IDCloud — полезные данные завершённых, неуспешных процессов и изменений статуса.
  - [Безопасность](https://developer.unico.io/ru/developers/webhooks-and-events/security.md): Как проверять и защищать полезные данные вебхуков IDCloud — верификация подписи и лучшие практики.
  - [Стратегия резервного варианта](https://developer.unico.io/ru/developers/webhooks-and-events/fallback.md): Как получить результаты процессов при временной недоступности сервиса вебхуков.
- [Интеграция AI-агентов](https://developer.unico.io/ru/developers/llms.md): Читайте эту документацию из AI-агентов и LLM-инструментов с помощью Markdown-версии каждой страницы, индекса llms.txt для каждого языка и панели действий.
- Региональные решения
  - [Верификация без предъявления карты](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification.md): Документация REST API Верификация без предъявления карты — объединяет идентификацию покупателя и проверку держателя кредитной карты в платёжных транзакциях.
    - О верификации без предъявления карты
      - [Что такое Верификация без предъявления карты](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/about-idpay/unico-id-pay.md): Что такое Верификация без предъявления карты и какие гарантии она предоставляет для платёжных транзакций: проверка живости, соответствие личности держателю карты и защита ответственности.
      - [Функции](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/about-idpay/feature.md): Основные функции Верификации без предъявления карты: платёжные транзакции и онбординг кредитной карты, а также их различия.
      - [Варианты использования](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/about-idpay/use-cases.md): Варианты использования Верификации без предъявления карты для оформления заказа (checkout), предварительного анализа, инструментов анализа, восстановления продаж и онбординга кредитной карты.
      - [Chargeback](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback.md): Гарантия Unico по ответственности за Chargeback при проверках Верификации без предъявления карты: когда она применяется, необходимые условия и исключения.
    - [Интеграция](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/overview.md): Пошаговый обзор интеграции Верификации без предъявления карты: аутентификация, настройка интерфейса, создание транзакции и обработка уведомления webhook.
      - [Аутентификация](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication.md): Верификация без предъявления карты использует аутентификацию OAuth2 через учётную запись службы (service account, two-legged) для выдачи токенов доступа к REST API.
        - [Создание учётной записи службы](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/creating-a-service-account.md): Как запросить учётную запись службы для аутентификации Верификации без предъявления карты по схеме server-to-server, включая генерацию пары ключей.
        - [Подготовка к выполнению аутентифицированного запроса к API](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/preparing-authenticated-request.md): Как сформировать и подписать JWT, запросить токен доступа у платформы OAuth2 и обработать ответ с токеном и его срок действия.
        - [Дополнительные ресурсы](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources.md): Вспомогательные материалы по аутентификации Верификации без предъявления карты: пример реализации на JavaScript, коды ошибок аутентификации и коллекция Postman.
          - [Пример на JavaScript](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/example-in-javascript.md): Пример реализации на JavaScript для формирования и подписи JWT и запроса токена доступа Верификации без предъявления карты.
          - [Ошибки аутентификации](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/authentication-errors.md): Коды ошибок, возвращаемые платформой аутентификации OAuth2 Верификации без предъявления карты, и способы их устранения.
          - [Коллекция Postman](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/postman-collection.md): Готовая к использованию коллекция Postman для REST API Верификации без предъявления карты: платёжные транзакции, chargeback и регистрация кредитной карты.
      - [API](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis.md): Все доступные REST-эндпоинты для продукта Верификации без предъявления карты: справочник API, ошибки и перечисления.
        - [Справочник API](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference.md): Справочник эндпоинтов REST API Верификации без предъявления карты: платёжные транзакции, chargeback, регистрация кредитной карты и контекстные сигналы.
          - [Платёжные транзакции](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions.md): Справочник REST API для создания платёжных транзакций, проверки статуса, получения доказательств и повторной отправки уведомлений в Верификации без предъявления карты.
          - [Chargeback](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback.md): Справочник REST API для запроса анализа chargeback и проверки его статуса в Верификации без предъявления карты.
          - [Onboarding кредитной карты](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding.md): Справочник REST API для валидации кредитной карты и проверки статуса валидации в функции регистрации кредитной карты Верификации без предъявления карты.
          - [Контекстные сигналы](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/context-signals.md): Справочник REST API для получения оценки риска мошенничества (самостоятельное мошенничество или социальная инженерия) по завершённой кредитной транзакции в Верификации без предъявления карты.
        - [Ошибки](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/errors.md): Обзор HTTP-кодов состояния и ответов об ошибках, возвращаемых эндпоинтами REST API Верификации без предъявления карты.
        - [Перечисления](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated.md): Перечисления, используемые в REST API Верификации без предъявления карты: коды результатов транзакций и коды результатов chargeback.
      - [Webhook](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/webhook.md): Как настроить и получать уведомления Webhook в Верификации без предъявления карты, включая формат запроса/ответа и важные аспекты, такие как ограничения частоты запросов и идемпотентность.
      - [Управление процессом](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/overview.md): Как работает интеграция SDK Верификации без предъявления карты: стандарты Webview, SDK и Redirect, а также шаги API, необходимые перед интеграцией в вашем приложении.
        - [Требования](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/requirements.md): Минимальные версии ОС и матрица совместимости браузеров/ОС для окна захвата SDK Верификации без предъявления карты.
        - Mobile
          - [Android](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/android.md): Управление процессом захвата Верификации без предъявления карты в Android через CustomTabs: зависимость, открытие вкладки, настройка манифеста и чтение обратного вызова.
          - [iOS](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios.md): Два рекомендуемых подхода к управлению процессом захвата Верификации без предъявления карты на iOS: WKWebView и ASWebAuthenticationSession.
            - [WKWebView](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/wkwebview.md): Как реализовать процесс захвата Верификации без предъявления карты на iOS с помощью WKWebView: открытие представления, контроль момента закрытия и необходимые разрешения.
            - [ASWebAuthenticationSession](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/aswebauthenticationsession.md): Как реализовать процесс захвата Верификации без предъявления карты на iOS с помощью ASWebAuthenticationSession: контроллер аутентификации, настройка сессии и необходимые разрешения.
          - [Flutter](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/flutter.md): Управление процессом захвата Верификации без предъявления карты во Flutter через inappwebview: открытие webview, отслеживание изменений URL и разрешение на использование камеры.
        - Web
          - [SDK](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/sdk.md): Как реализовать Unico SDK для веб: установка, методы init/open, рекомендации по полноэкранному режиму и модель безопасности iFrame + токен аутентификации.
          - [Redirect (устарело)](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/redirect-deprecated.md): Устаревшие модели веб-интеграции для Верификации без предъявления карты: window.open() и полное перенаправление страницы. Для лучшей конверсии используйте SDK.
      - [Настройки](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/customizations.md): Настройка логотипа, цвета и формы кнопок для процесса Верификации без предъявления карты, с рекомендациями по контрастности для доступности.
      - [Тихая верификация](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/integration/silent-verification.md): Включите фоновую верификацию для повторных пользователей в Верификации без предъявления карты, используя сигналы и повторяемость, чтобы решить, можно ли одобрить транзакцию в тихом режиме.
    - Помощь и FAQ
      - [Лучшие практики коммуникации](https://developer.unico.io/ru/developers/regional-solutions/card-not-present-verification/help-and-faq/best-communication-practices.md): Советы по информированию конечных пользователей о биометрической проверке личности Верификации без предъявления карты для снижения трудностей и количества обращений в поддержку.

## Product Guide

- [Руководство по продукту](https://developer.unico.io/ru/product-guide.md): Инструкции по эксплуатации продуктов Unico — как использовать каждый экран, каждое поле и каждую настройку, шаг за шагом.
- [IDCloud Portal](https://developer.unico.io/ru/product-guide/portal-idcloud.md): Инструкции по работе с IDCloud Portal — настройка процесса для ваших клиентов, уведомлений для вашей системы и проверки QR-кода.
  - Настройки
    - [Настройка оформления процесса](https://developer.unico.io/ru/product-guide/portal-idcloud/settings/journey-customization.md): Настройте визуальное оформление процесса — логотип, цвета, фон и форму кнопок — непосредственно в IDCloud Portal, с предпросмотром в реальном времени.
    - [Вебхук](https://developer.unico.io/ru/product-guide/portal-idcloud/settings/webhook.md): Настройте, куда IDCloud отправляет уведомления вашей системе при изменении состояния процесса, как выполняется аутентификация при обращении к вашему API и что происходит, если ваш API не отвечает.
    - [QR-код](https://developer.unico.io/ru/product-guide/portal-idcloud/settings/qr-code.md): Включите отображение QR-кода в процессе проверки, чтобы клиент мог начать на компьютере и продолжить на мобильном устройстве, непосредственно из IDCloud Portal.