售后消息推送

API文档最后更新: 2026-08-23

9.4 售后消息推送

商户或平台新增一条第三方可以查看的售后消息时发送 aftersale.message.created。该消息同时携带售后当前状态和售后类型，不再另外发送售后状态通知。第三方通过追加售后消息接口提交的内容不会再回推给第三方。售后关联订单填写过 orderCallbackUrl 时发送到该订单地址；未填写时，在本条消息生成时读取当时的账户默认回调地址。售后接口不接收单独的回调地址。

{
  "eventId": "aftersale.message.created:aftersale-message:20001:501",
  "eventType": "aftersale.message.created",
  "occurredAt": 1785216021,
  "platformCaseRef": "CP202607290001",
  "clientOrderRef": "PO-20260728-0001",
  "caseState": "handling",
  "issueType": "not_received",
  "revision": 1753775900,
  "message": {
    "messageRef": 501,
    "authorRole": "merchant",
    "format": "text",
    "body": "已收到，正在核查。",
    "createdAt": 1785216021
  }
}

aftersale.message.created 顶层字段：

字段

JSON 类型

必填

含义

eventId

string

是

本次消息编号；第三方按该编号防止重复追加消息

eventType

string

是

固定为 aftersale.message.created

occurredAt

integer

是

售后消息产生时间，10 位 Unix 秒级时间戳

platformCaseRef

string

是

平台售后编号

clientOrderRef

string

是

售后关联的第三方订单号

caseState

string

是

售后当前状态：submitted 已提交；handling 处理中；resolved 已处理完成；closed 已关闭

issueType

string

是

当前售后类型

revision

integer

是

售后最后更新时间，10 位 Unix 秒级时间戳

message

object

是

本次新增的售后消息

message 字段：

字段

JSON 类型

必填

含义

messageRef

integer

是

售后消息编号

clientMessageRef

string

否

本事件不返回该字段

authorRole

string

是

固定为 merchant，表示商户或平台回复

format

string

是

text 文字消息；image 公网 HTTPS 图片地址

body

string

是

消息正文；图片消息时是公网 HTTPS 图片地址

createdAt

integer

是

消息创建时间，10 位 Unix 秒级时间戳

售后消息只包含第三方可以查看的正文和 HTTPS 附件地址。三次发送都失败后，可以查询售后详情。

上一篇