查询退单

接口说明

按订单号或售后单号查询退单记录，覆盖全部业态。数据与运营后台「售后订单」列表一致，来自订单中心，状态可能比实际晚几秒。

取消预约产生的记录不在本接口的返回范围内。

接口编码：operator.order.refund.query

请求的加密、签名和响应解密规则见「接入说明与返回码」。

请求业务字段

以下为加密前的业务参数，序列化为 JSON 字符串并加密后填入外层 body。

字段	类型	必填	说明
`orderNo`	string	否	平台订单号，精确匹配
`refundNo`	string	否	平台售后单号，精确匹配

orderNo 和 refundNo 至少传一个；同时传时两个条件都要满足。

请求业务示例

{
  "orderNo": "2026102010340201025147"
}

响应业务字段

响应体解密后为统一结构 {code, msg, data, ok}。data 为退单记录数组，按申请时间倒序，最多 200 条；没有退单记录时为空数组 []。数组元素：

字段	类型	说明
`refundNo`	string	平台售后单号
`outRefundNo`	string	商家退款单号（通过「申请退单」传入并被业态记录时有值）
`orderNo`	string	平台订单号
`outOrderNo`	string	商家订单号
`businessType`	string	业态类型，取值同「查询订单」
`productCode`	string	产品编码
`productName`	string	产品名称
`refundStatus`	string	退单状态：`PROCESSING` 处理中、`SUCCESS` 退款成功、`FAILED` 退款失败（由 `afterStatus` 归一：`COMPLETE` → `SUCCESS`，`CLOSE` → `FAILED`，其余 → `PROCESSING`）
`afterStatus`	string	售后状态：`WAIT_REVIEW` 待审核、`WAIT_SUPPLIER_CONFIRM` 待供应商确认、`REFUND_PROCESSING` 退款处理中、`SUPPLIER_REFUSE` 供应商拒绝、`CLOSE` 售后关闭、`COMPLETE` 售后完成。`COMPLETE` 和 `CLOSE` 是终态
`approvalStatus`	string	审核状态，如 `NO_NEED_REVIEW` 无需审核、`APPROVED` 审核通过
`refundPayStatus`	string	退款状态：`NOT_REFUND` 无需退款、`WAIT_REFUND` 待退款、`REFUND_ING` 退款中、`REFUND_SUCCESS` 退款成功、`REFUND_FAILED` 退款失败、`REFUND_CLOSED` 退款关闭。尚未进入退款环节时可能为 `null`
`refundType`	string	退款类型：`CHECK_BEFORE_REFUND` 核销前退、`CHECK_AFTER_REFUND` 核销后退、`FORCED_REFUND` 强制退
`refundQuantity`	integer	退单数量
`refundAmount`	string	退款金额，单位分
`initiatorType`	string	退单发起方，如 `PLATFORM_CUSTOMER_SERVICE` 平台客服、`CUSTOMER` 客户、`SUPPLY` 供应商
`initiatorName`	string	退单申请人
`refundTime`	string	退单申请时间

响应示例（解密后）

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "refundNo": "R202611112058595252",
      "outRefundNo": null,
      "orderNo": "2026102010340201025147",
      "outOrderNo": null,
      "businessType": "TICKET",
      "productCode": "TK0120261020094956000001",
      "productName": "成人门票",
      "refundStatus": "SUCCESS",
      "afterStatus": "COMPLETE",
      "approvalStatus": "NO_NEED_REVIEW",
      "refundPayStatus": "REFUND_SUCCESS",
      "refundType": "CHECK_BEFORE_REFUND",
      "refundQuantity": 1,
      "refundAmount": "100",
      "initiatorType": "PLATFORM_CUSTOMER_SERVICE",
      "initiatorName": "张三",
      "refundTime": "2026-11-11 20:58:59"
    }
  ],
  "ok": true
}

业务错误

业务校验不通过时 code 非 0，msg 为具体原因。返回码含义见「接入说明与返回码」第 9.2 节，下游业态服务给出的返回码原样透出：

code	msg	说明
`1021`	订单号、退单号至少传一个	`orderNo` 和 `refundNo` 都未传
`1031`	该接口仅支持运营平台操作员调用	应用实例绑定的不是运营平台操作员
`1020`	业务参数格式有误，必须为JSON对象	业务参数不是 JSON 对象，或字段类型不对

{
  "code": 1021,
  "msg": "订单号、退单号至少传一个",
  "data": null,
  "ok": false
}

application/json

响应体为 Base64 密文，用 aesKey 解密后得到统一响应 OpenResponse，data 的结构如下；被网关拒绝时为明文 JSON，见「接入说明与返回码」

Bodyapplication/json

示例

{
    "code": 0,
    "msg": null,
    "data": [
        {
            "refundNo": "R202611112058595252",
            "outRefundNo": null,
            "orderNo": "2026102010340201025147",
            "outOrderNo": null,
            "businessType": "TICKET",
            "productCode": "TK0120261020094956000001",
            "productName": "成人门票",
            "refundStatus": "SUCCESS",
            "afterStatus": "COMPLETE",
            "approvalStatus": "NO_NEED_REVIEW",
            "refundPayStatus": "REFUND_SUCCESS",
            "refundType": "CHECK_BEFORE_REFUND",
            "refundQuantity": 1,
            "refundAmount": "100",
            "initiatorType": "PLATFORM_CUSTOMER_SERVICE",
            "initiatorName": "张三",
            "refundTime": "2026-11-11 20:58:59"
        }
    ],
    "ok": true
}

接口说明

请求业务字段

请求业务示例

响应业务字段

响应示例（解密后）

业务错误

请求参数

请求示例代码

返回响应

查询退单

接口说明#

请求业务字段#

请求业务示例#

响应业务字段#

响应示例（解密后）#

业务错误#

请求参数

请求示例代码

返回响应

接口说明

请求业务字段

请求业务示例

响应业务字段

响应示例（解密后）

业务错误