同意退款请求
商家根据退款单号同意申请退款
注意:
通过此接口确认订单退款金额时,需根据订单原始金额(不考虑优惠金额)进行填写。马蜂窝在收到退款金额之后,会自动根据优惠金额比例自动计算向客人退款的实际金额。
请求URL
正式环境:https://openapi.mafengwo.cn/deals/rest
请求Action
action:sales.refund.confirm
请求参数
参数名称 |
参数类型 |
必填 |
示例 |
描述 |
refund_id |
int |
是 | 76445 |
退款单ID |
items |
array |
是 | [] |
退款信息 |
{} |
object |
是 | 0 |
|
└ id |
int |
是 | 76445 |
购买项ID |
└ num |
int |
是 | 1 |
本项可退个数 |
└ refund_fee |
number |
是 | 3 |
退款金额,马蜂窝会根据字段取值并结合优惠折扣比例计算出给客人实际退款金额;
如用户需要全额退款,需要回传订单原始金额totalPrice,而非订单支付金额; |
remark |
string |
否 | 退款备注 |
退款备注 |
calc_type |
int |
否 | 1 |
退款金额计算类型 具体说明请见 退款确认接口调用说明 |
travelers |
array |
否 | [] |
|
{} |
object |
否 | 0 |
|
└ traveler_id |
int |
否 | 123123 |
出行人ID |
is_total |
int |
否 | 1 |
订单退款完成标识:
0-退款后订单继续进行。
1-退款后服务结束,订单关闭。 |
响应参数
响应示例
异常错误码
异常码 |
异常信息 |
10040038 |
无效的退款金额 |
10040036 |
该退款ID无法确认退款 |
10040035 |
实际剩余可退金额过低 |
10040034 |
实际退款金额过低 |
10040031 |
优惠计算失败 |
10040030 |
选择的出行人和数量不相等 |
10040028 |
订单出行人已退 |
10040027 |
创建退款出行人失败 |
10040026 |
订单出行人不存在 |
10040025 |
系统异常 |
10040023 |
订单账号异常 |
10040020 |
退款金额为0 |
10040019 |
该订单版本不支持退款 |
10040018 |
三方失败 |
10040017 |
创建退款单项失败 |
10040016 |
订单还未支付 |
10040015 |
支付中心失败 |
10040014 |
订单项不存在 |
10040013 |
可退金额不足 |
10040012 |
数量异常 |
10040011 |
退款单不存在 |
10040010 |
创建退款单项失败 |
10040009 |
同步订单状态失败 |
10040008 |
创建退款单失败 |
10040007 |
当前状态不能申请退款 |
10040006 |
这不是你的订单 |
10040005 |
没有选择退款项 |
10040004 |
没有操作人 |
10040003 |
申请原因错误 |
10040002 |
订单锁定失败 |
10040001 |
退款单号异常 |