机票 API 集成
TBO 机票 API 集成：从搜索到电子客票
将您的 TBO 账户连接到 PHPTRAVELS 机票模块，在网站和代理门户上销售 TBO 机票运价。每个运价在付款前都会复核，每次调用都带有追踪 ID，您的团队还能获得日志、重试规则和预订管理工具，让日常机票销售保持稳定。
- 实时 TBO 机票运价
- 付款前价格复核
- 每次调用都有追踪 ID
- B2C 结账与 B2B 门户
您销售的内容
在您自己的预订引擎中完成 TBO 机票 API 集成
TBO 是一家 B2B 旅游分销商，其机票 API 返回可供旅游企业转售的航班运价。PHPTRAVELS 机票模块使用您自己的 TBO 凭证调用该 API，在搜索结果中展示运价，并完成整个预订流程：运价规则、价格复核、旅客信息、付款、预订和出票。
并非所有运价的处理方式都相同。视运价而定，有些（通常是低成本航空）在一步内完成预订和出票，另一些则可以先占座保留、稍后出票。模块会让团队清楚看到这一差异，确保没有任何运价在缺少正确后续步骤的情况下被收款。
- LCC06:10 – 08:253h 45m · 直飞₹18,450选择
- FSC09:40 – 11:503h 40m · 直飞₹21,980选择
- FSC21:15 – 23:353h 50m · 直飞₹26,300选择
示例运价。每条结果都保留供应商标签，客服随时知道来源。
调用链
从搜索到出票之间的六次调用
选择一个步骤，查看 TBO 返回什么、PHPTRAVELS 如何处理，以及这一步通常会出什么问题。
搜索
- 返回内容
- 按航线、日期、舱位和旅客组合返回的运价，每条都带有供后续调用使用的结果令牌。
- PHPTRAVELS 的处理
- 统一结果格式，应用您的加价，缓存搜索，并提供航司、经停、行李和起飞时间筛选。
- 可能出现的问题
- 缓存运价展示过久。缓存时间很短，而且后续每一步都会复核。
运价规则
- 返回内容
- 所选运价的改签与退票条件、行李额度和运价说明。
- PHPTRAVELS 的处理
- 在运价卡片上显示规则，并在付款前再次显示；供应商提供结构化数据时以通俗语言呈现。
- 可能出现的问题
- 客户购买了自己并不了解的运价，之后要求运价不允许的退款。
价格复核
- 返回内容
- 客户所选运价的当前价格和可售状态。
- PHPTRAVELS 的处理
- 与展示价格进行比较。价格相同则继续；价格上涨则请客户确认；运价已售完则返回搜索结果。
- 可能出现的问题
- 按旧价格收取已变动运价的费用，导致纠纷和人工退款。
附加服务
- 返回内容
- 航司和运价提供的座位、餐食和额外行李。
- PHPTRAVELS 的处理
- 列出各选项及价格，并在付款前计入预订总额。
- 可能出现的问题
- 售出运价无法承载的附加服务。只提供接口返回的选项。
预订
- 返回内容
- 预订编号；若座位或价格已不存在，则返回失败原因。
- PHPTRAVELS 的处理
- 保存预订及其追踪 ID、旅客数据和付款记录，并启动预订时间线。
- 可能出现的问题
- 付款后发生超时。模块会先查询预订状态，绝不直接发送第二次预订。
出票
- 返回内容
- 航司出票后每位旅客的电子客票号。
- PHPTRAVELS 的处理
- 保存客票号，邮件发送行程单，并开放该预订的改签、取消和退款操作。
- 可能出现的问题
- 保留的预订一直未出票直至过期。保留的预订带有团队可见的截止时间。
价格复核
任何人付款之前，运价都会再查一次
大多数失败的机票预订，都始于搜索和付款之间发生变化的价格。试试结账流程处理的三种结果。
- 搜索时价格
- ₹18,450
- 复核时价格
- ₹18,450
- 差额
- ₹0
按客户看到的价格继续付款。
- 搜索时价格
- ₹18,450
- 复核时价格
- ₹19,120
- 差额
- ₹+670
客户看到新价格并在付款前确认。确认之前不会收取任何费用。
- 搜索时价格
- ₹18,450
- 复核时价格
- 不可售
- 差额
- —
客户返回新的搜索结果，原搜索条件和旅客信息已自动填好。
一名成人的示例数字。
运营
一个追踪 ID 贯穿预订的每一次调用
当某个预订需要处理时，客服打开它的追踪记录，按顺序查看发生了什么，而不必请开发人员翻查服务器日志。
trace TBO-FL-7Q2K9 --route DEL-DXB --pax ADT1
- 10:02:11INFOsearch已缓存本次搜索的结果
- 10:03:40INFOrules已为所选运价附加运价规则和行李信息
- 10:05:02WARNrecheck价格已变化，请客户确认新运价
- 10:05:31OKrecheck客户已接受新运价
- 10:06:12INFOpay本追踪仅收款一次
- 10:06:19WARNbook供应商超时，改为发送状态查询而非第二次预订
- 10:06:27OKstatus状态查询确认预订成功，已保存预订编号
- 10:06:40OKticket已保存电子客票号，行程单已发送
示例追踪：价格发生变化，客户接受了新价格，预订调用超时，随后通过状态查询确认了预订，没有重复预订。
请求日志和追踪 ID
每次搜索、复核、预订和出票调用都记录在同一个编号下，问题可以迅速定位。
测试航线库
一组固定的航线、日期、舱位和旅客组合，每次变更后都运行一遍。
超时与重试策略
在短暂网络故障后恢复，同时避免重复预订的风险。
故障激增告警
错误率上升时通知您的团队，赶在影响销售之前处理。
上线计划
销售 TBO 运价的五个步骤
团队往往因为太晚发现运营需求而浪费数周。这份计划把它们放在最前面。
- 01
账户与凭证
开通 TBO 账户，申请机票 API 权限并获取测试凭证。
- 02
连接与验证
在后台填入凭证，设置超时时间，并运行测试航线库。
- 03
搜索与价格控制
设置加价、币种和筛选条件，确认复核后的价格与结账价格一致。
- 04
预订与确认
端到端测试旅客信息、付款、预订、出票和行程单邮件。
- 05
运营与扩展
切换到正式凭证，设置告警和客服流程，然后开放流量。
测试航线库
| 航线 | 行程 | 旅客 | 舱位 | 验证内容 |
|---|---|---|---|---|
| DEL → BOM | OW | 1 ADT | Y | 基础国内运价和即时出票 |
| BOM → DXB | RT | 2 ADT · 1 CHD | Y | 儿童价格与去程回程配对 |
| DEL → LHR | RT | 1 ADT · 1 INF | Y | 婴儿价格与护照字段 |
| BLR → SIN | OW | 1 ADT | C | 商务舱运价及其规则 |
| HYD → JED | OW | 2 ADT | Y | 长航段的行李规则 |
请使用您实际销售的航线；以上仅为示例。
需要时提供交付支持
- 启动与范围航线、市场、定价规则和业务流程需求。
- 实施与测试搜索、复核和预订成功率测试。
- 上线支持监控手册以及向您客服团队的交接。
方案
销售 TBO 机票的几种方式对比
每种方式都可行。区别在于您需要自己构建和运营多少内容。
| 方案 | 上线时间 | 持续工作量 | 通常适合 |
|---|---|---|---|
| 直接基于 TBO API 开发 | 上线时间中到长：界面、定价、复核、日志和客服工具都要自己构建 | 持续工作量高 | 通常适合拥有内部开发和运营团队的大型团队 |
| GDS 连接 | 上线时间长：开通和实施都更复杂 | 持续工作量高 | 通常适合复杂的航司内容需求 |
| 其他聚合商 API | 上线时间中：起步快，但售后工作仍由您承担 | 持续工作量中 | 通常适合快速推出第一个版本 |
| PHPTRAVELS 搭配 TBO开箱即用 | 上线时间更短：预订流程和管理工具已经就绪 | 持续工作量低到中 | 通常适合OTA、旅行社、旅游批发商和 DMC |
PHPTRAVELS 采用一次性授权，按商业许可提供源代码，安装在您自己的服务器上。TBO 合同和凭证仍归您所有。
先确认您的 TBO 账户已开通机票 API 权限并获取测试凭证。然后将其填入机票模块，用一小组真实航线和日期跑通搜索、复核、预订和取消，最后再打磨客户体验。
搜索与付款之间的价格变化、客户没有看到的运价规则限制，以及确认过程中的超时。模块在付款前复核每个运价，用一个追踪 ID 记录每一步，并在超时后查询预订状态，而不是再次预订。
可以。一个预订引擎同时服务两者：客户使用公开结账流程，代理在代理门户中拥有自己的价格、加价和报表。
不需要。许多团队保留原有的 CRM 或财务工具，通过 API 和 webhook 与预订引擎连接，在不改变办公流程的前提下增加机票销售。
TBO 酒店使用住宿模块中的独立连接器。在合同允许的情况下，您可以用同一套 TBO 账户信息开启机票、酒店或两者。
可以。酒店、旅游产品、租车和接送都可以后续添加，同时保持一个客户账户、一个结账流程和一套报表。