试用小程序快速认证

该接口用于通过企业法人人脸识别的方式快速将试用小程序进行认证。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

重要注意事项:

1、试用小程序完成认证之后,不会把【的试用小程序】去掉,需要服务商调【设置名称】的接口来重置一下名称。且,千万不要在发布上线之后再修改名称,发布了之后api改不了名字,需要用户重新认证改名。

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 企业法人认证需要的信息

重要注意事项:试用小程序完成认证之后,不会把【的试用小程序】去掉,需要服务商调【设置名称】的接口来重置一下名称。且,千万不要在发布上线之后再修改名称,发布了之后api改不了名字,需要用户重新认证改名。

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、不支持境外主体和个人主体,只支持企业及个体户(含无主体名称个体工商户)

1、 创建转正任务逻辑是串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞

2、 小程序已经转正了(即不是试用小程序)则不可以再调用该接口

3、 如果法人扫脸任务失败了,则可以重新调这个接口给法人下发模板消息。如果是模板消息已经下发,但是法人一直还没处理但是又还没有超时,则接口会报错提示89251

4、 当法人扫脸成功,但是管理员转正失败,则可以继续调该接口进行下发模板消息;此时法人仍然收到扫脸的模板消息,并不是直接跳过法人扫脸直接给管理员下发

状态描述 是否可调接口重新下发模板消息 点击模板消息的状态
模板消息已下发,待法人确认 不可以;接口会报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不会收到模板消息)