文档中心 > API类目 > 国内机票京杭API

taobao.alitrip.refundticket.refundapply (【京杭】——退票申请(新))

提交退票申请

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
channel_name String 必须 feiye 接入方提供的用户名
refund_ticket_type String 必须 Voluntary Voluntary:自愿,NonVoluntary:非自愿
password String 必须 7b1e6dd7e98f6e84f246cb4783880449 接入方提供的密码,以MD5方式加密后传入
ticket_numbers String [] 可选 781-8511813918,781-8511813919
  • 最大列表长度:20
  • 需退票的票号,一个订单仅有1个乘机人时无须填写(部分航司同时仅支持1个票号提交退票)
    refund_fee Number 可选 100 退票手续费(单位:元,非自愿退票及无法计算退票费时可不填)
    order_id Number 必须 123 淘宝订单号
    refund_ticket_detail String 可选 改变行程 退票原因说明(非自愿退票必填)
    voucher_infos RefundVoucherInfoDO [] 可选
  • 最大列表长度:20
  • 通过凭证上传接口上传的凭证信息
    • └ file_name
    • String
    • 可选
    • 延误证明.jpg
    • 凭证文件名
    • └ file_id
    • String
    • 可选
    • TB1pOvUXXXXXXatXpXXXXXXXXXX
    • 通过凭证上传接口上传的凭证id
    refund_reason_type Number 可选 1 1:自愿退票(我要改变行程计划、我不想飞);31:自愿退票(填错名字、选错日期、选错航班);32:自愿退票(没赶上飞机、证件忘带了);33:自愿退票(生病了无法乘机(无二甲医院证明));99:自愿退票(其他);6:非自愿退票(航班延误或取消、航班时刻变更等航司原因);21:非自愿退票(身体原因且有二级甲等医院<含>以上的医院证明);

    响应参数

    名称 类型 示例值 描述
    apply_id Number 109832432 系统自动生成
    is_success Boolean true 请求结果是否成功
    refund_fee Number 100 退款手续费
    refund_money Number 500 退款金额

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripRefundticketRefundapplyRequest req = new AlitripRefundticketRefundapplyRequest();
    req.setChannelName("feiye");
    req.setRefundTicketType("Voluntary");
    req.setPassword("7b1e6dd7e98f6e84f246cb4783880449");
    req.setTicketNumbers("781-8511813918,781-8511813919");
    req.setRefundFee(100L);
    req.setOrderId(123L);
    req.setRefundTicketDetail("改变行程");
    List<AlitripRefundticketRefundapplyRequest.RefundVoucherInfoDO> list2 = new ArrayList<AlitripRefundticketRefundapplyRequest.RefundVoucherInfoDO>();
    AlitripRefundticketRefundapplyRequest.RefundVoucherInfoDO obj3 = new AlitripRefundticketRefundapplyRequest.RefundVoucherInfoDO();
    list2.add(obj3);
    obj3.setFileName("延误证明.jpg");
    obj3.setFileId("TB1pOvUXXXXXXatXpXXXXXXXXXX");
    req.setVoucherInfos(list2);
    req.setRefundReasonType(1L);
    AlitripRefundticketRefundapplyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_refundticket_refundapply_response>
        <apply_id>109832432</apply_id>
        <is_success>true</is_success>
        <refund_fee>100</refund_fee>
        <refund_money>500</refund_money>
    </alitrip_refundticket_refundapply_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.atr_refund_fee_changed 退票手续费错误或发生变更 请重新提交
    isv.airline_too_many_segment 暂不支持同时提交多个乘机人退票 多个票号分开提交
    isv.apply_reason_detail_is_blank 非资源退票,必须填写退票原因 填写退票原因
    isv.atr_refund_reason_invalid 退票原因长度错误 请勿少于10个字/超过80个字
    isv.same_user_refund_apply 用户并发申请退票申请单失败 请勿并发发起退票申请

    API工具

    如何获得此API

    FAQ

    返回
    顶部