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

调试工具

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

# 接口说明

# 接口英文名

createIcpVerifyTask

# 功能描述

发起备案小程序管理员人脸核身，调用该接口时会向小程序的管理员发送一条备案人脸核身通知，管理员点击该通知即可进行人脸核身。待管理员完成核身之后，平台会推送人脸核身完成事件到服务商服务器，服务商也可以使用查询人脸核身任务状态接口来轮询任务状态和结果。

本接口也可在一步申请小程序认证及备案时（详情请参考服务商代认证及备案介绍），用于完成小程序管理员授权、人脸核身以及短信核验。

使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

# 注意事项

1. 人脸核身视频会用于生成核验照片，背景需白色或接近浅色，核验人不能裸露上半身，不能戴帽子、耳机、口罩等遮挡面部的物品。
2. 人脸核身通知有效期为 24 小时，如果在通知有效期内核身未能通过，可以再次点击通知进行重试，无需重新发起，过期后需重新发起。
3. 小程序认证及备案二合一场景下（along_with_auth 为 true）人脸核身任务 task_id 有效期为 1 天，小程序备案场景下（along_with_auth 为 false）为 3 天。为避免申请备案时 task_id 过期，请确保其余所有备案材料已准备好，以及备案前置条件已完成，再发起人脸核身。
4. 发起人脸核身前，请留意当天申请小程序备案接口是否还有剩余调用限额，以免需要反复发起。
5. 在小程序认证及备案二合一场景下（along_with_auth 为 true），如果流程已进行到备案阶段，则仅需要完成人脸核验，无需再进行小程序管理员授权以及短信核验。后台会自动根据小程序当前状态判断需要完成哪些步骤，调用方无需判断。

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

# 调用方式

# HTTPS 调用

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

# 第三方调用

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

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

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

# 请求参数

# 返回参数

# 其他说明

# 事件推送

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

如果发起时 along_with_auth 填 true，则除了人脸核身完成时会推送事件，认证短信核验通过时还会推送事件。

# 推送参数说明

# 推送数据示例

人脸核身完成时事件

<xml>
    <AppId><![CDATA[wx1234567890abcdef]]></AppId>
    <CreateTime>1689839779</CreateTime>
    <InfoType><![CDATA[notify_icpfiling_verify_result]]></InfoType>
    <task_id><![CDATA[R5PqRPNb6GmG3i0rqd4pTg]]></task_id>
    <verify_appid><![CDATA[wxabcdef1234567890]]></verify_appid>
    <result>3</result>
</xml>

认证短信核验通过时事件

<xml>
    <AppId><![CDATA[wx1234567890abcdef]]></AppId>
    <CreateTime>1689839779</CreateTime>
    <InfoType><![CDATA[notify_icpfiling_verify_result]]></InfoType>
    <task_id><![CDATA[R5PqRPNb6GmG3i0rqd4pTg]]></task_id>
    <verify_appid><![CDATA[wxabcdef1234567890]]></verify_appid>
    <result>3</result>
    <along_with_auth_result>9</along_with_auth_result>
</xml>

# 调用示例

示例说明: 小程序备案场景，仅需完成人脸核身

# 请求数据示例

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

# 返回数据示例

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

示例说明: 小程序认证及备案二合一场景，需完成小程序管理员授权、人脸核身以及短信核验

# 请求数据示例

curl -XPOST 'https://api.weixin.qq.com/wxa/icp/create_icp_verifytask?access_token=ACCESS_TOKEN' -d '{"along_with_auth": true}' 

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "",
    "task_id": "R5PqRPNb6GmG3i0rqd4pTg",
    "verify_url": "https://mp.weixin.qq.com"
} 

# 错误码