酒店与机票预订 API:一次行程,两笔预订

工单上写着“在机票流程里加上酒店,一次结账,一个总价”。产品经理提出这个要求很合理,听上去一天就能做完,因为你已经有机票搜索,也已经有支付页。三周后,团队还在争论:航空公司确认了而酒店没确认,该怎么办。酒店与机票预订 API不是一个返回两种结果的集成,而是两个共用一个购物篮的集成。
代码越早承认这一点,要重写的部分就越少。下面是集成指南往往跳过的内容:两半有什么不同,先提交哪一半,以及行程在你的数据模型里应当是什么。
两半的行为并不一样
两者都以 JSON 返回价格和引用编号,所以在线路上看起来很像。但拿到引用编号之后,它们向你承诺的东西并不相同。
| 问题 | 机票 | 酒店 |
|---|---|---|
| 预订后你手里有什么 | 尚未出票的订位记录(PNR) | 通常已经就是你卖出的东西的确认 |
| 价格多久有效 | 到预订时重新计价为止,可能与搜索时不同 | 到费率过期为止,费率在查房与预订之间可能变化 |
| 什么算确认 | 出票,通常有时限 | 供应商的确认,有时即时,有时待定 |
| 如何撤销 | 尽早发现可作废(void),否则按票价规则退款,常有罚金 | 按该费率自己的政策取消,许多费率在截止时间前免费 |
| 什么会在后期改变金额 | 票价、税费,有时是票价币种 | 到店支付的税费、餐食安排、实际分配的房间 |
你可以不同意某一行,因为供应商各不相同,但不能不同意它的形态:一半有出票步骤,另一半有取消窗口,两者在时间上对不上。流程中机票一侧我们在机票预订 API 集成中讲过,酒店一侧的慢供应商问题在酒店可用性 API 客户端设计中讲过。本文从它们结束的地方开始,也就是连接处。
先订哪一个?
没人告诉你这是个设计决策,而它恰恰决定失败的代价。
假设客户在相同日期买了机票和酒店。你先发一笔预订,再发另一笔。可能出现三种情况:都成功,一个失败,或一个在另一个成功之后失败。第一种是好日子,另外两种决定你的客服队列有多长。
如果先出票而酒店随后拒绝,你面对的是一个有去那座城市的座位却没有房间、已被扣款、退票还要付罚金的客户。如果先订酒店而机票随后失败,你手里是一间通常可以免费取消的房间,补救成本很低。反向风险同样存在:不可取消的酒店费率是最糟的持有物,所以在让它先走之前,先读清该费率的取消条款。
这是经验法则,不是定律,关键在于有意识地选择顺序。先提交更容易撤销的那一半,再提交更难撤销的那一半;在任何一半提交前,核对两边的价格;并写下三种结果各自如何处理。评审很少问,客户总会发现。
一次行程,两笔预订
站得住的结构是:一条行程记录拥有两笔预订,每笔有自己的引用编号、状态和条款。客户看到一个总价。你的数据库看到两行,总价是你算出来的和,而不是供应商那里存在的东西。
把两个状态分开。酒店的“已确认”与机票的“已出票”不是同一种状态,把它们压成一列的状态字段,迟早会在只订了一半的行程上写出“已预订”。
变更条款也要分开并展示出来。显示的总价会掩盖一件事:改期对一半是免费修改,对另一半却要付费。如果你的前端把“改期”做成一个按钮,请在客户替你发现之前,先决定当只有一半能改时它做什么。加价同理:如果你像大多数卖家一样按服务加价,行程总价就是两笔加价,退掉其中一半时必须知道退的是哪一笔。钱是联合行程变贵的地方,因为各行结算的时间线不同,机票退款不会和酒店取消同时到账。
本平台所处的位置
直说:平台提供机票与酒店 API,接入从一次沟通开始,而不是自助获取密钥。服务按租户开通,只卖酒店不卖旅游线路的租户不会带上旅游线路的接口面。这里不承诺存在一次调用就能原子地订下两半的接口,你也不应当按有这种接口来设计。把它们当作两笔预订,归在你自己拥有的行程之下。
如果想在围绕它们开发之前先看到真实的调用和条款,可以从旅行 API 页面开始,并带上你打算采用的预订顺序。如果你还在判断免费接入能得到什么,免费酒店预订 API列出了免费的几种类型。
做错的代价
昂贵的是悄无声息的那种:客户已出票飞往一座城市,房间却没了,你得知消息是深夜机场发来的一条留言。便宜一些但同样真实的有:结账页显示一个令人安心的总价,价格核对后却变成客户没有同意的第二个数字;退款退了机票却忘了酒店;供应商另有说法时状态仍显示“已预订”。
这些都不需要巧妙的修复。它们需要行程是一个真实的对象,顺序是有人写下的决定,并且在任何一半提交前的最后一刻重新核对两边价格。把这些做一次,结账页就可以像工单要求的那样简单。