文档中心 > 国内机票

需要接入的接口列表

接口 说明
taobao.alitrip.seller.refund.search 获取退票申请单列表
taobao.alitrip.seller.refund.get 获取退票申请单详情
taobao.alitrip.seller.refund.fillfee 回填手续费
taobao.alitrip.seller.refund.confirmreturn 确认退票
taobao.alitrip.seller.refund.refusereturn 拒绝退票(非自愿)
taobao.alitrip.seller.refund.unsuspend 解挂票

交互流程图

  • TOP API 自愿退票申请
    image
  • TOP API 非自愿退票申请
    image

接口参数描述

获取退票申请单列表(taobao.alitrip.seller.refund.search)
* 功能说明:获取退票申请单列表
* 接口输入输出参数
获取退票申请单详情 (taobao.alitrip.seller.refund.get)
* 功能说明:获取退票申请单详情
* 接口输入输出参数
回填手续费 (taobao.alitrip.seller.refund.fillfee)
* 功能说明:如果费用不完整,回填手续费。
* 接口输入输出参数
* 特殊参数格式说明:fee_price_map、ticket_price_map、modify_fee、upgrade_fee 格式:{“4029190”:74000}
确认退票 (taobao.alitrip.seller.refund.confirmreturn)
* 功能说明:在费用完整情况下确认退票
* 接口输入输出参数
拒绝退票(非自愿)(taobao.alitrip.seller.refund.refusereturn)
* 功能说明:用于拒绝非自愿退票申请。
* 接口输入输出参数
解挂票(taobao.alitrip.seller.refund.unsuspend)
* 功能说明:解挂被挂起的票。
* 接口输入输出参数

退票原因对应关系

apply_reason_type 原因
1 我要改变行程计划、我不想飞了
2 下单时选错日期/航班“,”您可以先行尝试与卖家联系改签机票.
3 下单时填错乘机人/联系人信息“,”您可以先行尝试与卖家联系为您修改信息。
4 在其他渠道发现更优惠的机票
5 非自愿退票(其他)
6 非自愿退票(航班延误或取消、航班时刻变更等航司原因)“,”非自愿退票需卖家核实,核实后将为您全额退款。
21 非自愿退票(身体原因且有二级甲等医院<含>以上的医院证明)
31 填错名字、选错日期、选错航班
32 没赶上飞机、证件忘带了
33 生病了无法乘机(无二甲医院证明)
99 其他

申请单状态与代理商后台(退票申请单管理)对应关系

退票申请单管理页面 申请单状态 说明
等待卖家反馈 1 申请单初始状态,费用不完整,需要卖家处理(回填手续费)
待回填手续费 6 卖家处理中,需要回填手续费
待确认 2 申请单初始状态,费用完整,需要卖家确认退票。(TOP 接口不操作退款)
待退款 3 卖家已经确认退票,需要操作退款
退款成功 8 退款成功(终结状态)
已失效 4 已失效
小二介入处理 7 超时卖家未处理的订单

FAQ

关于此文档暂时还没有FAQ
返回
顶部