Skip to content

二、订单查询接口(推荐使用订单状态回调接口)

2.1 接口请求

  • 请求方式:Post
  • 接收类型:form-data
  • 调用频率说明
    • 建议每个订单每天调用次数不超过10次,如果调用频率太大占用资源,我方将进行拦截(每分钟不能超过200次)。
    • 已撤单、审核不通过、已取消、已结算、无法结算,接口返回这5个状态之后,请不要继续再调用查询接口,因为后续订单状态不会再有变化。

2.2 接口地址

https://haokaopenapi.lot-ml.com/api/order/GetOrderInfo

2.3 请求参数

参数名称类型是否必填说明
user_idStringY代理在172号卡登录账号。
TimestampStringY时间戳(长度10位,且与服务器时间不能超过5分钟)。
DownOrderIDStringY下游订单id(对接接口方订单ID),不能重复。
user_signStringYmd5加密是32小写;
Md5("DownOrderID=" + DownOrderID + "&Timestamp=" + Timestamp + "&user_id=" + user_id + secret)
Secret(秘钥)追加最后即可,前边参数需要进行自然排名
java的md5加密结果可能有偏差,具体可以用这个网站的加密结果对比 https://md5jiami.bmcx.com/

2.4 参数返回

2.4.1 成功返回

json
{
  "data": {
    "orderNo": "mlkj230412165954****",
    "downOrderNo": "4278****",
    "name": "田**",
    "expressName": "京东",
    "expressCode": "JDV01098242****",
    "orderStatus": "已发货",
    "createTime": "2023-04-12 16:59:54",
    "thirdPhone": "1309554****",
    "remark": "[已发货]",
    "cardStatus": "未激活",
    "activationTime": "",
    "isFirstCharge": "0",
    "firstCharge": ""
  },
  "code": 0,
  "message": "成功",
  "errs": null
}

2.4.2 错误返回

json
{
  "code": -1,
  "message": "订单不存在",
  "errs": null
}

2.5 订单状态说明

  • 待处理:下单成功,我方尚未提交给运营商。
  • 已提运营商:我方已提运营商。
  • 已发货:运营商已发货。
  • 已完成:这个状态可以按照已发货处理,不是所有订单都有这个状态。
  • 已撤单:我方提运营商失败。
  • 审核不通过:运营商审核失败或用户取消订单。
  • 已取消:用户取消订单。
  • 已结算:订单已结算,佣金已到代理账户。
  • 无法结算:未满足结算要求,结算失败。