蘑菇街开放平台

API 列表

xiaodian.trade.refund.list

免费
需要授权
结果不加密

退款列表

公共参数

名称	类型	必选	描述
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

输入参数

名称	类型	必选	描述
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_refund_money：退款类型 query_return_goods：退货类型
startDate	String	是	startDate：创建开始时间，必选(创建时间和更新时间二选一)，2016-06-01 00:00:00，如不需要传[0]
endDate	String	是	endDate：创建结束时间，必选(创建时间和更新时间二选一)，2016-06-01 00:00:00，如不需要传[0]
page	Number	是	page：页面，1
pageSize	Number	是	pageSize 最大20
userId	Number	是	userId
startUpdateTime	String	否	startUpdateTime：更新开始时间，必选(创建时间和更新时间二选一)，2016-06-01 00:00:00，如不需要传[0]
endUpdateTime	String	否	endUpdateTime：更新结束时间，必选(创建时间和更新时间二选一)，2016-06-01 00:00:00，如不需要传[0]

返回参数

名称	类型	描述	默认值
refundFullDTOList	Object	"createdStr": 退款创建时间, "expense": 退款金额（分）, "goodsPrice": 商品货款价（分）, "itemId": 商品ID, "itemOrderId": 商品订单ID, "nowPrice": 现价（分）, "number": 数量, "orderStatus": 订单状态, "price": 价格（分）, "reason": 退款原因（用户填写）, "refundDescription": 退款描述（用户选择）, "refundId": 退款编号 "refundShipInfo": { "shipExpressName": "中通速递", "shipExpressId": "43533131117", "address": "x", "area": "xxx", "city": "xxx", "description": "", "mobile": "158076121212", "name": "刘sxx", "province": "xx省", "shipTime": 0, "zip": "435317" }, "refundType": 退款类型, "shopOrderId": 店铺订单ID——订单列表和详情页暴露的ID "status": 退款状态, "timeLines": 退款的流程时间线, "updatedStr": 更新时间 status枚举： return_goods_requested * 买家发起退货，等待卖家同意 "sellerRefundAmount": 商家实际退款金额（分）, return_goods_agreed * 卖家同意，等待买家退货 return_goods_shipped * 买家发货，等待卖家收货 refund_requested * 买家发起退款，等待卖家同意 refund_or_return_deal_agreed * 买卖家协商一致，等待资金退款结果 refund_or_return_seller_refused * 买家退款或退货被卖家拒绝 return_goods_seller_declare_not_received * 买家发货后，卖家未收到货 refund_completed * 退款完成 refund_cancelled * 退款取消

请求参数示例

1).
{
	"queryStatus": "",
	"refundType": "",
	"startDate": "",
	"endDate": "",
	"page": "",
	"pageSize": "",
	"userId": ""
}

返回示例

1).
{
    "result": {
        "data": {
            "hasNext": true,
            "refundFullDTOList": [
                {
                    "createdStr": "2016-06-09 16:41:15",
                    "expense": 15320,
                    "goodsPrice": 16320,
                    "itemId": 25971223238,
                    "itemOrderId": 2322512222222222,
                    "nowPrice": 8160,
                    "number": 2,
                    "orderStatus": "ORDER_CLOSED",
                    "price": 13600,
                    "reason": "其他",
                    "refundDescription": "老公不喜欢",
                    "refundId": 62511111231,
                    "refundShipInfo": {
                        "address": "x",
                        "area": "xxx",
                        "city": "xxx",
                        "description": "",
                        "mobile": "158076121212",
                        "name": "刘sxx",
                        "province": "xx省",
                        "shipTime": 0,
                        "zip": "435317",
                        "shipExpressName": "中通速递",
                        "shipExpressId": "43533131117"
                    },
                    "refundType": "return_goods",
                    "shopOrderId": 23215476275678,
                    "status": "refund_completed",
"sellerRefundAmount":163.2,
                    "timeLines": [
                        {
                            "actionName": "退款金额明细",
                            "actionType": "REFUND_MONEY_DETAIL",
                            "createdStr": "2016-06-09 16:45:35",
                            "showContent": [
                                "退款现金：153.20元 "
                            ]
                        },
                        {
                            "actionName": "商家确认收货",
                            "actionType": "RETURN_GOODS_SELLER_CONFIRM_RECEIVE",
                            "createdStr": "2016-06-09 16:45:29",
                            "showContent": []
                        },
                        {
                            "actionName": "商家同意退货",
                            "actionType": "RETURN_GOODS_SELLER_AGREE",
                            "createdStr": "2016-06-09 16:45:27",
                            "showContent": [
                                "收件人：xx",
                                "电话：158076123456!",
                                "邮编：123456",
                                "地址：xxx省xx市xx市xxx镇xxxx11栋1x7"
                            ]
                        },
                        {
                            "actionName": "买家申请退货",
                            "actionType": "RETURN_GOODS_BUYER_ADD",
                            "createdStr": "2016-06-09 16:41:15",
                            "showContent": [
                                "退款原因:其他",
                                "退款现金:153.20元",
                                "退款说明:老公不喜欢 "
                            ]
                        }
                    ],
                    "updatedStr": "2016-06-09 16:45:35"
                }
            ]
        }
    },
    "status": {
        "code": "0000000",
        "msg": "调用成功!"
    }
}

异常示例

1).
{  }

API测试工具 SDK下载