订单推送通知

POST

https://open.goofish.pro/order/receive（这里仅做示例）

###请商家自行在闲管家的开放平台填写真实的推送地址###

注意事项：
1：订单信息/订单状态/退款状态发生变更时推送
2：仅推送待发货、已发货、已完成、退款处理中、已退款状态的订单
3：请确保该接口稳定，如果推送失败，最多重试三次
4：只有响应报文的result字段返回success，才认为成功
5：接口请求超时时间为3秒（建议接收到推送通知后，异步处理业务逻辑）

请求参数

Query 参数

appid

integer

必需

开放平台的AppKey

默认值:

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

seller_id

integer <int64>

商家ID

必需

user_name

string

闲鱼会员名

必需

示例值:

tb924343042

order_no

string

闲鱼订单号

必需

示例值:

2226688164543566229

order_type

enum<integer> <int32>

订单类型

必需

枚举值:

123478910

order_status

enum<integer> <int32>

订单状态

必需

枚举值：
11 : 待付款
12 : 待发货
21 : 已发货
22 : 交易成功
23 : 已退款
24 : 交易关闭

枚举值:

111221222324

refund_status

enum<integer> <int32>

退款状态

必需

枚举值：
0 : 未申请退款（表示买家没有申请退款）
1 : 待商家处理（买家已经申请退款，等待卖家同意）
2 : 待买家退货（卖家已经同意退款，等待买家退货）
3 : 待商家收货（买家已经退货，等待卖家确认收货）
4 : 退款关闭（买家取消退款/超时未处理自动关闭）
5 : 退款成功（卖家同意退款/超时未处理自动退款）
6 : 已拒绝退款（卖家拒绝退款）
8 : 待确认退货地址（等待卖家确认退货地址）

枚举值:

01234568

默认值:

modify_time

integer

订单更新时间

必需

示例值:

1636077365

示例

{
  "order_no": "1339920336328048683",
  "order_status": 11,
  "refund_status": 1,
  "modify_time": 1636013302
}

返回响应

🟢200成功

application/json

Body

result

enum<string>

结果

必需

枚举值:

success

msg

string

描述

必需

示例值:

接收成功

示例

{
  "result": "success",
  "msg": "接收成功"
}

🟢200异常

修改于 2024-05-31 10:34:59

商品推送通知

查询快递公司