文档中心 > 综合交通-商家对接

qimen.alitrip.bus.return.confirm (退票确认接口)

发起退票前,先调用退票手续费查询接口查询订单,每个乘车人的退票手续费。接口根据alitripOrderId+passengerCertificateNos幂等。可以每次退部分票、分多次退。退多张票时,要保证原子性,只允许全部成功或者全部失败。如果商家不能同步返回退票状态,则需要退票回填。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agentOrderId String 必须 1893330565555 分销商订单Id
alitripOrderId String 必须 2000093330455 飞猪订单Id
passengerList Passenger [] 必须
  • 最大列表长度:999999
  • 乘客信息列表
    • └ passengerName
    • String
    • 可选
    • 罗大佑
    • 乘客姓名
    • └ passengerCertificateNo
    • String
    • 可选
    • 212100198902171763
    • 乘客证件号
    • └ passengerCertificateType
    • String
    • 可选
    • 1
    • 乘客证件类型
    • └ refundSurcharge
    • Number
    • 可选
    • 50
    • 退票手续费
    • └ ticketId
    • String
    • 必须
    • 33330L
    • 票id
    • └ passengerId
    • String
    • 必须
    • 333k
    • 乘客Id

    响应参数

    名称 类型 示例值 描述
    retDesc String success 业务结果描述(是必填)
    success Boolean true 业务结果(是必填)
    retCode String 0 业务结果编码(是必填)

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripBusReturnConfirmRequest req = new AlitripBusReturnConfirmRequest();
    req.setAgentOrderId("1893330565555");
    req.setAlitripOrderId("2000093330455");
    List<AlitripBusReturnConfirmRequest.Passenger> list2 = new ArrayList<AlitripBusReturnConfirmRequest.Passenger>();
    AlitripBusReturnConfirmRequest.Passenger obj3 = new AlitripBusReturnConfirmRequest.Passenger();
    list2.add(obj3);
    obj3.setPassengerName("罗大佑");
    obj3.setPassengerCertificateNo("212100198902171763");
    obj3.setPassengerCertificateType("1");
    obj3.setRefundSurcharge(50L);
    obj3.setTicketId("33330L");
    obj3.setPassengerId("333k");
    req.setPassengerList(list2);
    AlitripBusReturnConfirmResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <retDesc>success</retDesc>
    <success>true</success>
    <retCode>0</retCode>
    

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部