# 发起小程序管理员人脸核身

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

createIcpVerifyTask

# 功能描述

发起备案小程序管理员人脸核身，调用该接口时会向 access_token 所指定的小程序的管理员发送一条备案人脸核身通知，管理员点击该通知即可进行人脸核身。待管理员完成核身之后，平台会推送人脸核身完成事件到服务商服务器，服务商也可以使用查询人脸核身任务状态接口来轮询任务状态和结果。使用过程中如遇到问题，可在开放平台服务商专区发帖交流

# 注意事项

1. 人脸核身视频会用于生成核验照片，背景需白色或接近浅色，核验人不能裸露上半身，不能戴帽子、耳机、口罩等遮挡面部的物品。
2. 人脸核身通知有效期为 24 小时，如果在通知有效期内核身未能通过，可以再次点击通知进行重试，无需重新发起，过期后需重新发起。
3. 人脸核身任务 task_id 有效期为 3 天，为避免申请备案时 task_id 过期，请确保其余所有备案材料已准备好，以及备案前置条件已完成，再发起人脸核身。
4. 发起人脸核身前，请留意当天申请小程序备案接口是否还有剩余调用限额，以免需要反复发起。

人脸核身常见失败及解决方案

# 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/icp/create_icp_verifytask?access_token=ACCESS_TOKEN 

# 第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同

• 该接口所属的权限集id为：18、156

• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

# 返回参数

# 其他说明

# 事件推送

小程序管理员人脸核身完成事件。当小程序管理员完成人脸核身时会推送该事件。服务商要接收事件推送，请移步：授权事件接收配置

# 推送参数说明

# 推送数据示例

{
  "AppId": "wx1234567890abcdef",
  "CreateTime": 1689839779,
  "InfoType": "notify_icpfiling_verify_result",
  "task_id": "R5PqRPNb6GmG3i0rqd4pTg",
  "verify_appid": "wxabcdef1234567890",
  "result": 3
}

# 调用示例

示例说明: CURL示例

# 请求数据示例

curl -XPOST 'https://api.weixin.qq.com/wxa/icp/create_icp_verifytask?access_token=ACCESS_TOKEN' 

# 返回数据示例

{
  "task_id": "R5PqRPNb6GmG3i0rqd4pTg",
  "errcode": 0,
  "errmsg": ""
} 

# 错误码