KYC ПЛАТФОРМА

Виды проверок

Verification API позволяет регистрировать верификации по сценарию (workflow) и запускать несколько проверок в одном запросе. Каждая проверка включается в блоке parameters через флаг isActive.

"parameters": {
  "passportVerification": { "isActive": true },
  "inn": { "isActive": true }
}

Проверка паспорта РФ (passportVerification)

Проверяет действительность паспорта РФ по государственным источникам.

Обязательные поля:

Поле Описание
series Серия документа
number Номер документа
firstName Имя
surname Фамилия
middlename Отчество, если есть
birthday Дата рождения; обязательна при отправке запроса в СМЭВ3

В результате возвращается passportVerification.state:

Значение Описание
valid Паспорт действительный
notValid Паспорт недействительный
noDataFound Данные по паспорту не найдены

Поиск ИНН (inn)

Определяет ИНН по паспортным и персональным данным.

Обязательные поля:

Поле Описание
series Серия документа
number Номер документа
firstName Имя
surname Фамилия
middlename Отчество, если есть
birthday Дата рождения

В результате возвращается блок:

"inn": {
  "status": "success",
  "value": "392920209"
}

Проверка учетной записи ЕСИА (esiaAccountVerification)

Проверяет наличие и статус учетной записи в ЕСИА.

Обязательные и условно обязательные поля:

Поле Описание Комментарий
series Серия документа
number Номер документа Обязательное поле
firstName Имя Обязательное поле
surname Фамилия Обязательное поле
middlename Отчество При наличии
birthday Дата рождения
issuedDate Дата выдачи документа Обязательное поле
userData.phone Телефон Должен быть передан хотя бы один из параметров phone, email, snils, inn
userData.email Email
userData.snils СНИЛС
userData.inn ИНН

В результате могут возвращаться:

Поле Описание
esiaId Идентификатор учетной записи ЕСИА
hasBiometrics Наличие биометрического профиля: true, false или null
biometryType Тип биометрии: Confirmed, Standard, Simplified
accountStatus Статус учетной записи: unverified, verified, trusted, readytoconfirm
messageId Идентификатор запроса в СМЭВ3

Скоринги

Для скорингов обязательный параметр:

Поле Описание
userData.phone Номер телефона
Проверка Описание Результат
riskScoring Риск выхода заемщика в просрочку 90+ дней на горизонте 12 месяцев value от 0 до 1
generalFraudScoring Антифрод-модель с широким таргетом value от 0 до 1
ecomFraudScoring Антифрод-скоринг для e-commerce value от 0 до 1
lifetimeBinScoring Срок жизни SIM в бине 0 – [0, 30), 1 – [30, 61), 2 – [61, 182), 3 – [182, 365), 4 – [365, 1095), 5 – [1095, +inf)
lifetimeOwnerScoring Количество дней с момента смены владельца номера Возвращается status, без value
lifetimeDeviceScoring Количество дней, в течение которых SIM стоит в конкретном устройстве Возвращается status, без value
activeNumberScoring Активность номера за последний месяц 1 – есть активность, 0 – нет активности

Проверка по перечню террористов и экстремистов

В составе запроса верификации проверка включается параметром:

"extremistScreening": {
  "isActive": true
}

Также для этой задачи есть отдельный API-метод:

POST /api/v1/rfm/is-in-catalog

Подробнее см. Проверка по перечню террористов и экстремистов.

Статусы

Для результатов отдельных проверок используются статусы:

Статус Описание
success Данные получены
fail Нет ответа от источника или проверка завершилась неуспешно
inProgress Проверка еще выполняется

Что смотреть дальше