# 快速创建个人小程序
为了帮助服务商更好地为个人商户及开发者提供更加方便、快捷的第三方服务,平台推出快速创建个人小程序接口。该接口只需收集用户姓名、微信号,并通过平台下发的身份验证 URL,采集用户的身份信息和人脸识别信息、手机号信息,便可以完成注册流程。通过快速创建个人小程序接口,既可以缩短有开发能力的个人小程序开发者授权第三方平台的路径,也能帮助第三方平台拓展商户的服务范围。
使用过程中如遇到问题,可前往微信开放平台,点击官方客服实时咨询。
注意:通过该接口注册的小程序不可绑定微信支付商户号。
自 2023 年 12 月 25 日起,通过本接口新注册的账号默认为未认证状态,需完成认证后方可获得「被搜索、分享」能力,未认证不影响账号发布上架。如第三方开发者需为其发起认证,可通过代认证小程序接口提交申请。
# 整体流程介绍
# 使用步骤
1)权限集准备:第三方平台需具有以下权限集。注册小程序后会将如下权限集授权给第三方平台。
| 权限集 | 是否必填 |
|---|---|
| 账号管理权限 | 必填 |
| 开发管理与数据分析权限 | 必填 |
| 开放平台账号管理权限 | 必填 |
| 小程序基本信息设置权限 | 必填 |
| 插件管理权限 | 必填 |
2)第三方收集用户姓名、用户微信号,以及第三方客服电话,方便商家与第三方联系(建议填写第三方客服电话)。
3)通过姓名和微信号校验(用户姓名需与微信号绑定微信银行卡的姓名一致),平台向第三方下发用户身份验证 URL,第三方可将 URL 生成二维码置于自己的服务页面。用户需在 24 小时内 扫描二维码完成身份证信息、人脸识别信息及手机号收集。
4)信息收集完毕,验证通过后,即可创建个人小程序。第三方平台服务器可以收到创建 AppID 信息(通过授权事件接收 URL 接收信息)。
5)第三方获得小程序 AppID 后,可调用代码开发相关接口,完成后续的小程序代码开发。
# 一、创建个人主体小程序接口详情
# 请求地址
POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=create&component_access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| ACCESS_TOKEN | string | 是 | 第三方平台令牌 component_access_token | |
| idname | string | 是 | 个人用户名字 | |
| wxuser | string | 是 | 个人用户微信号 | |
| component_phone | string | 否 | 第三方联系电话 |
# 请求示例
{
"idname": "tencent",
"wxuser": "wxidnnn",
"component_phone": "1234567"
}
# 返回示例
{
"errcode": 0,
"errmsg": "OK",
"taskid": "xxxxx",
"authorize_url": "https://mp.weixin.qq.com/xxxx",
"status": 0
}
# 错误码说明
| 错误码 | 含义 | 提示语 |
|---|---|---|
| 0 | 成功 | ok |
| -1 | 系统繁忙,此时请开发者稍候再试 | system error |
| 86030 | 提交的 JSON 数据缺少需要的参数 | 缺少参数 |
| 86031 | 内部错误 | 第三方号无效或未全网发布 |
| 86032 | 无效微信号 | 微信 ID 无效 |
| 86033 | 第三方号的缺少所需权限集 | 第三方号的权限集缺失 |
| 86036 | 姓名与微信号不一致 | 姓名与微信号不一致 |
| 其他错误码 | 请查看 全局错误码 |
# 二、查询创建任务状态接口详情
# 请求地址
POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=query&component_access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| ACCESS_TOKEN | string | 是 | 第三方平台令牌 component_access_token | |
| taskid | string | 是 | 任务 ID |
# 请求示例
{
"taskid": "xxxxx"
}
# 返回示例
{
"errcode": 0,
"errmsg": "OK",
"taskid": "xxxxx",
"authorize_url": "https://mp.weixin.qq.com/xxxx",
"status": 0
}
# 错误码说明
| 错误码 | 含义 | 提示语 |
|---|---|---|
| 0 | 成功 | ok |
| -1 | 非法 action 参数 | invalid action |
| 86030 | 提交的 JSON 数据缺少需要的参数 | 缺少参数 |
| 1 | 任务超时或者不存在 | no such task or expired |
| 其他错误码 | 请查看 全局错误码 |
# status 状态码说明
| status 返回 | 含义 |
|---|---|
| 1 | 生成任务 |
| 2 | 任务超时 |
| 3 | 任务已经被用户拒绝 |
| 4 | 用户同意创建 |
| 5 | 已经发起人脸流程 |
| 6 | 人脸认证失败 |
| 7 | 人脸认证成功 |
| 8 | 人脸认证后,已经提交手机号码下发验证码 |
| 9 | 手机验证失败 |
| 10 | 手机号验证成功后,提交了创建 |
| 11 | 创建失败 |
| 12 | 创建成功 |
| 1001 | 主体创建小程序数量达到上限 |
| 1002 | 主体违规命中黑名单 |
| 1003 | 管理员绑定账号数量达到上限 |
| 1004 | 管理员违规命中黑名单 |
| 1005 | 管理员手机绑定账号数量达到上限 |
| 1006 | 管理员手机号违规命中黑名单 |
| 1007 | 管理员身份证创建账号数量达到上限 |
| 1008 | 管理员身份证违规命中黑名单 |
# 三、事件推送
结果会向授权事件接收 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>
<wxuser><![CDATA[用户微信号]]></wxuser>
<idname><![CDATA[用户姓名]]></wxidnnn>
<component_phone><![CDATA[第三方联系电话]]></component_phone>
</info>
</xml>
# status 状态码说明
| status 返回 | 含义 |
|---|---|
| 1001 | 主体创建小程序数量达到上限 |
| 1002 | 主体违规命中黑名单 |
| 1003 | 管理员绑定账号数量达到上限 |
| 1004 | 管理员违规命中黑名单 |
| 1005 | 管理员手机绑定账号数量达到上限 |
| 1006 | 管理员手机号违规命中黑名单 |
| 1007 | 管理员身份证创建账号数量达到上限 |
| 1008 | 管理员身份证违规命中黑名单 |