# 微信小店服务市场接入指引
# 一、 入驻标准
我们欢迎符合以下标准的服务商入驻微信小店服务市场务专区：
在小商店服务市场具有良好的服务能力
提供商品管理、订单管理、进销存等相关服务能力
至少具备PC端，建议支持移动端，同时两端账号互通
服务商可提供运营人员，完成服务平台测客服、售后工作
# 二、 接入流程
微信小店工具服务基于微信服务市场及微信服务商平台（下文统称微信服务平台），微信服务平台使用了第三方平台的能力，第三方平台基于开放平台，所以，服务商需提前了解【第三方平台简介】的相关知识。
需前往open.weixin.qq.com-第三方平台申请权限集，并全网发布。
扫码登录微信服务商平台 ，进入企业主页。
配置客服和设置资金账户，如果之前上架过小商店，应该已经设置过了。请再一步确认，如果客服没设置，将会被下架服务；如果资金账户没设置，则无法接收资金结算
客服设置：【微信服务市场客服配置能力】
资金设置：【服务商收款账户指引】
- 上架服务：选择服务上架——微信小店工具服务——点击“去上架”。
下面是相关字段的介绍：
第三方平台： 会拉取同主体下的Open平台的所有第三方Appid，服务商需选择其中一个，后续将使用此第三方平台进行接口的代调用。
服务Url： 作为用户使用跳转的链接。
移动端： 如果服务支持移动端，那么用户在小程序使用时，将跳转到指定的小程序上使用，如果不支持，那么将会提示请到PC上使用。
关联套餐： 
“关联套餐”会拉取同企业主业下的小商店服务套餐，服务商可以选择关联，也可以选择不关联。关联之后，可以将旧的小商店服务服务订单迁移到微信小店下，旧的服务订单会立即失效，微信小店的订单将延续旧订单的有效期，迁移后，新旧订单均不支持退款。
套餐规格ID： 套餐聚合ID，由服务商填写。
举个例子：假设有以下套餐，“基础版-7天”、“基础版-30天”、“进阶版-7天”、“进阶版-30天”，那么服务商应该将“基础版-7天”以及“基础版-30天”的规格ID设置为相同（假设为standard），“进阶版-7天”以及“进阶版-30天”的规格ID设置为相同（假设为“advanced”），服务市场在计算有效期的时候，同一个规格ID的将合并计算，不同规格ID的将分开计算。比如我分别买了“基础版-7天”、“基础版-30天”、“进阶版-7天”，那么我的有效期将是“基础版”37天，进阶版7天。
增加套餐规格ID后，【获取服务用户有效期列表】、【获取服务用户有效期】这两个接口里将按照规格ID聚合，spec_id将返回规格ID，【登录验证】将多返回一个spec_id。 套餐要求：
- 需提供7天免费版本
- 需满足基础定价，如商品管理/订单管理>15元/月，ERP>2000/年
- 调试服务：初次建议勾选为测试服务，对测试服务进行调试，以确保服务可用
- 设置了测试服务之后，需要在微信服务市场pc端-我的主页-基础设置中，将人员设置为测试人员，之后对应的测试人员可以在「微信服务市场」小程序中看到这个服务，并进行调试
- 记得先开一个微信小店，才能下单购买
# 交易流程
- 用户购买后，如果该微信小店尚未将相关权限集授权给第三方平台，那么服务平台将会将相关权限集静默授权给第三方，并且推送【授权变更消息】，服务商可依此换取authorizer_refresh_token；如果该微信小店已将相关权限集授权给第三方平台，那么服务平台将不会推送【授权变更消息】。如果服务商遗漏了授权变更消息，或者丢失了authorizer_refresh_token，那么可以调用【拉取已授权的账号信息】接口重新获取。（这里的第三方应用是服务商创建服务时选择的第三方平台）。 用户支付完成后，服务平台会将【订单推送】给服务商，服务商可选择接入订单推送。
各种类型服务授权的权限集如下：
- 商品服务：129、130、131、132
- 订单服务：129、130、131、132
- ERP：129、130、131、132
- 分销工具：129、130、131、132、138、141
- 厂商代发：129、130、131、132、167、185&186
- 购买之后，用户点击“去使用”，会跳转到服务商在创建服务时填写的Url地址，并在path上带上参数code（如果支持移动端，那么会在跳转的小程序Path上带上code参数），服务商可依据此code调用【登录验证】接口换取订单信息。服务平台提供了【获取服务用户有效期列表】、【获取服务用户有效期】、【获取用户已支付订单列表】三个接口供服务商使用，这三个接口需要使用【服务市场企业主页的access token】。
- 服务商使用第三方平台，代微信小店发起接口代调用，提供相关服务。
- 退款：用户退款成功后，服务市场会解除微信小店与第三方平台的授权关系。
# 运营规则
主要参考资料：【增值服务运营规则】
# API指南
接口列表：【微信小店开放API】
# 注意的点
- 不建议服务商强依赖于推送接口，消息推送受制于网络原因，有可能出现推送失败，建议服务商使用拉取接口，辅以推送接口。
- 授权变更消息推送的地址是第三方平台配置的推送地址，不是创建服务时填写的服务URL。
- 服务商切勿以授权变更消息来判断用户是否支付成功，如果购买的微信小店已经授权过相关权限集给第三方、或者因为网络原因丢失消息，那么服务商是不会收到授权变更消息的。
- 服务商切勿以微信小店是否授权给第三方平台来判断服务的有效期，因为微信小店可能会有其他路径可以将相关权限集授权给第三方平台，请使用有效期相关接口来判断服务的有效期。
- 请服务商注意，小店增值服务使用的"登陆验证接口"、"获取用户购买的在有效期内的服务列表"、“获取用户购买的服务订单列表”三个接口无法在微信小店中使用，请使用新的接口。
- 这里有三个平台，一个是“服务平台”、一个是“第三方平台”，一个是“open平台”，“第三方平台”基于“open平台”，“服务平台”使用了“第三方平台”的能力，所以，请先提前理解第三方平台的授权流程以及相关概念，服务平台做的，是在用户付款后，将小程序（微信小店）的相关权限集静默授权给第三方平台，省去了微信小店扫码授权的步骤。、
- 调用接口出现“api is unauthorized to component”，请先自查一下几个原因：
- 微信小店有购买服务吗？
- 第三方平台有勾选相关的权限集吗？
- 第三方平台有全网发布吗？
- 全网发布之后有重新购买吗？