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

- [/ru/](/ru/)
- [Вебхуки и события](/ru/developers/webhooks-and-events/)
- Типы событий

**На этой странице# Типы событий

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

ПолеТипОписание`processId``string` (UUID)Идентификатор транзакции.`state``string`Текущее состояние транзакции. В настоящее время: `PROCESS_STATE_FINISHED`.`flow``string`Поток, выполненный для данной транзакции (например, `id`, `idtoken`).`lastEvent``string`Последнее событие транзакции. **Возвращается только если процесс истёк до того, как пользователь завершил поток.**`lastEventDescription``string`Описание `lastEvent` в удобочитаемом формате. **Возвращается только если процесс истёк до того, как пользователь завершил поток.**
Словарь статусовПоле `state` в полезных данных webhook использует префикс `PROCESS_STATE_*`. Это отдельный словарь, не связанный с полями `result` и `status`, возвращаемыми endpoint GetProcess, которые используют `PROCESS_RESULT_*`. Не используйте их как взаимозаменяемые.
### Пример полезных данных​

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

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

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

```
{  "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`Ошибка на шаге обработки документа
Настраиваемая обработкаНабор событий может расширяться. Относитесь к событиям, на которые реагирует ваш endpoint, как к **конфигурации**, а не к жёстко заданным константам — это позволит включать новые события без повторного развёртывания.
### Получение полного результата процесса​

Полезные данные webhook сигнализируют о завершении процесса, но не содержат сам результат. Чтобы получить результат — а также данные захвата, биометрические оценки, поля документа и т. д. — вызовите соответствующий endpoint **GetProcess**, см. [Получение процесса](/ru/developers/api-reference/get-process).Последнее обновление 16 окт. 2026 г.**