# 快速创建个人小程序
- 为了帮助服务商更好地为个人商户及开发者提供更加方便、快捷的第三方服务,平台推出快速创建个人小程序接口。该接口只需收集用户姓名、微信号,并通过平台下发的身份验证url,采集用户的身份信息和人脸识别信息、手机号信息,便可以完成注册流程。
- 通过快速创建个人小程序接口,既可以缩短有开发能力的个人小程序开发者授权第三方平台的路径,也能帮助第三方平台拓展商户的服务范围。
- 使用过程中如遇到问题,可前往微信开放平台,点击官方客服实时咨询。
注意,通过该接口注册的小程序不可绑定微信支付商户号。
# 整体流程介绍
# 使用步骤
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", // 个人用户微信id
"component_phone": "1234567" //第三方联系电话
}
# 返回示例
{
"errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK" // 错误信息
"taskid": "xxxxx". // 任务id,后面query查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
}
# 错误码说明
错误码 | 含义 | 提示语 |
---|---|---|
0 | 成功 | ok |
-1 | 非法 action 参数 | invalid action |
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" // 创建任务成功时,返回的taskid
}
# 返回示例
{
"errcode": 0, // 状态码,0成功,其他失败
"errmsg": "OK", // 错误信息
"taskid": "xxxxx". // 任务id,后面query查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"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 | 人脸认证ok |
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 | 管理员身份证违规命中黑名单 |