订单推送回调接口
订单回推接口,用于将订单状态变更信息实时推送给合作媒体方。
请求参数(入参)
接口请求 Body(JSON 结构)
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| smsTitle | String | 非必填 | 订单标题 |
| quantity | String | 必填 | 订单数量 |
| orderId | String | 必填 | 订单 ID |
| dealId | String | 非必填 | 店铺 ID(部分存在) |
| payTime | String | 非必填 | 订单支付时间,10 位时间戳 |
| actId | Integer | 非必填 | 活动 ID,可以在联盟活动列表中查看获取 |
| businessLine | Integer | 必填 | 业务线类型 |
| subBusinessLine | Integer | 非必填 | 子业务线 |
| orderTime | String | 非必填 | 下单时间,10 位时间戳 |
| sid | String | 非必填 | 媒体推广位 sid |
| appKey | String | 非必填 | 媒体名称,可在推广者备案-媒体管理中查询 |
| uid | String | 必填 | 媒体 ID |
| status | Integer | 必填 | 订单状态 |
| total | String | 非必填 | 订单总金额 |
| payPrice | String | 非必填 | 订单实际支付金额 |
| modTime | Integer | 非必填 | 订单修改时间 |
| ratio | String | 非必填 | 订单返佣比例,CPS 活动的订单会返回该字段 |
| sign | String | 非必填 | 订单签名字段,计算方法参见文档中签名(sign)生成逻辑 |
| couponCode | String | 非必填 | 用于区分同一笔订单中的不同券码。外卖券包分销,券实体订单使用的券展示 ID |
| productId | String | 非必填 | 商品 ID |
| productViewSign | String | 非必填 | 商品 ID |
| productName | String | 非必填 | 商品名称 |
| specificationName | String | 非必填 | 规格信息,同一个商品名称下可以包括不同的规格,对应不同的价格和佣金 |
返回参数(出参)
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| errcode | int | 必填 | 响应码 0 · 成功 1 · 失败 |
| errmsg | String | 必填 | 响应文案,成功返回 "ok",失败返回错误描述 |
请求示例
{
"smstitle": "KingCock韩式炸鸡(青年城店)",
"quantity": "1",
"orderid": "929473221550887",
"dealid": "9294732",
"paytime": "1605195127",
"ordertime": "16055127",
"sid": "1079",
"uid": "12456",
"status": "8",
"total": "71.0",
"ratio": "0.03",
"sign": "",
"actId": "2",
"businessLine": "2",
"subBusinessLine": "1",
"appkey": "appkey",
"payPrice": "133.01",
"modTime": "1605195127"
}返回示例
成功响应
{
"errcode": "0",
"errmsg": "ok"
}异常响应
{
"errcode": "1",
"errmsg": "err"
}