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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agentOrderId String 必须 1506644040404 商家订单Id
alitripOrderId String 必须 400339933333 飞猪订单id

响应参数

名称 类型 示例值 描述
retDesc String 成功 业务结果描述(是必填)
retCode String 0 业务结果编码(是必填)
agentOrderId String 1893330565555 商家订单Id(是必填)
alitripOrderId String 2000093330455 飞猪订单id(是必填)
success Boolean true 业务结果(是必填)
passengerList Passenger [] 乘客信息(list必填)
  • └ passengerId
  • String
  • 335k
  • 乘客Id
  • └ passengerName
  • String
  • 罗大佑
  • 乘客姓名
  • └ passengerCertificateNo
  • String
  • 212100198902171763
  • 乘客证件号
  • └ passengerCertificateType
  • String
  • 1
  • 乘客证件类型
  • └ ticketId
  • String
  • 33390L
  • 票Id
  • └ refundSurcharge
  • Number
  • 500
  • 手续费

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripBusReturnQueryRequest req = new AlitripBusReturnQueryRequest();
req.setAgentOrderId("1506644040404");
req.setAlitripOrderId("400339933333");
AlitripBusReturnQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<retDesc>成功</retDesc>
<retCode>0</retCode>
<agentOrderId>1893330565555</agentOrderId>
<alitripOrderId>2000093330455</alitripOrderId>
<success>true</success>
<passengerList>
    <passenger>
        <passengerId>335k</passengerId>
        <passengerName>罗大佑</passengerName>
        <passengerCertificateNo>212100198902171763</passengerCertificateNo>
        <passengerCertificateType>1</passengerCertificateType>
        <ticketId>33390L</ticketId>
        <refundSurcharge>500</refundSurcharge>
    </passenger>
</passengerList>

异常示例

  • 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

返回
顶部