События технологий
События технологий предоставляют информацию о ходе и результатах выполнения конкретных проверок в рамках сессии. Для каждой технологии генерируются события technology.start в момент начала проверки и technology.end по её завершении. События содержат специфичные для каждой технологии результаты и, в случае неуспеха, детальную информацию о причинах ошибки.
Структура failure_reason
| Поле |
Тип |
Описание |
type |
string |
Тип ошибки |
detail |
string |
Детальное описание ошибки (опционально) |
События технологии Liveness
Liveness Head Position
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
eye_closed |
boolean |
Признак закрытых глаз |
prediction |
string |
Оценка вероятности живости (от 0 до 1) |
face_center |
boolean |
Признак расположения лица по центру |
face_direction |
string |
Направление лица |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "8c44f37b-6040-40ed-b391-682a3b29dc2b",
"event": "technology.start",
"session_id": "70f5e424-07a9-4393-ba31-7f3de8681a72",
"created": 1734597343,
"success": true,
"flow_name": "Liveness Head Position Flow",
"metadata": {},
"data": {
"technology_code": "LDHP",
"technology_name": "Liveness Head Position"
}
}
technology.end
{
"id": "35bef608-a327-4b46-a4e0-cf1a8c6e0703",
"event": "technology.end",
"session_id": "70f5e424-07a9-4393-ba31-7f3de8681a72",
"created": 1734597388,
"success": true,
"flow_name": "Liveness Head Position Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": false,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Distance
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
eye_closed |
boolean |
Признак закрытых глаз |
prediction |
string |
Оценка вероятности живости (от 0 до 1) |
face_center |
boolean |
Признак расположения лица по центру |
face_direction |
string |
Направление лица |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "f9dd4030-1414-443b-9a26-62d952cbec7a",
"event": "technology.start",
"session_id": "6882098c-7b0c-4cc2-b043-d0c290b40198",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Distance Flow",
"metadata": {},
"data": {
"technology_code": "LDD",
"technology_name": "Liveness Face Distance"
}
}
technology.end
{
"id": "0069285b-b28f-4105-b718-42dfc938efd8",
"event": "technology.end",
"session_id": "6882098c-7b0c-4cc2-b043-d0c290b40198",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Distance Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Pro Max
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
eye_closed |
boolean |
Признак закрытых глаз |
prediction |
string |
Оценка вероятности живости (от 0 до 1) |
face_center |
boolean |
Признак расположения лица по центру |
face_direction |
string |
Направление лица |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Pro Max Flow",
"metadata": {},
"data": {
"technology_code": "LDPM",
"technology_name": "Liveness Pro Max"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Pro Max Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Liveness Short
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
eye_closed |
boolean |
Признак закрытых глаз |
prediction |
string |
Оценка вероятности живости (от 0 до 1) |
face_center |
boolean |
Признак расположения лица по центру |
face_direction |
string |
Направление лица |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Liveness Short(Fast) Flow",
"metadata": {},
"data": {
"technology_code": "LDSH",
"technology_name": "Liveness Short"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Liveness Short(Fast) Flow",
"metadata": {},
"data": {
"liveness_result": {
"result": true,
"eye_closed": true,
"prediction": "0.9980",
"face_center": true,
"face_direction": "forward",
"failure_reason": null
}
}
}
Face2Face
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
prediction |
string |
Оценка сличения (от 0 до 1) |
prediction_percent |
string |
Процент сличения (от 0 до 100) |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Face2Face Flow",
"metadata": {},
"data": {
"technology_code": "F2F",
"technology_name": "Face2Face"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Face2Face Flow",
"metadata": {},
"data": {
"face2face_result": {
"result": true,
"prediction": "0.9980",
"prediction_percent": "99",
"failure_reason": null
}
}
}
События технологии E-Document
E-Document
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
result_json |
object | null |
Данные документа |
document_type |
string |
Тип документа |
phone |
string |
Номер телефона субъекта |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "E-Document Flow",
"metadata": {},
"data": {
"technology_code": "ED",
"technology_name": "EDocument"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "E-Document Flow",
"metadata": {},
"data": {
"edocument_result": {
"result": true,
"result_json": {
"data": {
"common": {
"docOwner": {
"firstName": "ИМЯ",
"lastName": "ФАМИЛИЯ",
"engFirstName": "NAME",
"middleName": "",
"engSurname": "SURNAME",
"iin": "010101010101"
},
"docIssuedDate": 1523383200000,
"docIssuer": {
"nameRu": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК",
"nameKk": "ҚР ІШКІ ІСТЕР МИНИСТРЛІГІ",
"nameEn": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК"
},
"docNumber": "0101010101",
"docType": {
"nameRu": "Удостоверение личности",
"code": "IdentityCard",
"nameKk": "Жеке куәлік",
"nameEn": "Identity card"
},
"docExpirationDate": 1838916000000,
"docUri": "IdentityCard:0101010101"
},
"domain": {
"birthPlace": {
"nameRu": "ГОРОД",
"nameKk": "ГОРОД",
"nameEn": "CITY"
},
"docIssuedDate": 1523383200000,
"nationality": {
"nameRu": "ҚАЗАҚ",
"nameKk": "ҚАЗАҚ",
"nameEn": "ҚАЗАҚ"
},
"docNumber": "0101010101",
"birthDate": 946684800000,
"docExpirationDate": 1838916000000,
"docPhoto": "base64",
"docBarcode": "base64"
}
}
},
"document_type": "IdentityCard",
"phone": "77771234567",
"failure_reason": null
}
}
}
События технологии Document Recognition
Document Recognition
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
first_name |
string |
Имя |
last_name |
string |
Фамилия |
patronymic |
string |
Отчество |
authority |
string |
Орган выдачи |
date_of_birth |
string |
Дата рождения |
date_of_expiry |
string |
Дата окончания срока действия документа |
date_of_issue |
string |
Дата выдачи документа |
document_number |
string |
Номер документа |
personal_number |
string |
ИИН |
raw_data |
object | null |
Неформатированные данные документа |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Document Recognition Flow",
"metadata": {},
"data": {
"technology_code": "DR",
"technology_name": "Document Recognition"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Document Recognition Flow",
"metadata": {},
"data": {
"document_recognition_result": {
"first_name": "ИМЯ",
"last_name": "ФАМИЛИЯ",
"patronymic": "ОТЧЕСТВО",
"result": true,
"authority": "МИНИСТЕРСТВО ВНУТРЕННИХ ДЕЛ РК",
"date_of_birth": "946684800000",
"date_of_expiry": "1838916000000",
"date_of_issue": "1523383200000",
"document_number": "0101010101",
"personal_number": "010101010101",
"raw_data": null,
"failure_reason": null
}
}
}
События технологии Address
Address
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
address |
object | null |
Адрес |
status |
string |
Статус запроса |
iin |
string |
ИИН |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Address Flow",
"metadata": {},
"data": {
"technology_code": "ADR / ADR2",
"technology_name": "Address SMS / no SMS"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Address Flow",
"metadata": {},
"data": {
"address_result": {
"iin": "010101010101",
"address": {
"country": {
"code": "398",
"nameRu": "КАЗАХСТАН",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2008-03-01T13:21:44+06:00"
},
"region": {
"code": "1910267",
"nameRu": "ЖЕТЫСУСКИЙ",
"nameKz": "ЖЕТІСУ",
"changeDate": "2008-03-01T13:21:45+06:00"
},
"city": "ҚАЛА IШIНДЕГI АУДАНЫ Жетысуский",
"street": "УЛИЦА Ломоносова",
"building": "13",
"flat": "1",
"foreign_data": {
"districtName": "РЕСПУБЛИКАЛЫҚ МАҢЫЗЫ БАР ҚАЛАСЫ Алматы"
}
},
"status": "VALID",
"failure_reason": null,
"result": true
}
}
}
GBDFL
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
result_json |
object | null |
Адрес |
status |
string |
Статус запроса |
iin |
string |
ИИН |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "GBDFL Flow",
"metadata": {},
"data": {
"technology_code": "GBDFL",
"technology_name": "GBDFL Technology"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "GBDFL Flow",
"metadata": {},
"data": {
"gbdfl_result": {
"iin": "010101010101",
"result": true,
"result_json": {
"gbdfl_response": {
"iin": "010101010101",
"surname": "ТЕСТОВ",
"name": "ТЕСТ",
"patronymic": "ТЕСТОВИЧ",
"birth_date": "2000-01-01",
"gender": "Мужской",
"nationality": "КАЗАХ",
"citizenship": "КАЗАХСТАН",
"life_status": "Нормальный",
"birth_place": {
"country": "КАЗАХСТАН",
"region": "АЛМАТЫ",
"district": "АЛМАТИНСКАЯ ОБЛАСТЬ",
"city": "АЛМАТЫ"
},
"documents": [
{
"type": "УДОСТОВЕРЕНИЕ РК",
"number": "N00000001",
"issue_date": "2020-01-01",
"expiry_date": "2030-01-01",
"issuer": "МВД РК",
"status": "ДОКУМЕНТ ДЕЙСТВИТЕЛЕН"
}
],
"registration_address": {
"country": "КАЗАХСТАН",
"region": "АЛМАТЫ",
"district": "АЛМАТИНСКАЯ ОБЛАСТЬ",
"city": "АЛМАТЫ",
"street": "ТЕСТОВАЯ",
"building": "1",
"flat": "1",
"begin_date": "2020-01-01"
}
}
},
"status": "VALID",
"failure_reason": null
}
}
}
События технологии NPCK
Face2Face NPCK
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
prediction |
string |
Оценка сличения (от 0 до 1) |
prediction_percent |
string |
Процент сличения (от 0 до 100) |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "Face2Face NPCK Flow",
"metadata": {},
"data": {
"technology_code": "F2F_NPCK",
"technology_name": "F2F NPCK"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "Face2Face NPCK Flow",
"metadata": {},
"data": {
"f2f_npck_result": {
"prediction": "0.9980",
"prediction_percent": "99",
"result": true,
"failure_reason": null
}
}
}
GBDFL NPCK
Описание полей результата
| Поле |
Тип |
Описание |
result |
boolean |
Общий результат проверки |
result_json |
object | null |
Адрес |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "GBDFL NPCK Flow",
"metadata": {},
"data": {
"technology_code": "GBDFLN",
"technology_name": "GBD FL NPCK"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "GBDFL NPCK Flow",
"metadata": {},
"data": {
"gbdfl_npck_result": {
"result": true,
"result_json": {
"person": {
"name": "ИМЯ",
"patronymic": "ОТЧЕСТВО",
"surname": "ФАМИЛИЯ",
"iin": "020202012345",
"mobilephone": "",
"birthDate": "2002-02-02",
"birthPlace": {
"country": {
"nameRu": "КАЗАХСТАН",
"code": "2",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2022-02-02 00:00:00"
},
"city": "-",
"district": {
"nameRu": "ГОРОД",
"code": "2",
"nameKz": "ГОРОД",
"changeDate": "2022-02-02 00:00:00"
},
"region": {
"nameRu": "РАЙОН",
"code": "2",
"nameKz": "РАЙОН",
"changeDate": "2022-02-02 00:00:00"
}
},
"regAddress": {
"country": {
"nameRu": "КАЗАХСТАН",
"code": "2",
"nameKz": "ҚАЗАҚСТАН",
"changeDate": "2022-02-02 00:00:00"
},
"beginDate": "2022-02-02",
"street": "УЛИЦА",
"flat": "2",
"district": {
"nameRu": "ГОРОД",
"code": "2",
"nameKz": "ГОРОД",
"changeDate": "2022-02-02 00:00:00"
},
"region": {
"nameRu": "РАЙОН",
"code": "2",
"nameKz": "РАЙОН",
"changeDate": "2022-02-02 00:00:00"
},
"building": "2"
},
"documents": {
"document": [
{
"number": "123456789",
"beginDate": "2022-02-02",
"patronymic": "ОТЧЕСТВО",
"endDate": "2022-02-02",
"surname": "ФАМИЛИЯ",
"name": "ИМЯ",
"type": {
"nameRu": "УДОСТОВЕРЕНИЕ РК",
"code": "",
"nameKz": "ҚР ЖЕКЕ КУӘЛІГІ",
"changeDate": "2022-02-02 00:00:00"
},
"birthDate": "2002-02-02",
"issueOrganization": {
"nameRu": "ОРГАНИЗАЦИЯ ВЫДАЧИ",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
},
"status": {
"nameRu": "СТАТУС ДОКУМЕНТА",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
}
}
]
},
"citizenship": {
"nameRu": "ГРАЖДАНСТВО",
"code": "0",
"nameKz": "",
"changeDate": "2008-02-02 00:00:00"
},
"lifeStatus": {
"nameRu": "Нормальный",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
},
"gender": {
"nameRu": "ПОЛ",
"code": "0",
"nameKz": "",
"changeDate": "2022-02-02 00:00:00"
},
"nationality": {
"nameRu": "НАЦИОНАЛЬНОСТЬ",
"code": "0",
"nameKz": "",
"changeDate": "2002-02-02 00:00:00"
}
}
},
"failure_reason": null
}
}
}
События технологии KZ-INFO
KZ-INFO
Описание полей результата
| Поле |
Тип |
Описание |
iin |
boolean |
ИИН |
exec_proc_info_status |
string |
Статус запроса |
exec_proc_info |
object | null |
Результат с АИС ОИП |
failure_reason |
object | null |
Причина неудачи (null при успехе) |
technology.start
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.start",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599979,
"success": true,
"flow_name": "KZ Info Flow",
"metadata": {},
"data": {
"technology_code": "KZ_INFO",
"technology_name": "Kz Citizen Info Technology"
}
}
technology.end
{
"id": "e9afa559-09de-4d7b-89a0-dacd413febdc",
"event": "technology.end",
"session_id": "84f84b3d-4f8b-403d-a95c-fe214697f4cb",
"created": 1734599993,
"success": true,
"flow_name": "KZ Info Flow",
"metadata": {},
"data": {
"gbdfl_npck_result": {
"result": true,
"result_json": [
{
"exec_proc": "12345678",
"exec_proc_num": "1164/20-75-3430",
"ip_start_date": "2020-06-11T00:00:00.000+05:00",
"il_date": "2020-05-22T00:00:00.000+05:00",
"debtor_iin": "970128301134",
"debtor_name": "NAME",
"debtor_secondname": "SECONDNAME",
"il_organ_ru": "Notary Chamber of Almaty",
"il_organ_kz": "Notary Chamber of Almaty",
"category_ru": "Debt collection",
"category_kz": "Debt collection",
"recovery_amount": "100000.000",
"officer_surname": "OFFICER_SURNAME",
"officer_name": "OFFICER_NAME",
"officer_secondname": [
"OFFICER_SURNAME",
"Private bailiffs of Almaty",
"Алматы қ."
],
"disa_name_ru": "Private bailiffs of Almaty",
"disa_department_name_ru": "Private bailiffs of Almaty",
"recoverer_type_ru": "Individual",
"recoverer_type_kz": "Individual",
"recoverer_iin": "010101010101",
"recoverer_surname": "RECOVERER_SURNAME",
"recoverer_name": "RECOVERER_NAME",
"recoverer_secondname": "RECOVERER_SECONDNAME",
"recoverer_bin": "010101010101",
"recoverer_title": "RECOVERER_TITLE"
}
],
"failure_reason": null
}
}
}