# 快速注册个人升级版小程序

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

接口英文名：fastregistertransactionweapp

为帮助服务商更好地为个人商户提供方便快捷的第三方服务，平台推出了快速注册个人升级版小程序的接口，在服务商满足个人升级版小程序开发能力的申请权限并申请该能力后，该接口只需收集微信用户的openid，并通过平台下发的身份验证url，采集用户的身份信息等，便可以完成注册流程。
通过快速创建个人升级版小程序接口，既可以缩短有开发能力的个人小程序开发者授权第三方平台的路径，也能帮助第三方平台拓展商户的服务范围。
使用该接口的前提：1、服务商上月考核结果为“优秀”、2、服务商保证金＞50%、3、已在第三方平台开通开通个人升级版小程序功能。
通过该接口创建成功的个人升级版小程序会默认开通自定义交易组件和开通任务。

使用步骤

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

权限集	是否必填
18、开发管理与数据分析权限	必填
30、小程序基本信息设置权限	必填
76、违规和申诉管理权限	必填
85、自定义版交易组件	必填

第三方收集用户微信openid外加第三方客服电话，方便商家与第三方联系（建议填写第三方客服电话）；
平台向第三方下发用户身份验证url，链接有效期为 1 天
信息收集完毕，验证通过后，即可创建个人交易小程序。第三方平台服务器可以收到创建 appid 信息（通过授权事件接收 URL 接收信息）； 65 第三方获得小程序 appid 后，可调用代码开发相关接口，完成后续的小程序代码开发。

第三方服务商API接口调整公告

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/component/fastregistertransactionweapp?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

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

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	说明
access_token	string	是	接口调用凭证，可使用 component_access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
openid	string	是	微信用户的openid（不是微信号）获取openid的方法请查看用户管理、微信网页开发-介绍、关于微信快速登录功能的说明
component_phone	string	是	第三方联系电话
new_version	boolean	否	接口新旧版本标识，使用该新接口必须填true，不填默认false

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明	枚举
errcode	number	状态码，0成功，其他失败	-
errmsg	string	错误信息	-
taskid	string	任务id，后面query查询需要用到	-
authorize_url	string	给用户扫码认证的验证url	-
status	number	任务的状态	枚举值

# 4. 枚举信息

# Res.status `Enum`

任务的状态

枚举值	描述
0	生成任务
1	任务超时
2	任务已经被用户拒绝
3	用户同意创建
4	已经发起人脸流程
5	人脸认证失败
6	人脸认证ok
7	人脸认证后，已经提交手机号码下发验证码
8	手机验证失败
9	手机号验证成功
10	手机号验证成功后，提交了创建
11	创建失败
12	创建成功
1001	主体创建小程序数量达到上限（在错误码中提示）
1002	主体违规命中黑名单（在错误码中提示）
1003	管理员绑定账号数量达到上限（在错误码中提示）
1004	管理员违规命中黑名单（在错误码中提示）
1005	管理员手机绑定账号数量达到上限（在错误码中提示）
1006	管理员手机号违规命中黑名单（在错误码中提示）
1007	管理员身份证创建账号数量达到上限（在错误码中提示）
1008	管理员身份证违规命中黑名单（在错误码中提示）

# 5. 注意事项

创建任务逻辑串行，单次任务结束后才可以使用相同信息下发第二次任务，请注意规避任务阻塞
认证链接只允许接口openid参数对应的微信用户打开

# 事件推送

# 数据示例

<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>
    <code_type>0</code_type>
    <legal_persona_wechat><![CDATA[法人微信号]]></legal_persona_wechat>
    <legal_persona_name><![CDATA[法人姓名]]></legal_persona_name>
    <component_phone><![CDATA[第三方联系电话]]></component_phone>
    <taskid>任务id</taskid>
    </info>
</xml>

# 事件推送的 status状态码说明

Status	含义
1001	主体创建小程序数量达到上限
1002	主体违规命中黑名单
1003	管理员绑定账号数量达到上限
1004	管理员违规命中黑名单
1005	管理员手机绑定账号数量达到上限
1006	管理员手机号违规命中黑名单
1007	管理员身份证创建账号数量达到上限
1008	管理员身份证违规命中黑名单

# 6. 代码示例

请求示例

{
  "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 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
-1	非法 action 参数	invalid action
0	成功	ok
1	任务超时或者不存在	no such task or expired
40014	接口调用凭证无效，请检查	invalid access_token
86040	不支持个人第三方号进行调用	该功能不支持个人第三方号发起
86050	提交的json数据缺少需要的参数	缺少参数
86051	第三方号无效, 例如不存在，或者未正式全网发布	第三方号无效或未全网发布
86052	openid无效	openid无效
86053	第三方号的权限集不满足要求	第三方号的权限集不满足要求
86054	该用户微信号受限，无法注册	微信号受限

# 8. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。

接口变更日志（1条）

2026 年 03 月 20 日

错误码 字段枚举值及描述变更，新增「主体创建小程序数量达到上限」等 8 个枚举类型，新增解决方案列