# 试用小程序快速认证
该接口用于通过企业法人人脸识别的方式快速将试用小程序进行认证。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
# 重要注意事项:
1、试用小程序完成认证之后,不会把【的试用小程序】去掉,需要服务商调【设置名称】的接口来重置名称。且,如果在发布上线之后再修改名称,需要用户重新认证改名。
2、当小程序已经完成转正之后,仍然不可以扫码登录mp.weixin.qq.com,需要到“小程序助手”完成邮箱账号密码的补登记,才可以正常登录mp哈。操作详情请查看https://kf.qq.com/touch/sappfaq/200617VbQzaa200617aq67ru.html
# 业务逻辑描述
为了便于服务商更好地理解该接口的使用,请详细阅读如下描述:
1、 通过该接口完成认证需要经过企业法人人脸识别以及小程序管理员授权确认两个环节,缺一不可。
2、 平台会先给企业法人下发模板消息完成授权后再给小程序管理员下发模板消息进行授权确认,如果前者授权失败或者未完成则不会再下发模板消息给小程序管理员。
# 请求地址
POST https://api.weixin.qq.com/wxa/verifybetaweapp?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | String | 是 | 第三方平台接口调用令牌authorizer_access_token |
verify_info | object | 是 | 企业法人认证需要的信息 |
verify_info结构体如下
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
enterprise_name | string | 是 | 企业名(需与工商部门登记信息一致);如果是“无主体名称个体工商户”则填“个体户+法人姓名”,例如“个体户张三” |
code | string | 是 | 企业代码 |
code_type | number | 是 | 企业代码类型 1:统一社会信用代码(18 位) 2:组织机构代码(9 位 xxxxxxxx-x) 3:营业执照注册号(15 位) |
legal_persona_wechat | string | 是 | 法人微信号 |
legal_persona_name | string | 是 | 法人姓名(绑定银行卡) |
legal_persona_idcard | string | 是 | 法人身份证号 |
component_phone | string | 是 | 第三方联系电话 |
说明:
1、不支持境外主体和个人主体,只支持企业及个体户(含无主体名称个体工商户)
2、 创建转正任务逻辑是串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞
3、 小程序已经转正了(即不是试用小程序)则不可以再调用该接口
4、 如果法人扫脸任务失败了,则可以重新调这个接口给法人下发模板消息。如果是模板消息已经下发,但是法人一直还没处理但是又还没有超时,则接口会报错提示89251
5、 当法人扫脸成功,但是管理员转正失败,则可以继续调该接口进行下发模板消息;此时法人仍然收到扫脸的模板消息,并不是直接跳过法人扫脸直接给管理员下发
状态描述 | 是否可调接口重新下发模板消息 | 点击模板消息的状态 |
---|---|---|
模板消息已下发,待法人确认 | 不可以;接口会报89251错误 | 用户可随时点击模板消息进入 |
模板消息已下发,超过24小时法人都没确认 | 可以调接口重新下发模板消息 | 用户点击模板消息提示链接失效 |
模板消息已下发,法人实名授权失败 | 同上 | 用户可重新进入模板消息进行授权 |
模板消息已下发,法人扫脸失败 | 同上 | 用户点击模板消息直接进入失败页面 |
模板消息已下发,待管理员确认 | 不可以; | 用户可随时点击模板消息进入 |
模板消息已下发,超过24小时管理都没确认 | 可以调接口重新下发模板消息 | 用户点击模板消息提示链接失效 |
模板消息已下发,转正失败 | 同上 | 用户点击模板消息直接进入失败页面 |
POST 数据示例:
{
"verify_info": {
"enterprise_name": "测试的公司",
"code": "8585858589999",
"code_type": 3,
"legal_persona_wechat": "Melody20136xxxxxx",
"legal_persona_name": "涂小xxx",
"component_phone": "158173xxxxx",
"legal_persona_idcard": "440881199xxxxxx"
}
}
# 返回参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 错误信息 |
返回结果示例:
{
"errcode": 0,
"errmsg": "ok"
}
# 返回码说明
错误码 | 中文描述 |
---|---|
89249 | 该appid已有转正任务执行中,距上次任务 24h 后再试 |
86004 | 无效微信号 |
1004 | 该微信用户违规命中黑名单 |
61070 | 法人姓名与微信号不一致 |
89248 | 企业代码类型无效,请选择正确类型填写 |
89255 | code参数无效,请检查code长度以及内容是否正确 ;注意code_type的值不同需要传的code长度不一样 |
1006 | 该手机号违规命中黑名单 |
1003 | 该appid的管理员绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1007 | 该appid的管理员身份证绑定的账号数量达到上限,无法转正 |
1005 | 该appid的管理员手机号绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1001 | 该企业主体创建的小程序数量达到上限,无法转正 |
1002 | 主体违规命中黑名单 |
91021 | 不是没转正的试用小程序,不可以调这个接口 |
61069 | 身份证号不正确。填写的身份证号信息需要与微信号的实名信息对应上 |
86019 | 填写的企业信息和法人个人信息没对应上,请检查后重试 |
其他通用错误 | 请查看【返回码说明】 |
# 用户授权页面交互示例图
# 企业法人授权确认页
# 小程序管理员授权确认页
# 消息推送规则
由于该接口涉及用户的授权确认操作,为异步操作的流程,因此用户的操作状态平台会将相关信息推送到【授权事件接收 URL】。
1、模板消息下发成功后推送
2、 转正成功后推送
3、 转正失败了会推送(失败含超时),可通过status和msg字段区分
试用小程序快速认证数据示例
<xml>
<AppId><![CDATA[第三方平台appid]]></AppId>
<CreateTime>1535442403</CreateTime>
<InfoType><![CDATA[notify_third_fastverifybetaapp]]></InfoType>
<appid>小程序appid<appid>
<status>0</status>
<msg>OK</msg>
<info>
<name><![CDATA[企业名称]]></name>
<code><![CDATA[企业代码]]></code>
<code_type>1</code_type>
<legal_persona_wechat><![CDATA[法人微信号]]></legal_persona_wechat>
<legal_persona_name><![CDATA[法人姓名]]></legal_persona_name>
<component_phone><![CDATA[第三方联系电话]]></component_phone>
</info>
</xml>
status的枚举值
状态码 | msg | 状态描述 |
---|---|---|
0 | ok | 小程序转正成功(指的是小程序管理员确认转正成功;不是指法人扫脸成功) |
89251 | legal person checking | 模板消息已下发,待法人人脸核身校验 |
100001 | 已下发的模板消息法人并未确认且已超时(24h),未进行身份证校验 | |
100002 | 已下发的模板消息法人并未确认且已超时(24h),未进行人脸识别校验 | |
100003 | 已下发的模板消息法人并未确认且已超时(24h) | |
100004 | 实名认证的信息和法人姓名不一致 | |
101 | 法人扫脸后,工商数据返回:“企业已注销” | |
102 | 法人扫脸后,工商数据返回:“企业不存在或企业信息未更新” | |
103 | 法人扫脸后,工商数据返回:“企业法定代表人姓名不一致” | |
104 | 法人扫脸后,工商数据返回:“企业法定代表人身份证号码不一致” | |
105 | 法人扫脸后,法定代表人身份证号码,工商数据未更新,请 5-15 个工作日之后尝试 | |
1000 | 法人扫脸后,工商数据返回:“企业信息或法定代表人信息不一致” | |
小程序管理员确认转正超时 | ||
89252 | 模板消息已下发,待小程序管理员确认 | |
小程序管理员确认转正失败 |
# 用户收到的模板消息的规则
1、 企业法人收到人脸识别确认的模板消息
2、 小程序管理员转正确认的模板消息(如果1失败了,则2不会收到模板消息)