KYC ПЛАТФОРМА

Доступ и подключение

Этот раздел описывает, какие шаги нужно пройти, чтобы подключиться к продуктам МТС KYC платформы:

  • Удалённая идентификация (KYC)
  • Mobile ID
  • Проверка данных (Verification)
  • Распознавание документов (OCR)

Общие шаги для всех продуктов

  1. Договор и оформление доступа
    – Заключите договор с МТС и укажите, какие именно продукты вы планируете использовать (KYC, Mobile ID, Verification, OCR).
    – Для некоторых сценариев (особенно KYC и Verification) потребуется согласование работы с ПДн и 115‑ФЗ.

  2. Регистрация клиента в API‑шлюзе
    – Вам выдаются:

    • client_id и client_secret для получения токенов доступа (OAuth 2.0);
    • идентификатор тенанта (TenantId), если используется.
    • Доступ к тестовой/боевой среде ограничивается списком доверенных IP/каналов.

  3. Создание тестового контура
    – Рекомендуется начать с тестового (Prodlike/DEV/RC) окружения.
    – По каждому продукту есть свой базовый URL (см. Окружения).

  4. Получение Postman‑коллекций
    – Для KYC, Verification и OCR подготовлены коллекции Postman на интеграционной платформе.
    – Ссылки и идентификаторы API выдаёт менеджер со стороны МТС (см. Postman и примеры).

  5. Настройка callback‑URL (если используются webhooks)
    – Для KYC и Verification настраиваются callback‑адреса для получения результатов.
    – Для Mobile ID настраиваются редиректы/обратные URL после аутентификации.
    – OCR в базовом варианте работает синхронно (без callback).


Доступ к модулю KYC

Основные операции описаны в документе
«Модуль удалённой идентификации МТС KYC платформы версия 2 (версия для внешних клиентов)».

Минимальные шаги:

  1. Включить продукт KYC в договоре и согласовать использование удалённой идентификации.
  2. Получить доступ к API RIM (https://api.mts.ru/rim/2.0/api/v2/...):
    – создать учётную запись приложения;
    – получить client_id и client_secret;
    – согласовать callback‑адреса для идентификаций.
  3. Подготовить интеграцию по API:
    – создавать заявителей (Applicants) — см. Создать заявителя;
    – запускать заявки на идентификацию по workflow — см. Workflow instances;
    – получать результат по идентификации — см. Получить идентификацию;
    – при необходимости использовать PostMessage.

Подробная схема «создай заявителя → запусти workflow → получи результат» описана в разделе
«Продукты → Удалённая идентификация (KYC) → Как это работает».

Доступ к Mobile ID

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

  1. Согласовать использование Mobile ID:
    – указать сценарии (аутентификация, подтверждение номера, дополнительные атрибуты);
    – согласовать объём данных (scope).
  2. Получить параметры клиента Mobile ID:
    – client_id, client_secret;
    – зарегистрированные redirect‑URI для /authorize.
  3. Настроить интеграцию по OAuth 2.0 / OpenID Connect:
    – базовый URL API: см. Методы Mobile ID;
    – работа через стандартные точки /authorize, /token, /userinfo.

Быстрый сценарий подключения описан в разделе
«Продукты → Mobile ID → Быстрый старт».

Доступ к сервису Verification

Сервис Verification подключается как дополнительный сервис проверки данных.

  1. Выбрать, какие проверки будут использоваться: – паспорт РФ (СМЭВ3/СМЭВ4); – ИНН; – ЕСИА; – скоринги, антифрод‑модели; – проверки по экстремистским/санкционным спискам.
  2. Получить доступ к API Verification: – базовые URL прод/Prodlike — см. Окружения; – выданный токен авторизации используется в заголовке Authorization: Bearer.
  3. Согласовать callback‑адрес: – callbackUrl и формат данных в результатах; – политику хранения и обработки результатов в вашей системе.

Детали работы сервиса см. в разделе
«Продукты → Проверка данных (Verification)».

Доступ к сервису OCR

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

  1. Определить, какие документы нужно распознавать: – международные (anydoc); – российские (anydoc / anyrus); – конкретные типы (паспорт, ВУ, ВНЖ, свидетельства и др.).
  2. Получить доступ к API OCR: – боевой URL ID-KYC-DOC-Recognition-Prod — см. Recognise; – учётные данные для получения токена (см. Авторизация).
  3. Согласовать ограничения и тарификацию: – размер файлов; – допустимые форматы; – правила тарификации при нераспознанных документах.

Общая функциональность и формат ответа описаны в разделе
«Продукты → Распознавание документов (OCR)».