## 获取我的退款列表信息(myRefundList) >[info] 场景说明:买家提交退款申请后,可以查看所有申请的退款列表记录,此处的退款列表并非只有购物订单的退款,也会包括比如充值的退款,购买营销工具的退款等,退款类型根据bizIdentity来判定 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/my/refund/list ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | queryitem | boolean | 可选 | 是否获取退款商品信息,当订单业务类型为普通购物订单时(即:bizIdendity="trade10001")该值才有效。默认值:false | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "token": "t9oplk489djhn27ebh489kme37yh32j3", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "queryitem": true } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 退款列表 | | └ pagination | array | 必须 | 分页信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | refund\_id | integer | 必须 | 退款ID(自增型) | | refund\_sn | string | 必须 | 退款编号 | | title | string | 必须 | 退款标题 | | total\_fee | decimal | 必须 | 最多可退款总额(商品金额+运费金额) | | refund\_total\_fee | decimal | 必须 | 买家申请的退款总额 | | buyer\_id | integer | 必须 | 买家ID | | buyer\_name | string | 必须 | 买家用户名 | | seller\_id | integer | 必须 | 卖家ID | | seller\_name | string | 必须 | 卖家用户名 | | status | string | 必须 | 退款状态,请参考:[退款状态码](response-code.md) | | intervene | integer | 必须 | 是否已申请平台客服介入处理,0=否,1=是 | | created | string | 必须 | 退款申请时间,格式为:yyyy-mm-dd hh::ii::ss | | end\_time | string | 可选 | 退款完成(关闭)时间,格式为:yyyy-mm-dd hh::ii::ss | | bizIdentity | string | 必须 | 订单业务类型,具体参考:[订单业务类型代码](order-code.md) | | bizOrderId | string | 必须 | 商户订单号 | | order\_id | integer | 可选 | 订单ID,当订单业务类型为普通订单时(即:bizIdentity="trade10001"),该项必填 | | order\_sn | string | 可选 | 订单编号 ,当订单业务类型为普通订单时(即:bizIdentity="trade10001"),该项必填 | | store\_name | string | 可选 | 卖家店铺名,当订单业务类型为普通订单时(即:bizIdentity="trade10001"),该项必填 | | \+ items | list | 可选 | 可选 ,当订单业务类型为普通订单时(即:bizIdentity="trade10001"),该项必填 | | └ goods\_id | integer | 必须 | 商品ID | | └ goods\_name | string | 必须 | 商品名称 | | └ spec\_id | integer | 必须 | 商品规格ID(SKUID) | | └ specification | string | 可选 | 商品规格组合 | | └ price | decimal | 必须 | 商品价格 | | └ quantity | integer | 必须 | 购买数量 | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data":{ "refund_id":123, "refund_sn":"202008181750116520", "title":"三星(SAMSUNG)UA55MUF30ZJXXZ 55英寸 4K超高清 智能网络 液晶平板电视 黑色", "total_fee":2999.00, "refund_total_fee":6.00, "buyer_id":3, "buyer_name": "buyer", "seller_id":2, "seller_name": "seller", "store_name": "演示店铺", "status":"WAIT_SELLER_AGREE", "intervene":0, "created":"2020-08-19 01:50:11", "end_time":"", "bizOrderId": "15997640575344232", "bizIdentity": "trade10001", "order_id": 9, "order_sn": "15997640575344232", "items": [ { "goods_id": 20, "spec_id": 20, "goods_name": "G2000衬衫男长袖防皱商务男装 工作休闲正装衣服修身薄款白色衬衣", "goods_image": "http://www.xxx.com/data/files/store_2/goods/20181121221014676.jpg", "specification": "颜色:红色 尺寸:XXXL", "price": 100.00, "quantity": 2 } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":1 } } } ```