拼多多平台全面API接口对接

对接流程（支持虚拟商品）

      

拼多多与商家之间数据双向请求，同步更新及相关数据传输。对接主要分为三大部分：准备阶段、对接测试、上线使用；针对每部分具体说明如下：

接口连通性测试重点关注两类接口的连通性：一类拼多多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接口来告知平台已发货。