logan

Appearance

投诉管理 ​

1. 提交投诉 ​

接口地址：/home/complaint/doComplaint

请求参数：

参数名类型必填说明
trade_noString是订单号
descString是投诉描述

响应示例：

json
{
  "code": 1,
  "msg": "投诉成功！"
}

说明：

  • 只能对已支付的订单发起投诉
  • 投诉描述不能为空
  • 同一订单只能发起一次投诉
  • 投诉提交后会冻结订单资金

2. 获取我的投诉列表 ​

接口地址：/home/complaint/myList

请求参数：

参数名类型必填说明
statusInteger否投诉状态：0-协商中，1-平台介入，2-已完结
pageInteger否页码，默认 1
limitInteger否每页数量，默认 10

响应示例：

json
{
  "code": 1,
  "msg": "获取成功！",
  "data": {
    "list": [
      {
        "id": 1,
        "trade_no": "T202401010001",
        "desc": "投诉描述",
        "status": 0,
        "result": 0,
        "orders": {
          "trade_no": "T202401010001",
          "goods_name": "商品名称",
          "total_price": "10.00"
        },
        "create_at": "2024-01-01 12:00:00"
      }
    ],
    "total": 100
  }
}

字段说明：

  • status：投诉状态
    • 0：协商中
    • 1：平台介入
    • 2：已完结（买家责任）
    • 3：已完结（卖家责任）
  • result：投诉结果
    • 0：未判定
    • 1：卖家责任
    • 2：买家责任

说明：

  • 投诉列表受用户设置的数据时效性限制

  • 列表按创建时间倒序排列

3. 查询投诉详情（通过 ID） ​

接口地址：/home/complaint/detail

请求参数：

参数名类型必填说明
idInteger是投诉 ID

响应示例：

json
{
  "code": 1,
  "msg": "获取成功！",
  "data": {
    "messages": [
      {
        "id": 8,
        "complaint_id": 3,
        "trade_no": "Q251123517bde",
        "from_user_id": 0,
        "from_type": "system",
        "content": "重复",
        "create_at": "2025-11-23 18:07:36"
      },
      {
        "id": 9,
        "complaint_id": 3,
        "trade_no": "Q251123517bde",
        "from_user_id": 0,
        "from_type": "system",
        "content": "平台已介入处理",
        "create_at": "2025-11-23 18:07:51"
      }
    ],
    "order": {
      "id": 12,
      "user_id": 1004,
      "buyer_user_id": 1004,
      "goods_id": 5,
      "trade_no": "Q251123517bde",
      "goods_name": "测试222",
      "quantity": 11,
      "goods_price": "0.900",
      "total_price": "9.450",
      "fee": "0.450",
      "sendout": 11,
      "status": 3,
      "is_freeze": 0,
      "create_at": "2025-11-23 18:01:53",
      "success_at": "2025-11-23 18:02:04",
      "create_ip": "203.160.68.146"
    },
    "complaint": {
      "id": 3,
      "user_id": 1004,
      "source_user_id": 1004,
      "buyer_user_id": 1004,
      "trade_no": "Q251123517bde",
      "desc": "重复",
      "status": 3,
      "create_at": "2025-11-23 18:07:36",
      "create_ip": "203.160.68.146",
      "result": 1,
      "expire_at": "2025-11-24 18:07:36",
      "platform_expire_at": "2025-11-25 18:07:51",
      "platform_intervene_at": "2025-11-23 18:07:51",
      "closed_at": "2025-11-24 14:36:21",
      "is_refunded": 1,
      "refund_at": "2025-11-24 14:36:21",
      "update_at": "2025-11-24 14:36:21",
      "user": {
        "id": 1004,
        "username": "test1004",
        "avatar": "https://q1.qlogo.cn/g?b=qq&nk=4589662&s=640"
      }
    },
    "seller": {
      "id": 1004,
      "username": "test1004",
      "avatar": "https://q1.qlogo.cn/g?b=qq&nk=4589662&s=640"
    }
  }
}

5. 发送投诉消息 ​

接口地址：/home/complaint/send

请求参数：

参数名类型必填说明
idInteger是投诉 ID
contentString是消息内容

响应示例：

json
{
  "code": 1,
  "msg": "发送成功"
}

说明：

  • 只能在投诉状态为"协商中"或"平台介入"时发送消息
  • 投诉已完结后无法发送消息
  • 消息会实时推送给卖家和平台

6. 撤销投诉 ​

接口地址：/home/complaint/cancel

请求参数：

参数名类型必填说明
idInteger是投诉 ID

响应示例：

json
{
  "code": 1,
  "msg": "撤诉成功"
}

说明：

  • 只能在投诉状态为"协商中"时撤销
  • 平台介入后或已完结的投诉无法撤销
  • 撤诉后订单资金会在按原冻结后自动解冻
  • 撤诉后投诉状态变为"已完结（买家责任）"

投诉状态说明 ​

状态值状态名称说明
0协商中买卖双方协商处理
1平台介入平台客服介入处理
2已完结（买家责任）投诉结束，判定买家责任
3已完结（卖家责任）投诉结束，判定卖家责任

投诉结果说明 ​

结果值结果名称说明
0未判定投诉尚未判定结果
1卖家责任判定为卖家责任，订单退款
2买家责任判定为买家责任，资金正常结算

注意事项 ​

  1. 所有投诉相关接口都需要用户登录认证
  2. 只能对已支付的订单发起投诉
  3. 同一订单只能发起一次投诉
  4. 投诉提交后会冻结订单资金，防止卖家提现
  5. 撤诉后资金会在 24 小时后自动解冻
  6. 平台介入后无法撤诉
  7. 投诉消息支持实时推送