# 快速注册企业小程序
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:registerMiniprogram
关于快速注册小程序的详细介绍以及使用步骤、常见问题等请查看快速注册企业小程序介绍,本文为快速注册小程序的接口文档。
自2023年12月25日起,通过本接口新注册的账号,默认为未认证状态,如第三方开发者需要为其发起认证,可通过 代认证小程序接口提交申请。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=ACTION&access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口仅支持第三方平台使用 component_access_token 自己调用。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 是 | 创建小程序填写“create”;查询创建任务状态填写“search”。参考请求示例 |
| access_token | string | 是 | 接口调用凭证,可使用 component_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 企业名(需与工商部门登记信息一致);如果是“无主体名称个体工商户”则填“个体户+法人姓名”,例如“个体户张三” |
| code | string | 是 | 企业代码 |
| code_type | number | 是 | 企业代码类型 1:统一社会信用代码(18 位) 2:组织机构代码(9 位 xxxxxxxx-x) 3:营业执照注册号(15 位) |
| legal_persona_wechat | string | 是 | 法人微信号 |
| legal_persona_name | string | 是 | 法人姓名(绑定银行卡) |
| component_phone | string | 否 | 第三方联系电话 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 4. 注意事项
- 创建任务逻辑串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞。
# 注册审核事件推送
审核结果会向授权事件接收 URL 推送相关通知。
数据示例:
<xml>
<AppId><![CDATA[第三方平台appid]]></AppId>
<CreateTime>1535442403</CreateTime>
<InfoType><![CDATA[notify_third_fasteregister]]></InfoType>
<appid>创建小程序appid</appid>
<status>0</status>
<auth_code>xxxxx第三方授权码</auth_code>
<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 返回 | 含义 |
|---|---|
| 100001 | 已下发的模板消息法人并未确认且已超时(24h),未进行身份证校验 |
| 100002 | 已下发的模板消息法人并未确认且已超时(24h),未进行人脸识别校验 |
| 100003 | 已下发的模板消息法人并未确认且已超时(24h) |
| 101 | 工商数据返回:“企业已注销” |
| 102 | 工商数据返回:“企业不存在或企业信息未更新” |
| 103 | 工商数据返回:“企业法定代表人姓名不一致” |
| 104 | 工商数据返回:“企业法定代表人身份证号码不一致” |
| 105 | 法定代表人身份证号码,工商数据未更新,请 5-15 个工作日之后尝试 |
| 1000 | 工商数据返回:“企业信息或法定代表人信息不一致” |
| 1001 | 主体创建小程序数量达到上限 |
| 1002 | 主体违规命中黑名单 |
| 1003 | 管理员绑定账号数量达到上限 |
| 1004 | 管理员违规命中黑名单 |
| 1005 | 管理员手机绑定账号数量达到上限 |
| 1006 | 管理员手机号违规命中黑名单 |
| 1007 | 管理员身份证创建账号数量达到上限 |
| 1008 | 管理员身份证违规命中黑名单 |
| -1 | 企业与法人姓名不一致 |
建议:可以使用接口请求的企业名称、企业代码、法人微信、法人姓名四个字段作为每次任务的唯一标示,来区别每次任务。
# 5. 代码示例
# 5.1 创建小程序接口
请求示例
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=create&component_access_token=TOKEN
{
"name": "tencent", // 企业名
"code": "123", // 企业代码
"code_type": 1, // 企业代码类型(1:统一社会信用代码, 2:组织机构代码,3:营业执照注册号)
"legal_persona_wechat": "123", // 法人微信
"legal_persona_name": "candy", // 法人姓名
"component_phone": "1234567" //第三方联系电话
}
返回示例
{
"errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK" // 错误信息
}
# 5.2 查询创建任务状态
请求示例
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=search&component_access_token=TOKEN
{
"name": "tencent",
"legal_persona_wechat": "123",
"legal_persona_name": "melody"
}
返回示例
{
"errcode": 0,
"errmsg": "OK"
}
注:该接口只提供当下任务结果查询,不建议过分依赖该接口查询所创建小程序。小程序的成功状态可在第三方服务器中自行对账、查询。
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙,此时请开发者稍候再试 |
| 0 | ok | ok |
| 61070 | name idcard wechat name not in accordance | 法人姓名与微信号不一致 |
| 86004 | invalid wechat | 无效微信号 |
| 89247 | inner error retry after some while | 系统内部错误 |
| 89248 | invalid code type | 企业代码类型无效,请选择正确类型填写 |
| 89249 | task running | 该appid已有转正任务执行中,距上次任务 24h 后再试 |
| 89250 | task not found | 未找到该任务 |
| 89251 | legal persona checking | 模板消息已下发,待法人人脸核身校验 |
| 89252 | front checking | 法人&企业信息一致性校验中 |
| 89253 | lack of some params | 缺少参数 |
| 89254 | lack of some component rights | 第三方权限集不全,请补充权限集后重试 |
| 89255 | enterprise code invalid | code参数无效,请检查code长度以及内容是否正确;注意code_type的值不同需要传的code长度不一样 |
| 91030 | this wxuser has reached their daily limit of api calls. | 每个微信号每天只能调用该接口5次,已达上限了。建议服务商在产品界面给予用户更清晰的指引,接口中要求填微信号的参数只支持填入微信号,不支持填手机号或者微信名称。 |
# 7. 适用范围
本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明,均不可调用。