二、订单查询接口(推荐使用订单状态回调接口)
2.1 接口请求
- 请求方式:Post
- 接收类型:form-data
- 调用频率说明:
- 建议每个订单每天调用次数不超过10次,如果调用频率太大占用资源,我方将进行拦截(每分钟不能超过200次)。
- 已撤单、审核不通过、已取消、已结算、无法结算,接口返回这5个状态之后,请不要继续再调用查询接口,因为后续订单状态不会再有变化。
2.2 接口地址
https://haokaopenapi.lot-ml.com/api/order/GetOrderInfo
2.3 请求参数
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
user_id | String | Y | 代理在172号卡登录账号。 |
Timestamp | String | Y | 时间戳(长度10位,且与服务器时间不能超过5分钟)。 |
DownOrderID | String | Y | 下游订单id(对接接口方订单ID),不能重复。 |
user_sign | String | Y | md5加密是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 订单状态说明
- 待处理:下单成功,我方尚未提交给运营商。
- 已提运营商:我方已提运营商。
- 已发货:运营商已发货。
- 已完成:这个状态可以按照已发货处理,不是所有订单都有这个状态。
- 已撤单:我方提运营商失败。
- 审核不通过:运营商审核失败或用户取消订单。
- 已取消:用户取消订单。
- 已结算:订单已结算,佣金已到代理账户。
- 无法结算:未满足结算要求,结算失败。