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

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

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

公共参数

请求地址：

环境	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	必须	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	业务结果编码（是必填）

请求示例

{"agentOrderId":"1893330565555","alitripOrderId":"2000093330455","passengerList":[{"passengerName":"罗大佑","passengerCertificateNo":"212100198902171763","passengerCertificateType":"1","passengerId":"333k","refundSurcharge":50,"ticketId":"33330L"}]}

响应示例

{
    "retDesc":"success",
    "success":true,
    "retCode":"0"
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API