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

qimen.alitrip.bus.order.scancode.confirmbook (扫码购票出票成功结果通知)

通知商家出票接口。用户在飞猪支付成功后，将用户支付的票价与票数、支付的流水号、飞猪订单号与商家订单号等信息通过此接口通知商家，商家返回接收的状态。商家若需分佣，则在此接口依照格式返回分佣信息。若调用此接口失败或商家接收状态失败，则会重试调用此接口，故此接口务必保持幂等，即相同的agentOrderId多次调用时返回的相同的结果。商家需对请求的票价、票数与总金额进行逻辑校验。

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
goodsId	String	必须	goods123	二维码编号
mainOrderId	Number	必须	1234567890	飞猪订单号
agentOrderId	String	必须	9876543210	商家订单号
alipayTradeId	String	必须	2021040922001140331412345678	支付宝流水号
payTime	String	必须	2021-01-01 13:00:00	支付时间 yyyy-MM-dd HH:mm:ss
plateNum	String	可选	京A12345	车牌号
startStation	String	可选	梅溪湖	出发站
endStation	String	可选	火车站	到达站
ticketPrice	Number	必须	100	单张票价
ticketCount	Number	必须	2	票数
totalAmount	Number	必须	200	订单总金额
nickName	String	必须	无忆	用户昵称
alitrip_tp_order_id	Number	可选	1234567890	淘宝订单id
buyer_info_unique_key	String	可选	***王d827bdf1d250fa37e25a059da36230a7	买家用户信息唯一标识

响应参数

名称	类型	示例值	描述
ret_code	String	0	业务结果编码
ret_desc	String	成功	业务结果描述
success	String	true	业务结果
accountInfo	AccountInfo		分账信息
└ isSettleAccount String 1 是否支持分账，0不支持，1支持 └ settleAccountDetail String [{"alipayAccount":"test@sina.com","alipayAccountId":"20888000000000000","amount":2485},{"alipayAccount":"test@126.com","alipayAccountId":"20888000000000000","amount":15}] 分账明细
supportEticket	Boolean	ture	支持电子票
eleTicketNo	String	234234	电子票号

请求示例

{"endStation":"火车站","ticketCount":2,"ticketPrice":100,"payTime":"2021-01-01 13:00:00","goodsId":"goods123","agentOrderId":"9876543210","nickName":"无忆","alipayTradeId":"2021040922001140331412345678","buyer_info_unique_key":"***王d827bdf1d250fa37e25a059da36230a7","plateNum":"京A12345","totalAmount":200,"alitrip_tp_order_id":1234567890,"startStation":"梅溪湖","mainOrderId":1234567890}

响应示例

{
    "ret_code":"0",
    "ret_desc":"成功",
    "success":"true",
    "accountInfo":{
        "isSettleAccount":"1",
        "settleAccountDetail":"[{\"alipayAccount\":\"test@sina.com\",\"alipayAccountId\":\"20888000000000000\",\"amount\":2485},{\"alipayAccount\":\"test@126.com\",\"alipayAccountId\":\"20888000000000000\",\"amount\":15}]"
    },
    "supportEticket":ture,
    "eleTicketNo":"234234"
}

验签示例

{"success":"不等于true","ret_desc":"Illegal request","ret_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API