Verification API

Verification API используется для регистрации верификаций по сценарию (workflow) и получения результатов проверок данных клиента.

Когда использовать

  • проверить персональные данные по доступным источникам;
  • зарегистрировать верификацию по настроенному сценарию;
  • настроить стратегию завершения проверок;
  • получить результат синхронно или через callback;
  • проверить пользователя по отдельному списку или источнику.

Base URL и авторизация

https://api.mts.ru/ID-KYC-Verification-API-Prod/2.0/api/v2

В запросах используется JWT/bearer token. Общие правила описаны в разделах Base URLs и Авторизация.

Основные методы

Метод Endpoint Назначение
POST /api/v2/verifications/workflow-instances Зарегистрировать верификацию по сценарию (workflow).
POST /api/v2/verifications/results Получить результаты по одному или нескольким verificationExternalId.
POST callbackUrl Получить результат асинхронно.
POST /api/v1/rfm/is-in-catalog Проверить наличие клиента в перечне террористов и экстремистов.

Типовой сценарий вызовов

  1. Клиент формирует запрос на регистрацию верификации с указанием workflowId и данными аппликанта.
  2. Клиент передает параметры callback (опционально).
  3. Сервис регистрирует верификацию и возвращает jobResults со статусом приема запроса.
  4. Клиент получает итог через callback или методом POST /api/v2/verifications/results.

Связанные разделы