| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| app_key | Long | 是 | 接入时申请的app_key |
| method | String | 是 | 接口名称 |
| access_token | String | 是 | Oauth2.0授权获得的access_token |
| sign | String | 是 | 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序 |
| timestamp | Long | 是 | 时间戳，使用Unix时间戳格式 |
| format | String | 是 | 响应格式。默认为json格式，固定 |
| sign_method | String | 否 | 参数的加密方法选择，当前只支持Md5 |
| version | String | 否 | API协议版本，固定值为：1.0 |
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| refundListQueryReq | Object | 是 | 请求参数对象 | |
| queryStatus | String | 否 | * query_refund_or_return_all：全部状态(不包含已取消的退款订单) * query_refund_or_return_all_for_openapi：全部状态(包含已取消的退款订单) * query_return_goods_requested：买家发起退货，等待卖家同意 * query_return_goods_agreed：卖家同意，等待买家退货 * query_return_goods_shipped： 买家发货，等待卖家收货 * query_refund_requested：买家发起退款，等待卖家同意 * query_refund_completed：退款完成 * query_refund_or_return_seller_refused：买家退款或退货或发货被卖家拒绝 | |
| refundType | String | 是 | query_refund_type_all -全部类型（退款、退货、退到官方）； query_return_goods - 退货退款； query_refund_money - 仅退款； | |
| startCreated | String | 否 | * 退款订单创建时间开始，2016-06-01 00:00:00 | |
| endCreated | String | 否 | * 退款订单创建时间结束：2016-06-11 00:00:00 | |
| startUpdated | String | 否 | * 退款订单更新时间开始：2016-06-01 00:00:00 | |
| endUpdated | String | 否 | * 退款订单更新时间结束：，2016-06-11 00:00:00 | |
| page | String | 否 | 页码，默认为1 | |
| pageSize | String | 否 | 每页返回记录条数，最大为20 | |
| userId | Number | 否 | 商家用户ID |
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| status | String | 状态 | |
| code | String | 状态码， 0000000-表示调用成功 | 0000000 |
| msg | String | 状态提示，比如调用成功 | 调用成功 |
| result | Object | 返回结果 | |
| data | Object | 结果数据 | |
| hasNext | Boolean | 是否还有数据未返回，true-可继续下一页查询； false-没有后续数据 | true |
| refundFullDTOList | Object | 退款数据对象 | |
| buyerName | String | 买家昵称 | 开心麻麻 |
| createdStr | String | 创建时间 yyyy-mm-dd hh:mm:ss | 2019-06-02 10:30:05 |
| expense | String | 退款金额 | |
| goodsPrice | String | 商品订单货款总额 nowPrice*num | |
| itemId | String | 商品id | |
| itemOrderId | String | 商品级订单id | |
| nowPrice | String | 商品折扣后的价格(分) | |
| number | Number | 商品数量 | |
| orderStatus | String | 订单状态 | |
| price | String | price(分) | |
| reason | String | 申请原因 | |
| refundDescription | String | 买家退款描述 | |
| refundId | String | 退款id | |
| refundShipInfo | Object | 退货地址/物流信息 | |
| province | String | 省 | |
| city | String | 市 | |
| area | String | 区 | |
| street | String | 街道 | |
| address | String | 街道地址 | |
| description | String | 描述 | |
| zip | String | 邮编 | |
| name | String | 收件人姓名 | |
| mobile | String | 收件人手机号 | |
| shipTime | String | 发货时间 | |
| shipExpressName | String | 物流名称 | |
| shipExpressId | String | 物流编号 | |
| refundType | String | 类型:退货/退款 | |
| shopOrderId | String | 店铺级订单id | |
| status | String | 退款状态 | |
| timeLines | Object[] | 操作记录 | |
| actionName | String | 操作类型描述 | |
| actionType | String | 操作类型code | |
| createdStr | String | 创建时间 | |
| showContent | String[] | 操作日志内容 | |
| updatedStr | String | 修改时间 | |
| refundCashExpense | Number | 退款现金金额(单位:分) | |
| refundShipExpense | Number | 退款运费金额(单位:分) |