51book机票接口对接,吐血整理(含PHP封装代码)
前言 最近在对接51book的机票接口,遇到了挺多坑,所以整理一份作为记录
机票有两个不同的接口,一个是机票,另一个是保险
一、申请
要接51book的机票,首先是要申请账号,这时候应该是有客户经理跟进,然后具体事宜都会告诉你。
拿到账号之后,客户经理会把你的账号拉入测试组,不然测试购买机票然后改签、退票都是需要钱的,做测试支付机票的时候还要去后台开通2个东西:
- 机票支付宝授权,添加营业员
- 保险支付宝授权
这两个是分别授权的,有两个网址。
对了,后台还有密码要设置,点击“我的余额”然后就可以设置了。
二、逻辑
购买机票的逻辑
- 查询航班
- 查看航班座位
- 选择座位预订
- 填写相关信息,预订订单
- 支付
- 后续改签、退票
三、开发
51book那边会有接口文档,现在已经更新http新接口
接口主页:http://ws.51book.com/
机票新接口:http://ws.51book.com/ltips/web/customerdetailcontroller.in?id=13&flag=getdetail&language=ch
保险接口文档目前还没有在线的,由51book那边单独发送
接口测试需要51book那边把你的ip设为白名单
机票接口:
- 公共
- 航班查询
- 机票预定
- 支付
- 通知
- 出票通知
- 取消--取消订单退款通知
- 航变通知
- 退票通知
- 改期通知
- 查询订单详情
- 支付前校验
- 我们av查询时试试运价 这个已经调去一次了时时数据了,那么客人查询一直都不支付,会存在位子是否有效,那么二次验价就会起到效果,他会再次调取一次,如果发生变化他会重新验价,客户支付不了,如果没有就直接可以支付。二次验价主要是给客户更好的体验
- 需要开通才能用
- 变更查询
- 变更申请
- 变更需支付
- 退票查询
- 退票退款申请
- 验证舱位价格
- 获取客规
- 改签退票手续费在这里
注意事项
接口参数和返回都说的很清楚,这里就不在详细描述了,我做对接的时候遇到几个坑,需要注意一下:
- 要熟悉下航空公司的规则,例如:儿童是不让单独乘机的,所以买票的时候要做下判断
- 儿童不让单独乘机,引发改签和退票也不能单独改和退,所以这里也要做判断
- 带儿童的订单,接口返回有两个订单号,都要记录
- 因为有2个订单号,所以在接收改签和退票的时候,51book那边发的通知是2次,(但是出票通知就一次)
- 改签的时候,原来订单里的票号是不变的,所以后期查询订单接口就查不到变更后的信息,需要自己记录
改签相关
- 改签没有次数限制,因为要收手续费,只要航班没起飞就可以改签
- 改签不能改出发地和目的地
- 变更中是不能改签和退票
- 改签只能修改价格比当前高的,同时舱位也要比之前高
- 改签手续费是按照原来航班的票价
我设置的状态:
1000:待支付 ,
2000:已支付,待出票 ,
3000:已出票 ,
4000:变更审核中 ,
4100:变更需支付 ,
4200: 处理中,
4300:变更完成,
4400:无法变更,
5000:退票审核中,
5100:审核通过,待退款
5200:退款成功,
5300:无法退/废票,
5400:退款失败,
6000:已取消,
保险接口
- 查询保险产品接口
- 保险产品查询
- 投保
- 保险支付
- 保单查询
- 退保申请
保险接口没有http协议的接口,用的是wsdl格式的,php用soap来对接
首先要说的是保险接口没有异步通知,就是说你下单成功了,他们不是马上可以出保单,需要一会时间,这时候没法立刻获取到保单号,需要调用“保单查询”接口去查,而且不能立即查,需要过一会之后去查才有。查的时候把保单信息放入数据库中。
注意事项
-
没有异步通知
-
同个人买不同产品需要调用多次购买接口,同个产品的保单明细可以放多个人,就是说一个产品要下一个单
附上机票接口请求封装代码(thinkphp5写的)
链接