马蜂窝开放平台

获取指定退款订单

根据商家提供的订单号信息，查询订单退款详情

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.refund.detail.get

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	306255201712085378844	旅行商城业务订单号

响应参数

参数名称	参数类型	示例	描述
refund_id	string	123456	马蜂窝订单关联的退款单号
order_id	string	306255201712085378844	旅行商城业务订单号
apply_ctime	dateTime	2017-12-15 12:00:00	退款申请时间
update_time	dateTime	2017-12-15 12:00:00	最后更新时间
apply_reason	int	20	退款原因 "20:其他原因 21:行程有变 22:供应商无货了 23:数量排错了 24 出行人信息填错了 25 因临时有事，无法参与"
refund_flag	int	1	退款状态 "1:已完成退款 2:已申请退款 3:拒绝退款 4:已确认退款
refund_remark	array	[]	退款操作备注
{}	object	0
└ uid	int	72711470	退款备注添加人UID
└ action	string	apply	退款的操作，apply申请退款、accept确认退款、reject拒绝退款、success完成退款、fallback_from_accept撤销退款
└ remark	string	申请退款	退款备注表述
└ ctime	dateTime	2017-12-15 12:00:00	添加备注时间
total_price	number	1	订单原始金额
payment_fee	number	12	订单支付金额商家原始在此订单上的结算金额
refund_fee	number	1	已退款金额，单位：元
refunded_items	array	[]	已退款项
{}	object	0
└ id	int	3	退款项ID
└ num	int	1	已退完的数量
└ name	string	房间	退款项描述
└ refund_sold	number	4	实付金额
└ refund_fee	number	3	退款金额
refunding_items	array	[]	正在退款项
{}	object	0
└ id	int	3	退款项ID
└ num	int	1	正在退款中的数量
└ name	string	房间	退款项描述
└ refund_sold	number	3	实付金额
└ refund_fee	number	3	退款金额
items	array	[]	购买项
{}	object	0
└ id	int	1	退款项ID
└ num	int	1	本项购买数量
└ price	number	3	本项单价可退金额
└ name	string	房间	退款项描述
└ payment_fee	number	1	本项支付金额
└ price_type	int	1	费用项具体说明请见费用类型说明表
└ remain_num	int	1	剩余可退数量
└ total_price	number	3	本项可退总金额
└ skuId	int	123123	库存ID
└ remain_payment_fee	number	90	剩余可退金额
travelers	array	[]	出行人信息
{}	object	0
└ traveler_id	int	123123	出行人ID
└ name	string	小蜂	出行人姓名
└ cellphone	string	13300000001	联系电话
└ id_card	string	1101012002301019736	身份证号【出行人信息中有才会返回这一项】
└ passport	string	11233232	护照证件号【出行人信息中有，才会返回这一项】
└ laissez_passer_tw	string	123123123	台湾通行证【出行人信息中有，才会返回这一项】
└ laissez_passer	string	123123123	港澳通行证【出行人信息中有，才会返回这一项】
refunded_travelers	array	[]	已经退款的出行人信息
{}	object	0
└ traveler_id	int	123123	出行人ID
refunding_travelers	array	[]	退款中的出行人信息
{}	object	0
└ traveler_id	int	123132	出行人ID

响应示例

{
    "refund_id":"123456",
    "order_id":"306255201712085378844",
    "apply_ctime":"2017-12-15 12:00:00",
    "update_time":"2017-12-15 12:00:00",
    "apply_reason":"20",
    "refund_flag":"1",
    "refund_remark":[
        {
            "uid":"72711470",
            "action":"apply",
            "remark":"申请退款",
            "ctime":"2017-12-15 12:00:00"
        }
    ],
    "total_price":"1",
    "payment_fee":"12",
    "refund_fee":"1",
    "refunded_items":[
        {
            "id":"3",
            "num":"1",
            "name":"房间",
            "refund_sold":"4",
            "refund_fee":"3"
        }
    ],
    "refunding_items":[
        {
            "id":"3",
            "num":"1",
            "name":"房间",
            "refund_sold":"3",
            "refund_fee":"3"
        }
    ],
    "items":[
        {
            "id":"1",
            "num":"1",
            "price":"3",
            "name":"房间",
            "payment_fee":"1",
            "price_type":"1",
            "remain_num":"1",
            "total_price":"3",
            "skuId":"123123",
            "remain_payment_fee":"90"
        }
    ],
    "travelers":[
        {
            "traveler_id":"123123",
            "name":"小蜂",
            "cellphone":"13300000001",
            "id_card":"1101012002301019736",
            "passport":"11233232",
            "laissez_passer_tw":"123123123",
            "laissez_passer":"123123123"
        }
    ],
    "refunded_travelers":[
        {
            "traveler_id":"123123"
        }
    ],
    "refunding_travelers":[
        {
            "traveler_id":"123132"
        }
    ]
}

异常错误码

异常码	异常信息
10040025	系统异常
10040024	没有操作权限
10040023	订单账号异常
10040019	该订单版本不支持退款
10040006	这不是你的订单