# 快速注册企业小程序
关于快速注册小程序的详细介绍以及使用步骤、常见问题等请查看快速注册企业小程序介绍,本文为快速注册小程序的接口文档。
# 接口详情
# 一、创建小程序接口
POST https://api.weixin.qq.com/cgi-bin/component/fastregisterweapp?action=create&component_access_token=TOKEN
POST 数据示例:
{
"name": "tencent", // 企业名
"code": "123", // 企业代码
"code_type": 1, // 企业代码类型(1:统一社会信用代码, 2:组织机构代码,3:营业执照注册号)
"legal_persona_wechat": "123", // 法人微信
"legal_persona_name": "candy", // 法人姓名
"component_phone": "1234567" //第三方联系电话
}
参数说明:
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
TOKEN | string | 是 | 第三方平台令牌component_access_token | |
name | string | 是 | 企业名(需与工商部门登记信息一致);如果是“无主体名称个体工商户”则填“个体户+法人姓名”,例如“个体户张三” | |
code | string | 是 | 企业代码 | |
code_type | int | 是 | 企业代码类型 1:统一社会信用代码(18 位) 2:组织机构代码(9 位 xxxxxxxx-x) 3:营业执照注册号(15 位) | |
legal_persona_wechat | string | 是 | 法人微信号 | |
legal_persona_name | string | 是 | 法人姓名(绑定银行卡) | |
component_phone | string | 否 | 第三方联系电话 |
返回结果示例:
{
"errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK" // 错误信息
}
错误码说明:
错误码 | 含义 | 提示语 |
---|---|---|
0 | 成功 | ok |
-1 | 系统错误,稍后重试 | system error |
89249 | 该主体已有任务执行中,距上次任务 24h 后再试 | task running |
89247 | 内部错误 | inner error |
86004 | 无效微信号 | invalid wechat |
61070 | 法人姓名与微信号不一致 | name, wechat name not in accordance |
89248 | 企业代码类型无效,请选择正确类型填写 | invalid code type |
89250 | 未找到该任务 | task not found |
89251 | 待法人人脸核身校验 | legal person checking |
89252 | 法人&企业信息一致性校验中 | front checking |
89253 | 缺少参数 | lack of some params |
89254 | 第三方权限集不全,请补充权限集后重试 | lack of some component rights |
89255 | code参数无效,请检查code长度以及内容是否正确 ;注意code_type的值不同需要传的code长度不一样 | enterprise code invalid |
其他错误码 | 请查看全局错误码 |
注意:创建任务逻辑串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞。
# 二、查询创建任务状态
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" // 错误信息
}
错误码说明:
错误码 | 含义 | 提示语 |
---|---|---|
0 | 成功 | ok |
89247 | 内部错误 | inner error |
89250 | 未找到该任务 | task not found |
89251 | 模板消息已下发,待法人人脸核身校验 | legal person checking |
89252 | 法人&企业信息一致性校验中 | front checking |
89253 | 缺少参数 | lack of some params |
其他错误码 | 请查看全局错误码 |
注:该接口只提供当下任务结果查询,不建议过分依赖该接口查询所创建小程序。小程序的成功状态可在第三方服务器中自行对账、查询。
# 三、注册审核事件推送
审核结果会向授权事件接收 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 | 管理员身份证违规命中黑名单 |
建议:可以使用接口请求的企业名称、企业代码、法人微信、法人姓名四个字段作为每次任务的唯一标示,来区别每次任务。