Flow Result

Описание

Этот раздел содержит примеры результатов, которые возвращаются после прохождения различных технологий верификации. Каждый пример сопровождается подробным описанием структуры данных и возможных статусов.

Примечание

Приведенные ниже примеры содержат тестовые данные. В реальных запросах значения полей будут соответствовать информации конкретного субъекта

Для получения более подробной информации о получении результата прохождения Flow, обратитесь к разделу Flow Remote

Термины

• Субъект - физическое лицо, которое проходит процесс верификации или предоставляет согласие на обработку своих данных.
• 1414 - единый номер для отправки SMS-сообщений в рамках государственных услуг Республики Казахстан.
• ИИН - индивидуальный идентификационный номер, уникальный номер, присваиваемый физическому лицу.
• ГБДФЛ (Государственная база данных физических лиц) - централизованная база данных, содержащая сведения о физических лицах Республики Казахстан.

---

GBDFL - Получение информации о физическом лице

Это технология для получения верифицированной информации о физическом лице из государственной базы данных физических лиц (ГБДФЛ). Для получения данных требуется согласие субъекта, которое он предоставляет через SMS от номера 1414.

Возможные статусы ответа

• VALID - данные успешно получены после подтверждения субъектом
• INVALID - субъект отклонил запрос на предоставление данных
• PENDING - ожидание ответа от субъекта
• TIMEOUT - истекло время ожидания ответа

Успешный ответ (статус VALID)

В случае успешного получения данных ответ содержит полную информацию о физическом лице:

• Основные персональные данные (ФИО, дата рождения, пол)
• Информацию о гражданстве и национальности
• Место рождения
• Данные документов
• Адрес регистрации

{
    "id": "a6b8c5e3-fcde-4b12-8a4f-7e0d5b8c091a",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "result_json": {
            "gbdfl_response": {
                "iin": "123456789012",
                "surname": "Иванов",
                "name": "Иван",
                "patronymic": "Иванович",
                "birth_date": "1990-01-01",
                "gender": "Мужской",
                "nationality": "Казах",
                "citizenship": "Казахстан",
                "life_status": "Жив",
                "birth_place": {
                    "country": "Казахстан",
                    "region": "Алматинская область",
                    "district": "Талдыкорган",
                    "city": "Талдыкорган"
                },
                "documents": [
                    {
                        "type": "Паспорт РК",
                        "number": "N12345678",
                        "issue_date": "2020-01-01",
                        "expiry_date": "2030-01-01",
                        "issuer": "Министерство внутренних дел РК",
                        "status": "Документ действителен"
                    },
                    {
                        "type": "Удостоверение личности РК",
                        "number": "123456789",
                        "issue_date": "2015-05-01",
                        "expiry_date": "2025-05-01",
                        "issuer": "Министерство внутренних дел РК",
                        "status": "Документ действителен"
                    }
                ],
                "registration_address": {
                    "country": "Казахстан",
                    "region": "Алматинская область",
                    "district": "Талдыкорган",
                    "city": "Талдыкорган",
                    "street": "Улица Абая",
                    "building": "45",
                    "flat": "12",
                    "begin_date": "2010-06-15"
                }
            }
        },
        "status": "VALID",
        "result": true
    },
    "flow_session_result": true
}

Отказ в предоставлении данных (статус INVALID)

Если субъект отказывается предоставить доступ к своим данным через SMS, система возвращает ответ со и статусом INVALID.

{
    "id": "b9a2d67e-1a74-4cfa-b2a6-45f1ebc238ab",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "status": "INVALID"
    },
    "flow_session_result": false
}

Ожидание ответа (статус PENDING)

Статус PENDING означает, что результат запроса находится в промежуточном состоянии.

Это может произойти по нескольким причинам:

• Система только что отправила SMS-сообщение с запросом согласия
• Субъект получил SMS, но еще не предоставил своё решение
• Идет обработка полученного ответа от субъекта
• Время ожидания ответа от субъекта еще не истекло

В этом случае рекомендуется повторить запрос результата через некоторое время.

{
    "id": "c7d4e3a2-5fd6-4e9b-937b-8af7c67b3d92",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "status": "PENDING"
    },
    "flow_session_result": false
}

Время ожидания истекло (статус TIMEOUT)

Статус TIMEOUT возвращается, когда превышено максимальное время ожидания ответа от субъекта. Это может произойти в следующих случае если субъект не ответил на SMS в течение отведенного времени

{
    "id": "d8e5f2b1-3c9a-4d8b-ae5f-2c974d6b1e3a",
    "technologies": [
      {
        "name": "GBDFL Technology",
        "description": "Get information about person from gbdfl",
        "code": "GBDFL"
      }
    ],
    "gbdfl_result": {
      "iin": "123456789012",
      "status": "TIMEOUT",
      "expire_date": "2023-12-16T14:30:00Z"
    }, 
    "flow_session_result": false
}

---