蘑菇街开放平台

API 列表

xiaodian.trade.refund.detail

免费
需要授权
结果不加密

退款详情API （预计2021.10.31下线，请接入xiaodian.trade.refund.detail.encrypted）

公共参数

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

输入参数

名称	类型	必选	描述	示例值
refundId	Number	是	退款编号ID
userId	Number	是	卖家id

返回参数

名称	类型	描述
buyerName	String	买家名称
createdStr	String	创建时间
expense	Number	退款金额(单位:分)
goodsPrice	Number	商品价格(单位:分)nowPrice*number
itemId	String	商品ID
itemOrderId	String	商品订单编号
nowPrice	Number	商品目前价格(单位:分)
number	Number	商品数量
orderStatus	String	订单状态
refundId	String	退款编号
shopOrderId	String	店铺订单号
status	String	退款状态
timeLines	Object[]	退货退款时间线
actionName	String	行为描述
actionType	String	行为类型
createdStr	String	行为时间戳
showContent	Object[]	详细描述
updatedStr	String	最后更新时间
price	Number	商品原价
refundType	String	类型:退货/退款
reason	String	申请原因
refundDescription	String	买家退款描述
refundShipInfo	Object	退货地址/物流信息
shipExpressName	String	物流名称
shipExpressId	String	物流编号
shipTime	String	退货发货时间

请求参数示例

1).
{
    "refundId":"",
    "userId":""
}

返回示例

1).
{
    "result": {
			"buyerName": "安ange歌",
        	"createdStr": "2016-07-05 17:07:52",
        	"expense": "1",
          "goodsPrice": "1",
          "itemId": "260599064",
        	"itemOrderId": "24331885597848",
        	"nowPrice": "1",
        	"number": "1",
        	"orderStatus": "ORDER_CLOSED",
        	"price": "1",
        	"reason": "商家未按约定时间发货",
        	"refundDescription": "",
        	"refundId": "66813441",
        	"refundShipInfo": "",
			"refundType": "refund_money",
        	"shopOrderId": "24331885587848",
        	"status": "refund_completed",
        	"timeLines": [
            {
                "actionName": "退款金额明细",
                "actionType": "REFUND_MONEY_DETAIL",
                "createdStr": "2016-07-05 17:09:30",
                "showContent": [
                    "退款现金：0.01元"
                ]
            },
            {
                "actionName": "商家同意退款",
                "actionType": "REFUND_SELLER_AGREE",
                "createdStr": "2016-07-05 17:09:09",
                "showContent": []
            },
            {
                "actionName": "买家申请退款",
                "actionType": "REFUND_BUYER_ADD",
                "createdStr": "2016-07-05 17:07:52",
                "showContent": [
                    "退款原因：商家未按约定时间发货",
                    "退款现金：0.01元",
                    "退款说明：XXXXX"
                ]
            }
        ],
        "updatedStr": "2016-07-05 17:09:30"
    },
    "status": {
        "code": "0000000",
        "msg": "调用成功 "
    }
}

异常示例

1).
{
    "result": {
        "data": ""
    },
    "status": {
        "code": "0000000",
        "msg": "调用成功 "
    }
}

API测试工具 SDK下载