退款管理接口用于处理商户系统与电商平台之间的退款申请和退款处理流程。

请求参数

响应参数

list数组中每个对象结构：

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 35,
    "pages": 2,
    "list": [
      {
        "refund_id": "RF10001",
        "order_code": "ORD20230601123456",
        "refund_amount": 56.80,
        "refund_type": 1,
        "refund_reason": "不想要了",
        "status": 0,
        "user_id": "U100232",
        "apply_time": 1623126000000,
        "update_time": 1623126000000
      },
      {
        "refund_id": "RF10002",
        "order_code": "ORD20230602123456",
        "refund_amount": 128.50,
        "refund_type": 2,
        "refund_reason": "商品质量问题",
        "status": 1,
        "user_id": "U100233",
        "apply_time": 1623212400000,
        "update_time": 1623216000000
      }
    ]
  },
  "timestamp": 1623123456789
}

请求参数

响应参数

items数组中每个对象结构：

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "refund_id": "RF10001",
    "order_code": "ORD20230601123456",
    "refund_amount": 56.80,
    "refund_type": 1,
    "refund_reason": "不想要了",
    "refund_desc": "请尽快处理",
    "status": 0,
    "user_id": "U100232",
    "user_name": "张三",
    "user_phone": "13800138000",
    "apply_time": 1623126000000,
    "update_time": 1623126000000,
    "handle_time": null,
    "handle_note": null,
    "reject_reason": null,
    "refund_images": [
      "https://example.com/images/refund1.jpg",
      "https://example.com/images/refund2.jpg"
    ],
    "items": [
      {
        "item_id": "I10001",
        "sku_code": "SP123456",
        "product_name": "有机草莓",
        "product_image": "https://example.com/images/strawberry.jpg",
        "quantity": 2,
        "price": 29.90,
        "total_amount": 59.80,
        "reason": "不想要了"
      }
    ]
  },
  "timestamp": 1623123456789
}

请求参数

响应参数

请求示例

{
  "refund_id": "RF10001",
  "handle_note": "同意退款",
  "actual_refund_amount": 56.80
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "refund_id": "RF10001",
    "status": 1,
    "update_time": 1623128000000
  },
  "timestamp": 1623123456789
}

请求参数

响应参数

请求示例

{
  "refund_id": "RF10001",
  "reject_reason": "商品已使用，不符合退款条件",
  "handle_note": "客户已使用商品"
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "refund_id": "RF10001",
    "status": 2,
    "update_time": 1623128000000
  },
  "timestamp": 1623123456789
}

请求参数

响应参数

progress_nodes数组中每个对象结构：

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "refund_id": "RF10001",
    "status": 5,
    "refund_amount": 56.80,
    "actual_refund_amount": 56.80,
    "apply_time": 1623126000000,
    "handle_time": 1623128000000,
    "refund_time": 1623129600000,
    "progress_nodes": [
      {
        "node_time": 1623126000000,
        "node_status": 0,
        "node_desc": "用户申请退款",
        "operator": "张三",
        "operator_role": "用户",
        "remarks": "不想要了"
      },
      {
        "node_time": 1623128000000,
        "node_status": 1,
        "node_desc": "商户同意退款",
        "operator": "商户客服",
        "operator_role": "商户",
        "remarks": "同意退款"
      },
      {
        "node_time": 1623128600000,
        "node_status": 4,
        "node_desc": "退款处理中",
        "operator": "系统",
        "operator_role": "系统",
        "remarks": "正在处理退款"
      },
      {
        "node_time": 1623129600000,
        "node_status": 5,
        "node_desc": "退款成功",
        "operator": "系统",
        "operator_role": "系统",
        "remarks": "退款已成功到账"
      }
    ]
  },
  "timestamp": 1623123456789
}

请求参数

响应参数

refund_type_stats对象结构：

refund_reason_stats数组中每个对象结构：

details数组中每个对象结构（按天/月统计时）：

details数组中每个对象结构（按门店统计时）：

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total_refund_count": 58,
    "total_refund_amount": 4932.50,
    "refund_rate": 0.043,
    "pending_count": 5,
    "approved_count": 50,
    "rejected_count": 3,
    "refund_type_stats": {
      "refund_only_count": 40,
      "refund_only_amount": 3500.20,
      "return_refund_count": 18,
      "return_refund_amount": 1432.30
    },
    "refund_reason_stats": [
      {
        "reason": "商品质量问题",
        "count": 25,
        "amount": 2150.50,
        "percentage": 0.43
      },
      {
        "reason": "不想要了",
        "count": 18,
        "amount": 1520.80,
        "percentage": 0.31
      },
      {
        "reason": "发错商品",
        "count": 10,
        "amount": 986.50,
        "percentage": 0.17
      },
      {
        "reason": "其他原因",
        "count": 5,
        "amount": 274.70,
        "percentage": 0.09
      }
    ],
    "details": [
      {
        "date": "2023-06-01",
        "refund_count": 12,
        "refund_amount": 1028.50,
        "refund_rate": 0.038
      },
      {
        "date": "2023-06-02",
        "refund_count": 15,
        "refund_amount": 1342.80,
        "refund_rate": 0.045
      },
      {
        "date": "2023-06-03",
        "refund_count": 18,
        "refund_amount": 1486.20,
        "refund_rate": 0.052
      },
      {
        "date": "2023-06-04",
        "refund_count": 13,
        "refund_amount": 1075.00,
        "refund_rate": 0.037
      }
    ]
  },
  "timestamp": 1623123456789
}

请求参数

items数组中每个对象结构：

响应参数

请求示例

{
  "timestamp": 1623129600000,
  "sign": "abcdef1234567890",
  "merchant_id": "M10001",
  "refund_id": "RF10001",
  "order_code": "ORD20230601123456",
  "status": 5,
  "refund_amount": 56.80,
  "refund_time": 1623129600000,
  "refund_channel": "ALIPAY",
  "channel_refund_no": "2023060122001012345678901",
  "fail_reason": null,
  "items": [
    {
      "item_id": "I10001",
      "sku_code": "SP123456",
      "quantity": 2,
      "refund_amount": 59.80
    }
  ]
}

响应示例

{
  "code": 200,
  "message": "success"
}