文档中心 > API类目 > 汽车票API

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

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

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
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 手续费

请求示例

{"agentOrderId":"1506644040404","alitripOrderId":"400339933333"}

响应示例

{
    "retDesc":"成功",
    "retCode":"0",
    "agentOrderId":"1893330565555",
    "alitripOrderId":"2000093330455",
    "success":true,
    "passengerList":[
        {
                "passengerId":"12625061024999",
                "passengerName":"罗大佑",
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "ticketId":"33390L",
                "refundSurcharge":500
        }
    ]
}

验签示例

{"retDesc":"Illegal request","success":"false","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ