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

查看 Markdown

最后一次编辑于 2026-08-24

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

接口英文名:fastregistertransactionweapp

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

使用步骤

  1. 权限集准备:第三方平台需具有以下权限集。 注册小程序后会将如下权限集授权给第三方平台。
权限集 是否必填
18、开发管理与数据分析权限 必填
30、小程序基本信息设置权限 必填
76、违规和申诉管理权限 必填
85、自定义版交易组件 必填
  1. 第三方收集用户微信openid外加第三方客服电话,方便商家与第三方联系(建议填写第三方客服电话);
  2. 平台向第三方下发用户身份验证url,链接有效期为 1 天
  3. 信息收集完毕,验证通过后,即可创建个人交易小程序。第三方平台服务器可以收到创建 appid 信息(通过授权事件接收 URL 接收信息); 65 第三方获得小程序 appid 后,可调用代码开发相关接口,完成后续的小程序代码开发。

1. 调用方式

HTTPS 调用

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

云调用

  • 本接口不支持云调用。

第三方调用

2. 请求参数

查询参数 Query String Parameters

参数名类型必填说明
access_tokenstring是接口调用凭证,可使用 component_access_token
actionstring是创建填写“create”;查询任务状态填写“query”

请求体 Request Payload

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

3. 返回参数

返回体 Response Payload

参数名类型说明枚举
errcodenumber状态码,0成功,其他失败-
errmsgstring错误信息-
taskidstring任务id,后面query查询需要用到-
authorize_urlstring 给用户扫码认证的验证url-
statusnumber任务的状态枚举值

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. 注意事项

  1. 创建任务逻辑串行,单次任务结束后才可以使用相同信息下发第二次任务,请注意规避任务阻塞

  2. 认证链接只允许接口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. 代码示例

6.1 查询创建任务状态

请求示例

{
  "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 // 任务的状态
}

6.2 创建任务

请求示例

{
  "openid": "wxidnnn", // 个人用户微信openid
  "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 // 任务的状态
}

7. 错误码

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

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

8. 适用范围

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

接口变更日志(1条)
2026 年 03 月 20 日
错误码 字段枚举值及描述变更,新增「主体创建小程序数量达到上限」等 8 个枚举类型,新增解决方案列