---
title: Типы событий
description: Справочник по типам событий вебхуков IDCloud — полезные данные завершённых, неуспешных процессов и изменений статуса.
canonical: https://developer.unico.io/ru/dual-api/developers/webhooks-and-events/event-types
locale: ru
generated_by: markdown-export
---

Полезные данные webhook описывают переход состояния процесса. На этой странице описана схема полезных данных и полный перечень значений `lastEvent`.

### Схема полезных данных

| Поле | Тип | Описание |
|---|---|---|
| `processId` | `string` (UUID) | Идентификатор транзакции. |
| `state` | `string` | Текущее состояние транзакции. В настоящее время: `PROCESS_STATE_FINISHED`. |
| `flow` | `string` | Поток, выполненный для данной транзакции (например, `id`, `idtoken`). |
| `lastEvent` | `string` | Последнее событие транзакции. **Возвращается только если процесс истёк до того, как пользователь завершил поток.** |
| `lastEventDescription` | `string` | Описание `lastEvent` в удобочитаемом формате. **Возвращается только если процесс истёк до того, как пользователь завершил поток.** |

:::note[Словарь статусов]
Поле `state` в полезных данных webhook использует префикс `PROCESS_STATE_*`. Это отдельный словарь, не связанный с полями `result` и `status`, возвращаемыми endpoint GetProcess, которые используют `PROCESS_RESULT_*`. Не используйте их как взаимозаменяемые.
:::

### Пример полезных данных

#### Завершено — успешно

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id"
}
```

#### Завершено — истёк срок действия

```json
{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "id",
  "lastEvent": "EVENT_TYPE_SESSION_ENDED",
  "lastEventDescription": "Session ended by timeout or by new session created"
}
```

### Перечень значений lastEvent

Полный список значений, которые могут присутствовать в `lastEvent`:

| Событие | Описание |
|---|---|
| `EVENT_TYPE_PROCESS_CREATED` | Процесс создан |
| `EVENT_TYPE_QR_CODE_READ` | QR-код считан |
| `EVENT_TYPE_PROCESS_STARTED_BY_USER` | Процесс запущен пользователем |
| `EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED` | Шаг проверки личности завершён |
| `EVENT_TYPE_DOCUMENT_STEP_STARTED` | Шаг обработки документа начат |
| `EVENT_TYPE_DOCUMENT_PHOTO_CAPTURED` | Фото документа сделано |
| `EVENT_TYPE_DOCUMENT_UPLOADED_FROM_GALLERY` | Документ загружен из галереи |
| `EVENT_TYPE_DOCUMENT_STEP_FINISHED` | Шаг обработки документа завершён |
| `EVENT_TYPE_SESSION_ENDED` | Сессия завершена по тайм-ауту или в связи с созданием новой сессии |
| `EVENT_TYPE_ERROR_ON_DOCUMENT_STEP` | Ошибка на шаге обработки документа |

:::secondary[Настраиваемая обработка]
Набор событий может расширяться. Относитесь к событиям, на которые реагирует ваш endpoint, как к **конфигурации**, а не к жёстко заданным константам — это позволит включать новые события без повторного развёртывания.
:::

### Получение полного результата процесса

Полезные данные webhook сигнализируют о завершении процесса, но не содержат сам результат. Чтобы получить результат — а также данные захвата, биометрические оценки, поля документа и т. д. — вызовите соответствующий endpoint **GetProcess**:

- Для визуальных потоков / Web и нативный: см. [Справочник API > Web и нативный > GET /v1/process/{id}](/dual-api/developers/api-reference/web-sdk).
- Для невизуальных потоков / API: см. [Справочник API > API > GET /processes/v1/{id}](/dual-api/developers/api-reference/api).