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 |
Проверить наличие клиента в перечне террористов и экстремистов. |
Типовой сценарий вызовов
- Клиент формирует запрос на регистрацию верификации с указанием
workflowIdи данными аппликанта. - Клиент передает параметры callback (опционально).
- Сервис регистрирует верификацию и возвращает
jobResultsсо статусом приема запроса. - Клиент получает итог через callback или методом
POST /api/v2/verifications/results.
Связанные разделы
- Verification API – продуктовый обзор.
- Виды проверок – доступные проверки.
- Стратегии завершения – логика ожидания результата.