# 试用小程序快速转正
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
verfifyBetaMiniprogram
# 功能描述
该接口用于通过企业法人人脸识别的方式快速将试用小程序进行认证。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
自2023年12月25日起,通过本接口新注册的账号,默认为未认证状态,如第三方开发者需要为其发起认证,可通过 代认证小程序接口提交申请。# 注意事项
# 重要提醒:
1、试用小程序完成转正之后,不会把【的试用小程序】去掉,需要服务商调【设置名称】的接口来重置名称。且,如果在发布上线之后再修改名称,需要用户重新认证改名。
2、当小程序已经完成转正之后,仍然不可以扫码登录mp.weixin.qq.com,需要到“小程序助手”完成邮箱账号密码的补登记,才可以正常登录mp哈。操作详情请查看https://kf.qq.com/touch/sappfaq/200617VbQzaa200617aq67ru.html
3、在调用此接口支持务必先阅读试用小程序介绍文档中的关于试用小程序快速转正接口逻辑介绍部分。
4、发起转正后会有相关的消息推送至【授权事件接收 URL】,详细说明查看后面介绍
5、请注意:试用小程序的quota和普通个人小程序的quota共用,即同一微信号只可绑定5个小程序。详情查看小程序注册上限和绑定上限说明
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/verifybetaweapp?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:81
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用 component_access_token或者使用authorizer_access_token | |||||||||||||||||||||||||||||||||||||||||
verify_info | object | 是 | 企业法人认证需要的信息 | |||||||||||||||||||||||||||||||||||||||||
|
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 其他说明
# 1、规则说明:
1、不支持境外主体和个人主体,只支持企业及个体户(含无主体名称个体工商户)
2、 创建转正任务逻辑是串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞
3、 小程序已经转正了(即不是试用小程序)则不可以再调用该接口
4、 如果法人扫脸任务失败了,则可以重新调这个接口给法人下发模板消息。如果是模板消息已经下发,但是法人一直还没处理但是又还没有超时,则接口会报错提示89251
5、 当法人扫脸成功,但是管理员转正失败,则可以继续调该接口进行下发模板消息;此时法人仍然收到扫脸的模板消息,并不是直接跳过法人扫脸直接给管理员下发
状态描述 | 是否可调接口重新下发模板消息 | 点击模板消息的状态 |
---|---|---|
模板消息已下发,待法人确认 | 不可以;接口会报89251错误 | 用户可随时点击模板消息进入 |
模板消息已下发,超过24小时法人都没确认 | 可以调接口重新下发模板消息 | 用户点击模板消息提示链接失效 |
模板消息已下发,法人实名授权失败 | 同上 | 用户可重新进入模板消息进行授权 |
模板消息已下发,法人扫脸失败 | 同上 | 用户点击模板消息直接进入失败页面 |
模板消息已下发,待管理员确认 | 不可以; | 用户可随时点击模板消息进入 |
模板消息已下发,超过24小时管理都没确认 | 可以调接口重新下发模板消息 | 用户点击模板消息提示链接失效 |
模板消息已下发,转正失败 | 同上 | 用户点击模板消息直接进入失败页面 |
# 2、消息推送说明
由于该接口涉及用户的授权确认操作,为异步操作的流程,因此用户的操作状态平台会将相关信息推送到【授权事件接收 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>
# 2.1、status的枚举值
状态码 | msg | 状态描述 |
---|---|---|
0 | ok | 小程序转正成功(指的是小程序管理员确认转正成功;不是指法人扫脸成功) |
89251 | legal person checking | 模板消息已下发,待法人人脸核身校验 |
100001 | 已下发的模板消息法人并未确认且已超时(24h),未进行身份证校验 | |
100002 | 已下发的模板消息法人并未确认且已超时(24h),未进行人脸识别校验 | |
100003 | 已下发的模板消息法人并未确认且已超时(24h) | |
100004 | 实名认证的信息和法人姓名不一致 | |
101 | 法人扫脸后,工商数据返回:“企业已注销” | |
102 | 法人扫脸后,工商数据返回:“企业不存在或企业信息未更新” | |
103 | 法人扫脸后,工商数据返回:“企业法定代表人姓名不一致” | |
104 | 法人扫脸后,工商数据返回:“企业法定代表人身份证号码不一致” | |
105 | 法人扫脸后,法定代表人身份证号码,工商数据未更新,请 5-15 个工作日之后尝试 | |
1000 | 法人扫脸后,工商数据返回:“企业信息或法定代表人信息不一致” | |
89252 | 模板消息已下发,待小程序管理员确认 |
# 3、用户收到的模板消息的规则
1、 企业法人收到人脸识别确认的模板消息
2、 小程序管理员转正确认的模板消息(如果1失败了,则2不会收到模板消息)
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"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": 0,
"errmsg": "ok"
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
89249 | task running | 该appid已有转正任务执行中,距上次任务 24h 后再试 |
89248 | invalid code type | 企业代码类型无效,请选择正确类型填写 |
86004 | invalid wechat;无效微信号 | |
1004 | 该微信用户违规命中黑名单 | |
61070 | name idcard wechat name not in accordance;法人姓名与微信号不一致 | |
89255 | enterprise code invalid | code参数无效,请检查code长度以及内容是否正确;注意code_type的值不同需要传的code长度不一样 |
1006 | 该手机号违规命中黑名单 | |
1003 | 该appid的管理员绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 | 该appid的管理员绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1007 | 该appid的管理员身份证绑定的账号数量达到上限,无法转正 | |
1005 | 该appid的管理员手机号绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 | 该appid的管理员手机号绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1001 | 该企业主体创建的小程序数量达到上限,无法转正 | |
1002 | 主体违规命中黑名单 | |
91021 | 不是没转正的试用小程序,不可以调这个接口 | 不是没转正的试用小程序,不可以调这个接口 |
61069 | invalid admin;身份证号不正确。填写的身份证号信息需要与微信号的实名信息对应上 | |
86019 | 填写的企业信息和法人个人信息没对应上,请检查后重试 | 填写的企业信息和法人个人信息没对应上,请检查后重试 |