# 试用小程序快速转正

调试诊断

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：verfifyBetaMiniprogram

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

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口支持第三方平台代商家调用。

• 该接口所属的权限集 id 为：81

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# Body.verify_info Object Payload

企业法人认证需要的信息

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

# 重要提醒 1：

• 该接口每分钟调用频率为：5/mini
• 该接口每天的调用次数为：100/天
• 开发者应该合理控制接口的调用频率和每天的调用次数

# 重要提醒 2：

1、试用小程序完成转正之后，不会把【的试用小程序】去掉，需要服务商调【设置名称】的接口来重置名称。且，如果在发布上线之后再修改名称，需要用户重新认证改名。

2、当小程序已经完成转正之后，仍然不可以扫码登录mp.weixin.qq.com，需要到“小程序助手”完成邮箱账号密码的补登记，才可以正常登录mp哈。操作详情请查看https://kf.qq.com/touch/sappfaq/200617VbQzaa200617aq67ru.html

3、在调用此接口支持务必先阅读试用小程序介绍文档中的关于试用小程序快速转正接口逻辑介绍部分。

4、发起转正后会有相关的消息推送至 【授权事件接收 URL 】，详细说明查看后面介绍

5、请注意：试用小程序的quota和普通个人小程序的quota共用，即同一微信号只可绑定5个小程序。详情查看小程序注册上限和绑定上限说明

# 重要提醒 3：

1、试用小程序转正新版本不再通过模板消息直接下发认证链接至法人微信，第三方服务商应该引导用户通过接口返回的认证链接进行认证

2、本接口转正成功的企业小程序，默认法人为该小程序的管理员

# 一、规则说明：

1、不支持境外主体和个人主体，只支持企业及个体户（含无主体名称个体工商户）

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

3、 小程序已经转正了（即不是试用小程序）则不可以再调用该接口

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

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

# 二、消息推送说明

由于该接口涉及用户的授权确认操作，为异步操作的流程，因此用户的操作状态平台会将相关信息推送到【授权事件接收 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的枚举值

# 三、用户收到的模板消息的规则

1、 企业法人收到人脸识别确认的模板消息

2、 小程序管理员转正确认的模板消息（如果1失败了，则2不会收到模板消息）

# 以下为接口新版本的相关说明，请仔细阅读：

# 一、新版本规则说明：

1. 不支持境外主体和个人主体，只支持企业及个体户（含无主体名称个体工商户）
2. 创建转正任务逻辑是串行，单次任务结束后才可以使用相同信息下发第二次任务，请注意规避任务阻塞
3. 小程序已经转正了（即不是试用小程序）则不可以再调用该接口
4. 如果法人扫脸任务失败了，则可以重新调用接口获取新的认证链接。如果是认证链接已经成功获取，但是法人一直还没认证但是又还没有超时，则接口会报错提示89249
5. 如果绑定管理员手机号失败了，可以点击原链接重新进入更换手机号进行转正

# 二、新版本消息推送说明：

由于该接口涉及用户的授权确认操作，为异步操作的流程，因此用户的操作状态平台会将相关信息推送到【授权事件接收 URL 】。

推送场景

1. 认证链接获取成功后推送
2. 法人实名扫脸认证失败后推送
3. 试用小程序转正成功后推送
4. 试用小程序转正失败后推送，可通过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的枚举值

# 5. 代码示例

# 5.1 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"
}

# 5.2 新版本请求示例

请求示例

{
  "verify_info": {
    "enterprise_name": "测试的公司",
    "code": "8585858589999",
    "component_phone": "158173xxxxx"
  },
  "new_version" : true
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "authorized_url" : "https://mp.weixin.qq.com/xxxxxxxxx"
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（2条）

2026 年 03 月 19 日

新增 new_version 、 authorized_url 字段， code_type 、 legal_persona_wechat 等字段变为可选，更新多个字段描述，文档描述优化

2025 年 12 月 12 日

错误码 字段新增「人脸视频识别失败，请重试」枚举值