锐鲨开放平台

API 列表

xiaodian.trade.refund.detail

免费
需要授权

API功能描述(支持get和post)

退款详情API

公共参数

名称	类型	必选	描述
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*num
itemId	String	商品ID
itemOrderId	String	商品订单编号
nowPrice	Number	商品折扣后的价格
number	Number	商品数量
orderStatus	String	订单状态
refundId	String	退款编号
shopOrderId	String	店铺订单号
status	String	退款订单状态买家发起退货，等待卖家同意RETURN_GOODS_REQUESTED ---> return_goods_requested 卖家同意，等待买家退货RETURN_GOODS_AGREED ----> return_goods_agreed 买家发货，等待卖家收货RETURN_GOODS_SHIPPED ----> return_goods_shipped 买家发起退款，等待卖家同意REFUND_REQUESTED -----> refund_requested 买卖家协商一致，等待资金退款结果 REFUND_OR_RETURN_DEAL_AGREED -----> refund_or_return_deal_agreed 买家退款或退货被卖家拒绝REFUND_OR_RETURN_SELLER_REFUSED -----> refund_or_return_seller_refused 买家发货后，卖家未收到货RETURN_GOODS_SELLER_DECLARE_NOT_RECEIVED -----> return_goods_seller_declare_not_received 退款完成REFUND_COMPLETED -----> refund_completed 退款取消REFUND_CANCELLED -----> refund_cancelled * 注：超时的不算取消节点。
refundCashExpense	Number	现金退款金额(单位:分)
refundShipExpense	Number	运费退款金额(单位:分)

请求参数示例

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

返回示例

1).
{
    "result": {
        "data": {
            "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测试工具 API Demo下载