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

自助机小程序接口Q&A

1. 创建订单接口 taobao.bus.tvmcreateorder.set

商家创建订单接口入参介绍

必传字段:

1.自助机编号:machineNumber
2.乘车人信息:乘车人姓名riderName,乘车人身份证号riderCertNumber
(目前系统没有强校验,商家没传时系统会给默认乘车人姓名为“乘客”和乘车人身份证号“110101199612260019”)
3.城市车站等信息:看渃熙标准

注意的点:

1、tvmOnline:true即线上订单
2、issueTimeout:(秒)出票超时时间,从支付成功开始计时。
3、payTimeout:(秒)支付超时时间,从用户创建订单开始计时,包含扫码等时间 (可适当给长一些)
(倒计时是从商家调我们创建订单接口开始计时的,所以真正留给用户支付的时间,还有减去用户在页面上看到二维码,扫码,在下单页看页面,犹豫的时间)
4.车站id 线下车站id必须与线上车站id 一致,如数据不能互通,需要商家自行映射(车站id 和车站名要求与线上一致)

参考实例:

image
传参实例:
“{"accountInDetails":[{"alipayAccount":"123@163.com","alipayAccountId":"1111222333","amount":1500}],"agentId":123456789,"agentOrderId":"123456","dataInvalidTime":1605741774912,"gmtCreate":1605740874912,"insBundled":true,"issueTimeout":300,"machineNumber":"bbkbWindowsHZHCDZ001","passengers":[{"fullPrice":1500,"hasChildren":false,"insurePrice":0,"riderCertNumber":"110101199612260019","riderCertType":"01","riderName":"乘客","serviceCharge":0,"ticketPrice":1500}],"payTimeout":900,"realName":false,"saveInvalidTime":1605764400000,"serviceProviderId":"999999","ticketCount":1,"totalPrice":1500,"tradeSource":"window","tvmBusLineInfo":{"depTime":"2020-11-19 07:40:00","lastPlaceName":"店口","startCityName":"杭州","startProvinceName":"浙江","startStationId":"010105","startStationName":"杭州火车东站"},"virtualItemStatus":"10"}”

2.线下自助机查询订单信息 taobao.bus.tvmqueryorder.get

注意的点:

1.当支付成功后,查询订单返回alitrip_order_id是新的订单号,后续操作使用这个订单号

3.交易流程

image

FAQ

关于此文档暂时还没有FAQ
返回
顶部