认证视频返回通知

更新时间：2025-12-24 15:45:27

【触发条件】当个人刷脸使用智能视频认证方式且开启了返回视频功能时可触发此通知。

为确保您能成功接收此通知，请务必在开放平台中，通过Webhook事件订阅（即《异步回调通知接收说明》中设置回调通知Url地址的方式二）勾选“认证视频返回通知”来完成设置。

开发者在对接时，需注意：

如果认证过程选择刷脸方式进行认证，进入到刷脸页面的时候，会主动通过GET方式去访问接口设置的异步回调地址，开发者在接收到GET方式请求过去的记录时，可以直接忽略或者不做GET接收；开发者对于异步回调通知只需通过POST方式进行接收即可，认证结果以实际POST方式接收的异步通知为准。

回调参数：

参数名	类型	说明
action	string	标记该通知的业务类型，该通知固定为：AUTH_VIDEO_STORAGE_NOTIFY 需要在「开放平台」的应用配置-Webhook-独立实名认证服务中勾选了“认证视频返回通知”才会触发
flowType	string	认证业务类型 identity - 实名认证业务流程 willingness - 意愿任务业务流程
flowValue	string	业务流程ID 实名认证业务类型返回flowId（实名认证流程ID）意愿任务业务流程返回bizId（意愿任务业务ID）
serviceId	string	任务ID 实名认证业务类型返回空意愿任务业务流程返回willAuthId（意愿认证子任务ID）
storageResult	boolean	视频储存结果 true - 储存成功 false - 储存失败
contextId	string	业务上下文Id
signFlowId	string	签署流程ID，默认不返回，固定场景发起才返回（多个用逗号分隔）。
requestTimestamp	string	回调通知触发时间（如重试多次均返回第一次时间，Unix时间戳格式，单位：毫秒）
status	boolean	认证流程是否成功 true - 成功 false - 失败

通知示例：

实名认证业务流程：

{
    "action": "AUTH_VIDEO_STORAGE_NOTIFY",
    "flowType": "identity",
    "flowValue": "4224906570334999458",
    "requestTimestamp": 1766560110746,
    "status": true,
    "storageResult": true
}

意愿任务业务流程：

{
    "action": "AUTH_VIDEO_STORAGE_NOTIFY",
    "flowType": "willingness",
    "flowValue": "will_70cfc5177643433c994f6f6773b84bf3",
    "requestTimestamp": 1766561607795,
    "serviceId": "3f27f1c6f2a74a119ccb719a58314132",
    "status": true,
    "storageResult": true
}

身份核验认证服务API

认证视频返回通知