Получение данных пользователя из ЦОИД

Для того, чтобы воспользоваться услугой получения данных пользователя через ЦОИД системы Aitu Passport необходимо чтобы Партнер:

был зарегистрирован в соответствующем окружении Aitu Passport (на тестовой площадке, на продакшн площадке)
создал свой сервис в соответствующем окружении Aitu Passport
подключил к своему сервису сервис (scope) для взаимодействия с ЦОИД "idpc_verification"
установил на свои ресурсы и настроил приложение "Адаптер ЦОИД". Обязательное условие для продакшн среды.
передал сотрудникам Aitu Passport ACCESS_LOGIN и ACCESS_PASSWORD, указанные при настройке Адаптера ЦОИД. Обязательное условие для продакшн среды.

Схема получения данных пользователя через ЦОИД

Схема процесса получения данных пользователя через ЦОИД выглядит следующим образом:

Описание процесса получения данных пользователя через ЦОИД

- В случае, если по условиям договора на оказание услуг Aitu Passport, номер мобильного телефона Пользователя верифицирует:
- В параметре scope обязательно указывается значение idpc_verification (приложение Партнера запрашивает от Aitu Passport услугу получения данных пользователя их ЦОИД)
- Если известен ИИН Пользователя в параметре iin ссылки-запроса авторизации указывается значение ИИН

Для успешного прохождения этапа биометрической идентификации скорость подключения устройства Пользователя к сети интернет должна быть не менее 100кб/сек

Ошибки при взаимодействии с ЦОИД:

№

Сообщение об ошибке для пользователя

Комментарий

Ошибка на сервисе государственного органа

Сервис ЦОИД не доступен

Рекомендация:

Пользователь может попробовать пройти видео-проверку позже после восстановления работоспособности ЦОИД
Партнеру запрещен доступ к данным ЦОИД, необходимо получить доступ и после этого Пользователь сможет пойти идентификацию в ЦОИД

ИИН не найден в базе данных государственного органа. Проверку можно пройти при наличии гражданства Республики Казахстан или Вида на жительство. Проверьте правильность ввода ИИН или обратитесь в службу поддержки

Указанный Пользователем ИИН не найден в базе данных ЦОИД

Рекомендация:

Пользователь должен указать другой ИИН

Ваше фото не совпадает с фото из государственной базы данных. Проверьте правильность введенного ИИН или попробуйте пройти видео-проверку заново

ЦОИД отклонил данные предоставленные Пользователем через AituPassort (изображение лица и ИИН) так как при сравнении предоставленного изображения лица с эталонным изображением, закрепленным за указанным ИИН, система ЦОИД не нашла достаточного уровня совпадения.

Рекомендация:

Если ИИН указан корректно, то необходимо повторить видео-проверку в хорошо освещенном месте, на лице Пользователя не должно быть тени. Пользователь должен прямо смотреть в камеру, необходимо исключить наклоны/повороты лица, моргание и т.д.
Если повторное прохождение видео-проверки не помогло, то возможно потребуется смена документов, так как эталонное фото лица, хранящееся в ЦОИД и закрепленное за указанным ИИН не соответствует текущему изображению лица Пользователя

Проверку можно пройти при достижении 16 летнего возраста

ЦОИД отклонил данные, так как пройти проверку пытается лицо не достигшее 16 летнего возраста.

Рекомендация:

Проверку в ЦОИД должны проходить лица достигшие 16-летнего возраста

Сроки действия объектов

Внимание:

Параметр otp_confirmation действителен в течение 60 минут с момента генерации;
Код авторизации (code) действителен в течение 5 минут с момента генерации;
Токен авторизации (access_token ) действителен в течение 30 дней с момента генерации;
Токен пользователя на устройстве действителен 1 год с момента генерации.

Получение данных Пользователя из ЦОИД

Для получения доступа к персональным данным Пользователя, полученным из ЦОИД, пожалуйста, свяжитесь с представителями Aitu Passport

Далее приложение Партнера должно отправить запрос в Адаптер ЦОИД для получения персональных данных Пользователя.

Приложение Партнера должно отправлять запрос, для получения персональных данных Пользователя, к ЦОИД Адаптеру, а не к Aitu Passport.

Описание метода /v1/personal-data

Данные пользователя будут переданы в приложение Партнера только в том случае, если Партнер является объектом фин., мониторинга в РК и у Партнера заключен договор присоединения к ЦОИД КЦМР. Подробней описано в статье Aitu Passport -> ЦОИД

Параметры запроса метода /v1/personal-data

№

Параметр

Required

Тип

Описание

Источник

iin

Required

String

ИИН Пользователя

id_token -> объект idpc_verification -> iin

requestId

Required

String

Идентификатор запроса

id_token -> объект idpc_verification -> iin

Параметры ответа метода /v1/personal-data

№

Параметр

Тип

Описание

person

Object

Объект, содержащий данные пользователя, полученные из ЦОИД

1.1

documents

Array

1.2

name

String

Имя пользователя

1.3

surname

String

Фамилия пользователя

1.4

patronymic

String

Отчество пользователя

1.5

birthDate

Date

Дата рождения пользователя

1.6

iin

String

ИИН пользователя

1.7

birthPlace

Object

1.8

lifeStatus

Object

1.9

gender

Object

1.10

nationality

Object

1.11

citizenship

Object

1.12

regAddress

Object

Объект Documents

№

Параметр

Тип

Описание

name

String

Имя владельца документа

surname

String

Фамилия владельца документа

patronymic

String

Отчество владельца документа

number

String

Номер документа

birthDate

Date

Дата рождения владельца документа

beginDate

Date

Дата начала действия документа

endDate

Date

Дата окончания дествия документа

status

Object

issueOrganization

Object

type

Object

Объект BirthPlace

№

Параметр

Тип

Описание

city

String

Город

country

Object

district

Object

region

Object

Объект DictionaryItem

№

Параметр

Тип

Описание

code

String

Кодовое обозначение справочного значения

nameKz

String

Наименование справочного значения на казахском языке

nameRu

String

Наименование справочного значения на русском языке

changeDate

DateTime

Дата и время изменения справочного значения

Объект RegAddress

№

Параметр

Тип

Описание

building

String

Номер дома

street

String

Улица

city

String

Город

country

Object

district

Object

region

Object

beginDate

Date

Дата начала регистрации

Тестирование получения данных пользователя из ЦОИД

Для тестовой интеграции предлагаем использовать текущую схему Aitu Passport, без развертывания ЦОИД адаптера на ресурсах Партнера. В результате будет использоваться тестовый ЦОИД адаптер, развернутый в тестовом контуре Aitu Passport, который всегда возвращает положительные ответы из "ЦОИД"

Для доступа к тестовому ЦОИД адаптеру, развернутому в тестовом контуре Aitu Passport, используйте следующие данные:

ACCESS_LOGIN: admin
ACCESS_PERSONAL_DATA_PASSWORD: coidtestpassword

Если в процессе тестирования вы хотите проверить отработку ошибок, которые отображаются Пользователю на экран в Aitu Passport в результате проверки данных в ЦОИД, то передайте следующие ИИН:

ИИН

Сообщение об ошибке для пользователя

000000000001

000000000002

Проверку можно пройти при достижении 16 летнего возраста

000000000003

000000000004

Ошибка на сервисе государственного органа (сервис не доступен)

000000000005

Ошибка на сервисе государственного органа (Партнеру запрещен доступ к данным)

Для всех остальных ИИН, тестовый ЦОИД адаптер, развернутый в тестовом контуре Aitu Passport, вернет фиксированный ответ с данными.

Связанные статьи:

PreviousAitu Passport -> ЦОИД NextЦОИД идентификация - подписание документов ЭЦП

Last updated 1 year ago

Was this helpful?