马蜂窝开放平台

获取退款订单列表

商家通过退款单类型和相关分页属性查询订单退款信息列表。

调用频次

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

请求URL

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

请求Action

action：sales.refund.list.get

请求参数

参数名称	参数类型	必填	示例	描述
refund_status	int	是	1	退款状态 0:全部 1:已完成退款 2:已申请退款 3:拒绝退款 4:已确认退款
page_no	int	是	1	页码
page_size	int	是	50	单页条数（最大值20）

响应参数

参数名称	参数类型	示例	描述
list	array	[]	退款订单列表
{}	object	0	订单退款信息
└ refund_id	string	123456	马蜂窝订单关联的退款单号
└ order_id	string	306255201712085378844	旅行商城业务订单号
└ apply_ctime	dateTime	2017-12-15 12:00:00	退款申请时间
└ update_time	dateTime	2017-12-21 10:19:56	最后更新时间
└ apply_reason	int	20	退款原因 "20:其他原因 21:行程有变 22:供应商无货了 23:数量排错了 24 出行人信息填错了 25 因临时有事，无法参与"
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	添加备注时间
└ refund_flag	int	1	退款状态 "1:已完成退款 2:已申请退款 3:拒绝退款 4:已确认退款"
└ total_price	number	100	订单原始金额
└ payment_fee	number	122	订单支付金额商家原始在此订单上的结算金额
refunded_items	array	[]	已退款项
{}	object	0
└ id	int	3	退款项ID
└ num	int	1	本项可退个数
└ name	string	房间	退款项描述
└ refund_sold	number	3	实付金额
└ refund_fee	number	3	退款金额
└ refund_fee	number	12	已退款金额，单位：元
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
└ skuId	int	1123432	马蜂窝SKU ID，SKU唯一标识
└ num	int	1	本项可退个数
└ price	number	3	本项单价可退金额
└ price_type	int	1	费用项具体说明请见费用类型说明表
└ name	string	房间	退款项描述
└ payment_fee	number	2	本项支付金额
└ total_price	number	3	本项可退总金额
└ remain_num	int	1	剩余可退数量
└ 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	123123123	护照证件号【出行人信息中有，才会返回这一项】
└ laissez_passer_tw	string	123123132	台湾通行证【出行人信息中有，才会返回这一项】
└ laissez_passer	string	123123123	港澳通行证【出行人信息中有，才会返回这一项
refunded_travelers	array	[]	已经退款的出行人信息
{}	object	0
└ traveler_id	int	123123	出行人ID
refunding_travelers	array	[]	退款中的出行人信息
{}	object	0
└ traveler_id	int	123123123	出行人ID
total	int	0	退款单总数量

响应示例

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

异常错误码

异常码	异常信息
10040025	系统异常