订单推送回调接口
订单回推接口,用于将订单状态变更信息实时推送给合作媒体方。
📍 回调地址仅支持 80 / 443 端口 请求方式 POST Content-Type application/json

请求参数(入参)

接口请求 Body(JSON 结构)

参数名称类型是否必填描述
smsTitle String 非必填 订单标题
quantity String 必填 订单数量
orderId String 必填 订单 ID
dealId String 非必填 店铺 ID(部分存在)
payTime String 非必填 订单支付时间,10 位时间戳
actId Integer 非必填 活动 ID,可以在联盟活动列表中查看获取
businessLine Integer 必填 业务线类型
2 · 到家_外卖&闪购&美团电商&拼好饭&买菜3 · 酒店9 · 到店美食10 · 休闲生活30 · 门票401 · 民宿501 · 度假1005 · 医药1009 · 美团私域
subBusinessLine Integer 非必填 子业务线
1 · 外卖订单2 · 闪购订单3 · 美团电商(团好货)4 · 拼好饭5 · 虚拟券包8 · 买菜
orderTime String 非必填 下单时间,10 位时间戳
sid String 非必填 媒体推广位 sid
appKey String 非必填 媒体名称,可在推广者备案-媒体管理中查询
uid String 必填 媒体 ID
status Integer 必填 订单状态
1 · 外卖闪购为订单已提交;其他业务为订单已付款8 · 已完成9 · 已退款(包括部分退款和全额退款)或风控退
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"
}