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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agent_order_id String 必须 1893330565555 分销商订单Id
alitrip_order_id String 必须 2000093330455 飞猪订单Id
passenger_list Passenger [] 必须
  • 最大列表长度:999999
  • 乘客信息列表
    • └ passenger_name
    • String
    • 可选
    • 罗大佑
    • 乘客姓名
    • └ passenger_certificate_no
    • String
    • 可选
    • 212100198902171763
    • 乘客证件号
    • └ passenger_certificate_type
    • String
    • 可选
    • 1
    • 乘客证件类型
    • └ refund_surcharge
    • Number
    • 可选
    • 50
    • 退票手续费
    • └ ticket_id
    • String
    • 必须
    • 33330L
    • 票id
    • └ passenger_id
    • String
    • 必须
    • 333k
    • 乘客Id
    extAttr String 必须 {"param":"param"} 扩展属性 json格式

    响应参数

    名称 类型 示例值 描述
    ret_desc String success 业务结果描述
    success Boolean true 业务结果
    ret_code String 0 业务结果编码

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <ret_desc>success</ret_desc>
    <success>true</success>
    <ret_code>0</ret_code>
    

    异常示例

    • 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

    返回
    顶部