# 快速注册个人小程序

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：fastRegisterPersonalMp

本接口用于第三方快速注册个人小程序。

• 为了帮助服务商更好地为个人商户及开发者提供更加方便、快捷的第三方服务，平台推出快速创建个人小程序接口。该接口只需要收集用户的微信号信息，然后通过平台下发的身份验证url，采集用户的身份信息和人脸识别信息、手机号信息，便可以完成注册流程。
• 通过快速创建个人小程序接口，既可以缩短有开发能力的个人小程序开发者授权第三方平台的路径，也能帮助第三方平台拓展商户的服务范围。

注意

1. 通过该接口注册的小程序不可绑定微信支付商户号
2. 自2023年12月25日起，通过本接口新注册的账号默认为未认证状态，需完成认证后方可获得“被搜索、分享”能力，未认证不影响账号发布上架。如第三方开发者需为其发起认证，可通过小程序认证提交提交申请。关于快速注册小程序的详细介绍以及使用步骤等请查看快速注册个人小程序介绍，本文为快速注册小程序的接口文档。
3. 本接口有两个版本可供选择，新版本new_version参数必须填true，具体调用方式请看代码示例。

使用步骤

1.权限集准备：第三方平台需具有以下权限集。 注册小程序后会将如下权限集授权给第三方平台。

2.第三方收集用户微信外加第三方客服电话，方便商家与第三方联系（建议填写第三方客服电话）

3.通过微信号校验之后，平台向第三方下发用户身份验证url，第三方可将url生成二维码置于自己的服务页面。用户需在24小时内扫描二维码完成身份证信息、人脸识别信息及手机号收集；

4.信息收集完毕，验证通过后，即可创建个人小程序。第三方平台服务器可以收到创建 appid 信息（通过授权事件接收 URL 接收信息）；

5.第三方获得小程序 appid 后，可调用代码开发相关接口，完成后续的小程序代码开发。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?access_token=ACCESS_TOKEN&action=create

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口仅支持第三方平台使用 component_access_token 自己调用。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# 4. 枚举信息

# Res.status Enum

任务的状态

# 5. 注意事项

• 通过该接口注册的小程序不可绑定微信支付商户号。
• 该接口每分钟调用频率为：5/mini
• 该接口每天的调用次数为：100/天
• 开发者应该合理控制接口的调用频率和每天的调用次数

# 事件推送

注册成功失败的结果会向授权事件接收 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状态码说明

# 6. 代码示例

# 6.1 快速注册个人小程序

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=create&component_access_token=ACCESS_TOKEN

{
"idname": "tencent", // 个人用户名字
"wxuser": "wxidnnn", // 个人用户微信id
"component_phone": "1234567" //第三方联系电话
...
"wxuser": "xxx",    // 用户微信号
"component_phone": "1234567", //第三方联系电话
"new_version" : true

 }

返回示例

{
"errcode": 0, // 状态码，0成功，其他失败
"errmsg": "OK" // 错误信息
"taskid": "xxxxx". // 任务id，后面query查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 6.2 查询创建任务状态

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=query&component_access_token=ACCESS_TOKEN

{
"taskid": "xxxxx" // 创建任务成功时，返回的taskid
 }

返回示例

{
 "errcode": 0, // 状态码，0成功，其他失败
"errmsg": "OK", // 错误信息
"taskid": "xxxxx". // 任务id，后面 query 查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 6.3 新版本快速注册个人小程序

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=create&component_access_token=ACCESS_TOKEN

{
  
"wxuser": "xxx",    // 用户微信号
"component_phone": "1234567", //第三方联系电话
"new_version" : true

 }

返回示例

{
"errcode": 0, // 状态码，0成功，其他失败
"errmsg": "OK" // 错误信息
"taskid": "xxxxx". // 任务id，后面query查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 6.4 新版本查询创建任务状态

请求示例

POST https://api.weixin.qq.com/wxa/component/fastregisterpersonalweapp?action=query&component_access_token=ACCESS_TOKEN

{
"taskid": "xxxxx", // 创建任务成功时，返回的taskid
"new_version" : true
 }

返回示例

{
 "errcode": 0, // 状态码，0成功，其他失败
"errmsg": "OK", // 错误信息
"taskid": "xxxxx". // 任务id，后面 query 查询需要用到
"authorize_url": "https://mp.weixin.qq.com/xxxx", // 给用户扫码认证的验证url
"status": 0 // 任务的状态
 }

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 8. 适用范围

本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（1条）

2026 年 03 月 10 日

文档描述优化，新增 action 、 new_version 字段，更新 status 状态码说明，新增错误码选项等 4 个字段