对接流程(支持虚拟商品)
拼多多与商家之间数据双向请求,同步更新及相关数据传输。对接主要分为三大部分:准备阶段、对接测试、上线使用;针对每部分具体说明如下:
接口连通性测试重点关注两类接口的连通性:一类拼多多API相关商家推送的具体业务接口,另一类是商家回调拼多多接口。
同步接口及协议:
接口统一采用 HTTP Get接收订单,返回数据格式为 Json ;
接口公共参数:
加密参数:拼多多给代理商家生成一个特定的密钥,代理商家自行保存好,不需要参与传送;
当商家对订单充值操作完成后,不管成功还是失败,都要再通过开放平台调用拼多多的发货接口pdd.virtual.mobile.charge.notify通知拼多多;如果充值成功,完成订单的发货和确认收货。如果充值失败,会发起退款。
发货流程(拼多多)
1)拼多多调用商家发货接口:
超时时间:5000ms;
备注:如请求超时或其他原因等导致的请求失败,拼多多端会每15分钟发起重试请求,直到正确接收到商家端的返回结果为止,此处商家端服务接口需做好幂等控制;
2)商家异步回调发货结果接口:
超时时间:3000ms;
备注:如请求超时或其他原因等导致的请求失败,则商家端需发起重试请求,否则订单可能无法正常收发货
应用审核
上线申请审核通过后,自动按照默认规则排序,靠前的应用,会在拼多多管理后台-服务市场-第三方合作软件中展示(商家可以通过拼多多管理后台中的页面,打开软件的官网网址授权并使用该应用)。
授权登录(拼多多)
应用和拼多多开放平台对接时需要获取用户隐私数据(如商品-订单等),为保证用户数据的安全与隐私,您的应用需要取得用户的授权,即获取访问用户数据的授权令牌 access_token 。这种情况下,您的应用需要引导用户完成使用拼多多帐号“登录授权”的流程。该流程采用国际通用的OAuth2.0标准协议作为用户身份验证与授权协议,目前拼多多OAuth2.0服务支持采用两种方式获取Access_Token(授权令牌)。
订单同步流程
此接口面向于对订单处理有需求的第三方开发者(ISV)和自研商家,通过此接口可以获取到商家的订单信息。目前订单的类型有定金订单和普通订单。两类订单区别如下图所示:
订单同步方案
获取订单:
获取最新订单请使用pdd.order.number.list.increment.get接口,此接口不仅能够获取到新生成的订单,还可以获取到所有字段有更新的订单,此接口在使用时需要不停地轮询查询以获取最新的订单详情。查询的页码可以通过返回的订单总数除以自己设置的page_size获得。
获取部分订单:
a) 调用pdd.order.list.get根据成团时间查询订单详情;
b) 调用pdd.order.number.list.get查询待发货并且无售后或者售后关闭的订单;
获取单个订单:
a) 调用pdd.order.status.get查询单个订单状态;
b) 调用pdd.order.information.get查询单个订单详情;
物流单号回传:
a) 当卖家完成发货时,需要通过pdd.erp.order.sync接口来告知平台已发货。