商家店铺授权给开发者

当开发者获取商家的店铺订单时,商家需要授权给开发者。 开发者提供授权链接,让商家点击跳去授权 。

1. 准备给商家的授权链接

开发者可在自己的网站添加授权入口,让商家点击下面的授权链接,商家使用自己的拼多多账号登录后,再进行授权,授权完成后,蜂巢开放平台会回调开发者的网站,并将授权的商家账号及订购时间传回。

拼多多服务市场订购: https://fuwu.pinduoduo.com/service-market/service-detail?detailId=46615

授权链接格式为:
https://kf.fw199.com/partner/pddgrant?appid=Your_AppId&callback=Your_CallBackUrl

上述拼接授权URL相关参数说明:

参数名称 是否必选 参数说明 示例
appid 必选 开发者AppId 38lsDeiaqpjpLsAA ,请改为开发者自己的AppId
callback 可选 开发者的回调url , url应以http或https开头,回调url可以附带开发者的自定义参数(回调时会原样返回),商家授权完成后,蜂巢系统会将页面重定向到此url, 并同时在url中增加返回参数 seller和token。 此url需要进行UrlEncode

2 授权链接示例

2.1 不带参数情况

假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/authback ,对此url进行encode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fauthback, 则完整的授权链接为

https://kf.fw199.com/partner/ppdgrant?appid=38lsDeiaqpjpLsAA&callback=https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fauthback

2.2 带参数情况

假如您的appid为38lsDeiaqpjpLsAA, 网站的回调url为: https://www.baidu.com/h7b/callback?userid=100 ,对此url进行UrlEncode
后得到https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100, 则完整的授权链接为

https://kf.fw199.com/partner/ppdgrant?appid=38lsDeiaqpjpLsAA&callback=https%3A%2F%2Fwww.baidu.com%2Fh7b%2Fcallback%3Fuserid%3D100

3 授权回调

商家在拼多多授权页面,点同意授权后,蜂巢平台会重定向到开发者授权Url中传入的回调网址callback,并同时附上pddseller、token 参数。
调回url类似如下:

https://www.baidu.com/h7b/callback?userid=100&pddseller=%E7%99%BE%E9%9E%8B%E9%A6%86&token=346938e31fbb7342acbcf2e61f1684a9&deadline=2021-02-13+00%3A00%3A00&shopname=%E4%B9%A6%E9%A6%99%E9%97%A8%E7%AC%AC%E5%AD%A6%E6%B5%B7%E6%97%A0%E6%B6%AF

回调参数说明

参数名称 参数说明 示例
pddseller 授权的拼多多商家账号,注意不是商家的店铺名, 后续调用蜂巢接口,seller_nick商家账号用此值传入 pdd75750622154
pdduserid 授权的拼多多商家账号Id, 75750622154
token 蜂巢平台返回校验值,可用于判断本次回调是否是来自蜂巢。 采用md5(appSecret+pdduserid + pddseller+appSecret)生成,建议开发者在自己侧使用平台分配的密钥生成并进行匹配token。 346938e31fbb7342acbcf2e61f1684a9
deadline 此授商家订购拼多多千里马服务截止时间,需要UrlDecode。 比如2021-02-13+00%3A00%3A00 ,进行UrlDecode后,得到2021-02-13 00:00:00
shopname 此授权商家的店铺名称,需要UrlDecode。

生成token的Java代码

 String token = Utils.MD5(Config.AppSecret + pdduserid +  pddseller + Config.AppSecret);

说明:Config.AppSecret为平台分配给开发者的密钥。

文档更新时间: 2023-06-27 00:16   作者:admin