10、订单回调通知

创建于 2025-04-08 / 最近更新于 2025-08-18 / 384

字体： [默认] [大] [更大]

接口说明：
下单成功且所使用的 APPID 已配置回调地址后，系统将向配置的回调地址发送通知。回调地址可在会员中心 > 开放平台 > API 对接 > 操作中进行配置。如有任何疑问，请联系商家客服。
注意：
当前系统仅会进行单次回调请求，不会重复发起回调请求。

请求参数

参数	是否必填	类型	描述
order_number	是	Number	订单号
status	是	Number	订单状态 2-未发货 3-发货中 4-已完成 5-发货中 6-退款
cus_order_no	是	String	客户系统订单号
time	是	String	10位当前时间戳，间隔上下不低于120秒
count	是	Number	购买数量
price	是	Number	成交单价
name	是	String	产品名称
express_company	否	String	快递公司（good_type为3时可能返回）
express_num	否	String	快递单号（good_type为3时可能返回）
cards	否	Array	卡券
yqy_return_money	否	Number	退款金额(订单退款且未完全退款会返回此金额)
sign	是	String	签名，规则参照签名规则

请求示例

{
    "status": 4,
    "order_number": "xxx",
    "cus_order_no": "xxxx",
    "time": "1699946874",
    "count": 1,
    "price": "0.03",
    "name": "xxx",
    "express_company": "京东快递",
    "express_num": "333333333",
    "cards":["66666"],
    "sign": "签名内容，请阅读签名方法"
}

更新：2025.6.9 新增cards 卡券字段，卡券订单成功或处理中状态下会返回。
更新：2025.8.18 新增参数 yqy_return_money 退款金额字段，上游未全部退款将会返回上游退款的具体金额，未返回此字段或此字段为空，订单是已退款状态代表全部退款。

2 人点赞过