# 转正为个人升级版小程序

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

接口英文名：fastnormalizebetaweapp

• 为帮助服务商快速将试用小程序转正为个人主体升级版小程序，平台推出了试用小程序转正为个人升级版小程序接口能力，即，只允许代试用小程序调用该接口。
• 该转正接口对权限集有要求，因此在创建试用小程序前，应当配置如下权限集。如果存量的试用小程序尚未配置如下权限集，则请引导用户重新注册。
• 通过该接口转正成功的个人升级版小程序会默认开通自定义交易组件和开通任务。

所需权限集

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口支持第三方平台代商家调用。

• 该接口所属的权限集 id 为：81

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# 4. 枚举信息

# Res.status Enum

# 5. 注意事项

1. 创建任务逻辑串行，单次任务结束后才可以使用相同信息下发第二次任务，请注意规避任务阻塞。
2. 创建任务下发的认证链接只允许试用小程序的管理员打开进行认证

# 事件推送

消息推送规则

由于该接口涉及用户的授权确认操作，为异步操作的流程，因此用户的操作状态平台会将相关信息推送到【授权事件接收 URL】。

• 试用小程序转正成功/失败的通知,相关数据示例请查看下文。
• 授权成功通知的数据示例请查看：https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/authorize_event.html

# 数据示例

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>时间戳</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[betaapp_personal_authorization_apply_event]]></Event>
  <ApplyPersonalAuthorizationInfoNotify>
    <appid>![CDATA[小程序appid]]</appid>
    <status>![CDATA[0]]</status>
    <msg>![CDATA[ok]]</msg>
    <operation_time>![CDATA[操作的时间]]</operation_time>
  </ApplyPersonalAuthorizationInfoNotify>
</xml>

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

# 6. 代码示例

# 6.1 创建任务

请求示例

{
  "component_phone": "13000000000",  // 服务商联系方式，用于展示在认证成功失败的模板消息中
  "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 查询任务状态

请求示例

{
  "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. 适用范围

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