# 快速注册企业小程序
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
registerMiniprogram
# 功能描述
关于快速注册小程序的详细介绍以及使用步骤、常见问题等请查看快速注册企业小程序介绍,本文为快速注册小程序的接口文档。
自2023年12月25日起,通过本接口新注册的账号,默认为未认证状态,如第三方开发者需要为其发起认证,可通过 代认证小程序接口提交申请。# 注意事项
- 创建任务逻辑串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=create&component_access_token=TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用component_access_token |
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 | 否 | 第三方联系电话 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 其他说明
# 二、查询创建任务状态
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=search&component_access_token=TOKEN
POST 数据示例:
{
"name": "tencent", // 企业名
"legal_persona_wechat": "123", // 法人微信
"legal_persona_name": "pony" // 法人姓名
}
参数说明:
参数名 | 描述 |
---|---|
name | 企业名 |
legal_persona_wechat | 法人微信号 |
legal_persona_name | 法人姓名(绑定银行卡) |
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
TOKEN | string | 是 | 第三方平台令牌 | |
name | string | 是 | 企业名(需与工商部门登记信息一致) | |
legal_persona_wechat | string | 是 | 法人微信号 | |
legal_persona_name | string | 是 | 法人姓名(绑定银行卡) |
返回结果示例:
{
"errcode":0, // 状态码,0成功,其他失败
"errmsg":"OK" // 错误信息
}
注:该接口只提供当下任务结果查询,不建议过分依赖该接口查询所创建小程序。小程序的成功状态可在第三方服务器中自行对账、查询。
# 三、注册审核事件推送
审核结果会向授权事件接收 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 | 企业与法人姓名不一致 |
建议:可以使用接口请求的企业名称、企业代码、法人微信、法人姓名四个字段作为每次任务的唯一标示,来区别每次任务。
# 调用示例
示例说明: 创建小程序接口
# 请求数据示例
{
"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" // 错误信息
}
示例说明: 查询创建任务状态
# 请求数据示例
{
"name": "tencent",
"legal_persona_wechat": "123",
"legal_persona_name": "melody"
}
# 返回数据示例
{
"errcode":0,
"errmsg":"OK"
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok | ok |
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
89249 | task running | 该appid已有转正任务执行中,距上次任务 24h 后再试 |
89247 | inner error retry after some while | 系统内部错误 |
86004 | invalid wechat | 无效微信号 |
61070 | name idcard wechat name not in accordance | 法人姓名与微信号不一致 |
89248 | invalid code type | 企业代码类型无效,请选择正确类型填写 |
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长度不一样 |