诺云开放平台

Appearance

退款订单列表 ​

历史版本 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Order/getRefundList/2.0.0
  • 频率限制：10秒1000次

请求参数 ​

参数必选类型描述
page是integer第几页（最小值1）
page_size是integer一页显示多少（最小值1，最大值100）
wechat_user_space_id否integer用户ID
status否integer状态：1:待商家处理 2：退款成功 3：退款关闭 4：商家同意，等待买家上传物流单号 5：待商家收货 6：商家拒绝退款申请，待买家处理 7 待买家处理（包含4跟6） 8：商家拒绝收货，待买家处理 9:退款中
order_id否integer订单ID
order_sn否string订单编号（目前order_sn只针对部分UID开放）
merchant_refund_job_status否integer平台介入处理状态：1--未介入，2--介入中，3--介入结束
create_time_start否integer创建时间（开始，时间戳10位秒级）
create_time_end否integer创建时间（结束，时间戳10位秒级）
update_time_start否integer更新时间（开始，时间戳10位秒级）
update_time_end否integer更新时间（结束，时间戳10位秒级）
default_sort否integer排序 1：正序 2：倒叙

请求示例 ​

示例1：获取所有退款订单

json
{
    "page": 1,
    "page_size": 10
}

示例2：按状态筛选退款订单

json
{
    "page": 1,
    "page_size": 20,
    "status": 2,
    "default_sort": 2
}

示例3：按时间范围筛选退款订单

json
{
    "page": 1,
    "page_size": 15,
    "create_time_start": 1640995200,
    "create_time_end": 1643673600,
    "default_sort": 2
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object退款订单数据

data 参数结构 ​

参数必选类型描述
total是integer退款订单总量
list是array退款订单列表

list 参数结构 ​

参数必选类型描述
id是integer退款订单ID
wechat_user_space_id是integer买家ID
buyer_name是string买家昵称
goods_id是integer商品ID
order_id是integer订单ID
order_sn是string订单编号
order_goods_id是integer子订单ID
refund_source是integer退款类型：1-买家申请，2-商家退款，3-系统退款
refund_no是string退款单号
refund_money是number退款金额
create_time是integer退款申请时间
refund_type是integer退款方式（1-仅退款，2-退货退款）
reason是string退款申请原因
phone是string退款申请手机号
remark是string退款申请说明
refund_time是integer退款完成时间
status是integer记录状态：1--待商家处理，2--退款成功，3--退款关闭，4--待买家发货，5--待商家收货，6--待买家确认
merchant_refund_job_status是integer平台介入处理状态：1--未介入，2--介入中，3--介入结束
update_at是string更新时间

响应示例 ​

成功响应示例

json
{
    "code": 200,
    "msg": "Success",
    "data": {
        "total": 2,
        "list": [
            {
                "id": 1001,
                "wechat_user_space_id": 123456789,
                "buyer_name": "用户A",
                "goods_id": 10001,
                "order_id": 20001,
                "order_goods_id": 30001,
                "refund_source": 2,
                "refund_no": "RF202501010001",
                "refund_money": 99.00,
                "create_time": 1640995200,
                "refund_type": 1,
                "reason": "商品质量问题",
                "phone": "138****8888",
                "remark": "商品有破损",
                "refund_time": 1640995260,
                "status": 2,
                "merchant_refund_job_status": 1,
                "update_at": "2022-01-01 10:00:00",
                "order_sn": "ORD202501010001",
            },
            {
                "id": 1002,
                "wechat_user_space_id": 987654321,
                "buyer_name": "用户B",
                "goods_id": 10002,
                "order_id": 20002,
                "order_goods_id": 30002,
                "refund_source": 1,
                "refund_no": "RF202501010002",
                "refund_money": 199.00,
                "create_time": 1640995200,
                "refund_type": 2,
                "reason": "拍错/多拍/不想要",
                "phone": "139****9999",
                "remark": "尺寸不合适",
                "refund_time": 1640995260,
                "status": 1,
                "merchant_refund_job_status": 1,
                "update_at": "2022-01-01 10:00:00",
                "order_sn": "ORD202501010002",
            }
        ]
    }
}

搜索无结果示例

json
{
    "code": 200,
    "msg": "Success",
    "data": {
        "total": 0,
        "list": []
    }
}

错误响应示例

json
{
    "code": 400,
    "msg": "请选择第几页",
    "data": {}
}

状态码说明 ​

状态码描述
200成功
400失败

使用说明 ​

  1. 该接口用于获取退款订单列表，支持多种筛选条件
  2. 支持按状态、时间范围、用户ID等条件进行筛选
  3. 返回的退款订单信息包含完整的退款流程数据
  4. 可通过default_sort参数控制排序方式
  5. 接口需要有效的认证信息才能调用