1 概述

本手册旨在帮助服务商更快接入百度小程序第三方平台，代开发者开发和运营百度智能小程序。

2 术语和缩写的解释

3 服务商入驻

3.1个服务商入驻

3.1.1 申请入学

1）进入百度智能小程序官网并登录

官网地址：

支持账号：百家号、雄跑等非个人百度账号；百度推广、百晴腾等百度商业账号

2）登录成功后，进入“第三方平台”首页

3）在第三方平台首页，点击“立即申请”按钮，申请第三方平台入驻

4）填写公司名称，提交服务商资质审核

请确保您填写的公司名称与营业执照一致，否则会影响第三方平台。

如果您的账户已经在智能小程序中注册并完成了主体认证，进入第三方平台时主体资格将自动重复使用，您只需确认信息即可。

5）百度审计服务商企业资质

提交公司名称后，百度将对服务商的企业资质进行机器审核，判断其是否符合开通第三方平台的资质。审核结果可实时反馈。

3.1.2 主体认证

通过服务商资质审核后，自动跳转到主体认证流程。如果账号已经通过智能小程序认证，则可以跳过此步骤。

1）选择主体类型

请选择与业务相关的对应实体类型。此类型注册成功后不可更改。

2）填写主题信息

按要求填写并上传学科资格信息，请确保信息真实有效。

注：主题认证过程最多有5次提交机会，请仔细核对信息并填写！

3）百度审核主体资格

信息提交成功后，百度将在2-5个工作日内完成审核。

3.1.3 验证真伪

主体认证完成后，还需进一步完成真伪认证，否则第三方平台将无法上线。

1）进入认证中心

2）完成认证

不同的主体类型有不同的认证方式，如下：

方法一：公开验证

方法二：证书验证

方式三：法人人脸识别验证

3.2 平台创建与发布

3.2.1 第三方平台创建

登录服务商的超级管理员账号后，可以到管理中心/第三方平台创建第三方平台应用。（注：同一个账号最多可以创建5个第三方平台应用）

1）填写基本信息

填写您的第三方平台的基本信息，将在用户授权页面显示。其中，官网需要填写你的主体完成工信部备案的网站。

2）选择权限

选择您的平台所需的用户权限。选择后，权限会显示在用户授权页面，用户可以选择。

3）填写开发信息

填写开发相关信息，请仔细阅读，如下：

此步骤完成后，平台创建成功，即可开始平台功能开发。

3.2.2 第三方平台开发

请开发所选权限集对应的产品能力，并将测试小程序加入测试白名单，在平台发布前完成授权。

百度会在平台发布前自动检测功能实现，通过平台后才能发布平台并接受开发者授权。

3.2.3 第三方平台发布

1）平台能力测试

第三方平台创建成功并完成最终开发测试后，即可提交全网发布申请。此时，百度服务器会通过自动化测试来检测第三方平台选择的权限集对应的服务的基本逻辑是否可用。测试通过后，允许第三方平台提交全网发布。

自动检测的具体机制请参考：

2）平台基本信息回顾

通过平台能力测试后，百度将对平台的基本信息进行审核。审核通过后，第三方平台将发布上线。

4代开发业务实现

4.1 小程序开发

第三方平台提交授权小程序代码的方式有两种：

4.1.1 模板开发

第一步：绑定开发小程序

1）第三方平台的开发者需要先到智能小程序开发者平台()创建小程序。

2）在第三方平台-设置-绑定开发小程序页面，使用小程序管理员账号登录百度APP，扫描二维码将小程序绑定为模板开发小程序。

第二步：开发并上传小程序模板草稿

1）使用绑定的管理员或会员账号登录百度小程序开发者工具（IDE）开发小程序。

2）在开发者工具中，按照正常的小程序开发流程进行代码开发和调试。

3）开发完成后，点击发布上传草稿。

注意：上传草稿时，请不要在小程序根目录下包含ext.json文件，否则上传不成功

第三步：在模板库中添加小程序草稿并获取模板ID

从开发者工具上传的代码会先存入草稿箱。开发者可以在第三方平台上操作或调用接口将草稿框中的草稿添加到小程序模板库中。小程序模板库中的模板不会被覆盖。每个第三方平台最多可以有五十个代码模板，添加后可以获得模板ID。

第四步：开发者将小程序授权给第三方平台

开发者需要通过百度APP扫描第三方平台提供的授权二维码，将小程序授权给第三方平台。具体第三方授权流程请参考文档：

第五步：调用接口提交授权小程序的代码包

具体接口请参考“小程序包管理”中的相关接口：

4.1.2 自定义开发

第一步：开发者将小程序授权给第三方平台

开发者需要通过百度APP扫描第三方平台提供的授权二维码，将小程序授权给第三方平台。具体第三方授权流程请参考文档：

第二步：开发并上传小程序源代码包

使用绑定开发小程序的开发者账号登录百度小程序开发者工具（IDE），在开发者工具中按照正常的小程序开发流程进行代码开发和调试。开发完成后，将ext.json文件添加到小程序包中，并在文件中添加一个字段（请填写要提取的包的客户授权小程序id），点击发布完成授权小程序代码包提交。

注意：您可以通过开发者工具的命令行操作功能实现自动化操作。具体文件请参考：

4.2代注册（白名单开放）

代理注册功能支持服务商授权开发者注册百度小程序账号和创建小程序，可以实现小程序生命周期托管的全流程。

注册函数文档请参考：

4.2.1 授权

服务商可通过接口获取注册授权二维码，引导开发者使用百度APP扫描二维码对服务商进行授权。具体授权流程交互如下：

1）使用百度APP扫描授权二维码

2）确认登录百度账号或百度企业账号（注：账号需绑定手机号）

3）账号已绑定百家账号或熊掌ID后，需确认可直接复用已有账号资格开通小程序账号；如果没有绑定，则不需要这一步

4）确认授权服务商及对应权限

5）授权成功，服务提供者可以通过页面回调和push获取授权证书（如果没有注册账号，获取注册/创建的授权码，创建的授权码只有注册账号时获取）

注：代表注册授权重新扫描二维码可取消

4.2.2代注册账号

开发者完成授权后，服务商可以通过接口代表开发者提交账户信息和小程序信息。账号审核通过后，百度会自动创建小程序，提交小程序信息进行审核，同时推送服务商注册成功结果。小程序基本信息将在个人审核后（24小时内）单独推送。

如果您在提交代理注册请求时遇到小程序名称重复、参数错误或账号验证失败等问题，请修改相关信息后再次调用代理注册接口提交。账号审核通过并成功创建小程序后，代表该账号注册的授权码将失效。如果需要在账号下继续创建多个小程序，请调用代表创建小程序的接口。

4.2.3代创建小程序

当授权账号注册完成后，服务商可以代表账号调用创建小程序接口，在账号下新建一个小程序，并提交小程序的基本信息。调用成功后，百度会创建小程序，提交小程序信息供审核，并推送服务商代用户创建成功结果。小程序基本信息将在个人审核后（24小时内）单独推送。

注意：默认每个小程序账号下可以创建20个小程序。达到上限后，无法继续创建。

4.第三代认证

小程序上线前，需完成主体真实性验证。目前，针对不同的主体类型，主体真实性的认证方式如下：

其中，服务商可以通过API快速调用公众验证或合法人脸识别验证服务页面，让开发者无需去百度后台即可完成验证操作。

4.3.1公开验证

服务提供者可以通过API调用公开验证页面，开发者可以在该页面完成鉴权操作。具体接口文档请参考：

[/网址]

公开验证操作流程如下：

1）开发者进入公众验证页面完善公众号信息

2）百度支付到开发者公众号

3）开发者查询公众号收到的支付金额，并到公众验证页面回填金额

金额验证通过后，即可完成主体真实性验证。

4.3.2法人人脸识别验证

服务商可通过API获取法人人脸识别二维码小程序开发需要到哪里备案，开发者法人可通过百度APP扫描二维码进入法人人脸识别验证页面。完成信息刷脸验证后，即可完成主体真实性验证。接口文档可以参考：

注：对于企业类型的实体，百度后台仅支持公开验证，服务商接口支持公开验证和合法人脸识别验证。

4.4 小程序生命周期管理

服务商可以通过接口对小程序进行授权，管理基础信息和开发信息，提交代码包并在线发布，从而实现对小程序全生命周期的管理。

4.4.1 小程序授权

开发者在智能小程序开发者平台完成账号注册和小程序创建后，可通过百度APP扫描服务商授权二维码，将账号下的小程序授权给服务商。

1）开发者账号注册

开发者可以到百度小程序官网提交公司信息和运营商信息，注册小程序账号并进行主体认证。详情请参考文档：

2）开发人员创建小程序

账号注册完成并通过主体认证后，开发者可以前往百度小程序管理中心创建智能小程序，完善小程序基础信息。详情请参考文档：

3）开发者扫码授权

小程序创建完成后，开发者可以到服务商平台，扫描授权二维码，将账号下的小程序授权给服务商进行管理。

服务商调用百度API获取授权二维码，请参考文档：

扫描二维码后，开发者会跳转到授权页面。依次完成账户确认、授权小程序选择、授权授权确认等操作后，即可将小程序授权给服务商。服务提供者可以继续通过API获取授权小程序接口调用凭证，代为开发和管理小程序。

4.4.2 开发信息设置

当服务商授权小程序开发时，需要调用百度API完成以下开发信息设置：

1）设置小程序服务器域名，请参考文档：

2）设置小程序业务域名。添加业务域名后，即可打开对应域名下的页面。请参考文档：

[/网址]

注意：需要将业务域名添加到TP开放平台并通过域名验证后，才能进一步配置业务域名到小程序

4.4.3 修改基本信息

当开发者小程序的基本信息未经审核或需要修改时，服务提供者可以调用修改基本信息的API代表开发者进行操作。基础信息修改提交成功后，百度会进行审核（24小时），审核后将审核结果推送到服务商的消息和事件接收URL。

1）修改姓名、简介、头像、类别请参考文档：

2）基本信息审核结果推送，请参考文档：

注意：

1）提交行业分类修改时，可以先通过API查询所有行业分类对应的ID；

2）基础信息的修改次数有限制，如下：

服务提供者可以通过调用API查询剩余修改次数。详情请参阅：

4.4.4 上传代码包

服务商可以通过模板或源码包为授权的小程序账号提交代码包。

1）模板包通过API实现。详情请参阅：

[/网址]

注意：您需要先将模板上传到第三方平台，然后才能使用模板代表开发者提交代码包。

2）通过开发者工具提交原代码包。详情请参阅：

[/网址]

4.4.5 提交代码包审核

代码包上传成功后，需要进一步提交代码包审核，审核通过后即可上线发布。提交代码包审核的方式有两种，如下：

1）调用API查看代码包。有关详细信息，请参阅文档：

[/网址]

2）调用模板包API时，可以通过.中的字段设置直接提交审核。详情请参阅：

4.4.6上线

服务提供者可以通过调用API提交和发布授权的小程序。发布成功后，小程序可在百度APP搜索引擎和小程序中心展示。详情请参阅：

注意：小程序上线前必须完成以下三个步骤

1）通过学科真实性认证

2）小程序基本信息全部审核通过

3）小程序代码包通过审核

全部完成后，小程序就可以正式上线发布了。

4.4.7 检测离线

在线小程序将不时接受检查。如果在巡查中发现小程序问题，将强制下线、流量下线，限时整改。服务商需要根据需要代表开发者进行修改，然后恢复上线。当授权的小程序通过检查处理后，百度会向服务器发送推送。详情请参阅：

具体措施及解决方案如下：

1）强制下线

小程序强制下线后，包体下线，无法再进行流量分发。强制下线的类型可以分为三类：基础信息问题下线、包体问题下线、基础信息和包体问题下线。

2）流量离线

小程序流量下线后，包体依然在线，但无法再进行流量分发。流量下线类型也分为三类：基础信息问题下线、包体问题下线、基础信息和包体问题下线。

3）限时整改

小程序限时整改后，包体依然在线，不影响流量，但需要开发者在3天内完成修改，否则小程序将被强制下线。

流量下线类型也分为三类：基础信息问题下线、包体问题下线、基础信息和包体问题下线。

5 高级能力实现

5.1 负担能力

要使用百度智能小程序的支付能力，您需要使用百度收银台开通支付账户和服务。服务商可以调用接口申请支付账户，代表开发者开通支付服务。具体步骤如下：

1）代表创建一个支付账户

2）提交开发者信息设置

3）创建支付服务

详情请参考文档：

注：TP开放平台有支付管理专属权限集。开发者授权权限集后，服务提供者可以调用相关接口代为创建支付服务。

支付服务开通后，服务商可以通过百度聚合收银台实现支付服务。详情请参考文档：

5.2 客户服务能力

5.2.1 访问客户服务

目前，开发者可以通过三种方式接入客服能力：

1.客服消息转发：通过服务器接收和转发客服消息，支持服务商服务器代为收发消息

2.要绑定百度商务桥客服工具，可以到开发者平台配置，文档参考：

3.配置第三方客服工具，可以到开发者平台配置，文档参考：

其中，方案一，开发者将客服权限授权给服务商后，直接将客服消息推送到服务商的服务器。

5.2.2 服务商代为管理客服消息转发

1）客服留言条目：

开发者在小程序中添加客服功能后（参考使用页面上的客服消息），用户可以在小程序中唤起客服对话页面，向小程序发送消息；

已使用的小程序客服消息将汇总显示在“百度APP-我的-私信”中，用户可以在此查看历史客服消息，并向小程序客服发送消息。

2）消息传递条件：

用户向小程序客服发送消息后，48小时内，小程序客服最多可向开发者发送5条消息，且不累计可发送的客服消息条数。对于时限的更新，将可发送消息数更新为当前可发送消息数的最大限制，有效投递时限也更新为最大有效时间。

3）支持的消息类型

目前支持文本和图片类型的消息。

4）客服消息转发原理

开发者向服务商授权客服权限后，服务商可以代为接收和回复小程序的客服消息。

当用户向小程序的客服（授权客服权限）发送消息时，百度服务器会将消息数据包（JSON或XML格式）POST到服务商的消息和事件接收URL。服务商收到客服消息后，需要自己展示给客户的客服人员，客服回复消息后，调用接口异步回复消息给百度。

5）开发客服消息转发能力

参考文件：