---
title: 事件类型
description: IDCloud Webhook 事件类型参考 — 流程完成、失败及状态变更负载说明。
canonical: https://developer.unico.io/zh-CN/developers/webhooks-and-events/event-types
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [Webhooks 与事件](/zh-CN/developers/webhooks-and-events/)
- 事件类型

**本页内容# 事件类型

Webhook 负载描述了流程状态的转换。本页记录了  负载结构及 `lastEvent` 值的完整枚举。
### 负载结构​

字段类型描述`processId``string` (UUID)交易的 ID。`state``string`交易的当前状态。目前为：`PROCESS_STATE_FINISHED`。`flow``string`本次交易所执行的流程（例如 `id`、`idtoken`）。`lastEvent``string`交易的最后事件。**仅在用户完成该流程前已过期时返回。**`lastEventDescription``string``lastEvent` 的人类可读描述。**仅在用户完成该流程前已过期时返回。**
状态词汇表Webhook 负载中的 `state` 字段使用 `PROCESS_STATE_*` 前缀。这与 GetProcess 端点返回的 `result` 和 `status` 字段所使用的 `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`二维码已扫描`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`文件步骤发生错误
可配置处理事件集合可能会演变。请将您的端点所响应的事件视为**配置项**，而非硬编码常量——这样在启用新事件时无需重新部署。
### 读取完整流程结果​

Webhook 负载表明流程已完成，但并不包含结果本身。要获取结果——以及采集数据、生物特征分数、文件字段等——请调用相应的 **GetProcess** 端点，参见[获取流程](/zh-CN/developers/api-reference/get-process)。最后更新 于 2026年10月16日**