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

qimen.alitrip.ship.return.query (查询退票手续费)

发起退票前,先调用退票手续费查询接口查询订单/每张票的退票手续费。如果用户已经退票成功或者不允许退票,商家手续费正常返回,在后续的退票接口告知飞猪系统退票结果。选择异步回调退票结果的业务模式,此接口可不实现。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agent_order_id String 必须 1506644040404 商家订单Id
alitrip_order_id String 必须 400339933333 飞猪订单id
extAttr String 必须 {"param":"param"} 扩展属性 JSON格式

响应参数

名称 类型 示例值 描述
ret_desc String 成功 业务结果描述
ret_code String 0 业务结果编码
agent_order_id String 1893330565555 商家订单Id
alitrip_order_id String 2000093330455 飞猪订单id
success Boolean true 业务结果
passenger_list Passenger [] 乘客信息
  • └ passenger_id
  • String
  • 335k
  • 乘客Id
  • └ passenger_name
  • String
  • 罗大佑
  • 乘客姓名
  • └ passenger_certificate_no
  • String
  • 212100198902171763
  • 乘客证件号
  • └ passenger_certificate_type
  • String
  • 1
  • 乘客证件类型
  • └ ticket_id
  • String
  • 33390L
  • 票Id
  • └ refund_surcharge
  • Number
  • 500
  • 手续费

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripShipReturnQueryRequest req = new AlitripShipReturnQueryRequest();
req.setAgentOrderId("1506644040404");
req.setAlitripOrderId("400339933333");
req.setExtAttr("{\"param\":\"param\"}");
AlitripShipReturnQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ret_desc>成功</ret_desc>
<ret_code>0</ret_code>
<agent_order_id>1893330565555</agent_order_id>
<alitrip_order_id>2000093330455</alitrip_order_id>
<success>true</success>
<passenger_list>
    <passenger>
        <passenger_id>335k</passenger_id>
        <passenger_name>罗大佑</passenger_name>
        <passenger_certificate_no>212100198902171763</passenger_certificate_no>
        <passenger_certificate_type>1</passenger_certificate_type>
        <ticket_id>33390L</ticket_id>
        <refund_surcharge>500</refund_surcharge>
    </passenger>
</passenger_list>

异常示例

  • 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

返回
顶部