服务商接入必读

小商店服务市场授权指南

非服务商忽略此章节

A. 购买授权

用户在服务市场上购买套餐的同时授权小商店权限集给第三方平台,第三方平台收到授权消息回调后,根据拿到的appid、authorization_code和第三方平台自己的component_access_token生成authorizer_refresh_token,与appid绑定并创建第三方自身体系的账号。

goumaishouquan.png

B. 小商店触发登录

xiaochengxuchufadenglu.png

小商店登录过程分为几个步骤: 1)用户在小商店管理端在已购买的服务中,选择其中一项点击去使用 2)小商店管理端生成code,并作为参数拼接到跳转url 3) 第三方平台拿到component_access_token,带上url的参数code请求小商店登录接口获取用户信息(详情请见api文档) 4)第三方拿到用户信息(appid),检查该appid是否已经在第三方自身账号体系中存在,如果不存在则触发注册,存在则直接完成登录。

C. 第三方网站直接登录使用

除了小商店管理端登录外,还提供第三方自有账号系统登录的途径供商户使用。

disanfangwangzhanzhijiedenglushiyong.png

第三方网站直接登录分两个步骤: 1)小商店用户通过第三方网站自身的账号体系登录,通过对应小商店用户的appid、第三方component_appid以及A中记录的authorizer_refresh_token获取用户的authorizer_access_token 2)第三方获取有效期的服务列表,并给用户展示对应的服务套餐

D. 服务商使用用户数据(调api)

fuwushangshiyongyonghushuju.png

这一步需要商户先完成登录,第三方可以该商户的身份调用小商店api。

http请求方式:POST https://api.weixin.qq.com/product/aaaaa/bbbbb?access_token=xxxxxxxxx&service_id=yyy (注意url里面的aaaaa和bbbbb请以api文档对应接口实际的url为准)

url中的access_token使用的是第三方授权令牌authorizer_access_token url中的service_id是用来校验该小商店用户(appid)购买的服务(service_id)是否在有效期内,如果不在有效期内,该api请求会被拦截

E. 调试api

如果服务商想脱离第三方授权只是调试接口功能的话,请另外开一个测试的小商店,然后以这个小商店自己的身份调用api接口

注意服务商调用以下接口时请在url中加上 service_id 及 specification_id 参数,这2个参数通过接口登录验证获取用户购买的有效服务列表获得

http请求方式:POST
https://api.weixin.qq.com/product/aaaaa/bbbbb?access_token=xxxxxxxxx&service_id=123&&specification_id=zzz

(注意url里面的aaaaa和bbbbb请以api文档对应接口实际的url为准)

服务商以第三方调用api时,url中的access_token使用的是第三方授权令牌authorizer_access_token

商品和订单权限集接口的url需要加上service_id和specification_id参数,用来校验该小商店用户(appid)购买的服务(service_id&specification_id)是否在有效期内,如果不在有效期内,该api请求会被拦截(返回200002错误)

如果url中缺少service_id或specification_id,也会返回200002错误