一、订单如何推送

1、什么是订单推送

Linkbest 支持将媒体伙伴推广效果订单主动推送至媒体伙伴平台。

2、填写推送地址

媒体伙伴接入 Linkbest 后，在 Linkbest 网站填写 “订单推送地址”。 登录 Linkbest，我的工具-》postback 中对推送地址进行配置，推送状态变更为 Running 时，代表 Linkbest 正在对目标地址推送数据。

校验说明：提交地址时， Linkbest 会做一次测试推送来验证接口。推送接口需返回 1、0 表示接收到测试数据，-1 表示未接收到测试数据。详细说明

3、配置推送事件

地址配置完成后，媒体伙伴可根据需求添加事件，Linkbest 会将已添加事件的相关数据推送至目标地址。

4、注意事项

Linkbest 会定期对地址进行校验，若地址连续异常响应超过 3 次，将会通过邮件的方式通知用户对地址进行检查。若 7 天内目标地址未恢复正常响应，推送状态将变更为 Stopped。

Linkbest 主动推送订单的状态包括：待处理，已确认、已结算、无效，当以上几种状态发生时会主动推送给媒体伙伴平台。

Linkbest 订单的 已确认、已结算、无效 这三个状态 目前都是通过在 Linkbest 完成 结算流程 时才会对订单标记已确认、已结算、无效。

如果媒体伙伴需要 电商平台原始订单状态（创建、付款、退货等状态），请使用 Linkbest 订单详情查询 API。目前支持实时订单状态更新的商家才会有状态更新 ，比如京东、淘宝。

二、推送数据

Linkbest 会向推送地址发起 POST 请求，并将订单数据以 JSON Body方式发送。每次推送 1 个订单，同时会在参数中增加推送校验参数 Sign,说明见下文。

1、推送参数说明

参数全部为大驼峰字符，参数值为 UTF8 编码

2、接收请求安全校验说明

数据体内的数据根据事件类型发生变化，其他参数固定。对于接收方，我们建议校验 sign 值，校验逻辑及代码示例如下：

md5($token . $eventType .$pushId. $crateTime)

PHP 代码示例：

$requestSign = $body['Sign'];

// Postback token
$computedSign = md5($token.$body['EventType'].$body['PushId'].$body['CrateTime']);


//如果 $computedSign == $requestSign 即为合法的推送

3、订单推送数据返回机制

如推送地址测试通过，在产生推广效果订单后，Linkbest 将实时推送订单数据（部分特殊商家不支持实时返单，如次日返单、隔 1 小时返单等，可咨询对接媒介）。

默认推送超时时间为 10s ， 如推送失败，Linkbest 重试推送。重试间隔依次为：60s、 300s、 600s、1800s 。

订单推送不包含订单商品明细信息，如需订单商品明细可以再发起 “订单详情明细查询”请求。

三、接收请求后的响应要求

http 状态码响应 200 推送成功的话，请接收方输出如下值 ： 1 表示 推送成功，并且订单已成功入库。 0 表示 推送成功，但订单已存在。 -1 表示 推送失败。

如果接收方没有反馈任何数据，我们也认为是推送失败。

四、推送接口的测试推送

为了审核填写接口的有效性，我们在审核时，会构造一次测试推送，推送的数据如下：

接收到如上信息，请通过接口输出 0 或者 1。默认情况下，接口没有收到数据，直接访问 请输出 -1 。