机票API对接
面向旅行社的Kiwi API对接
通过Tequila API将Kiwi.com机票内容接入您的PHPTRAVELS预订网站。Kiwi.com返回行程并完成预订；PHPTRAVELS负责搜索、结账、加价和旅行社后台管理。
- 机票类别中的Kiwi模块
- 单程、往返和多城市
- 每个Kiwi.com票价均可加价
- docs.phptravels.com上的配置指南
工作方式
在您自己的预订平台中销售Kiwi.com机票
Kiwi API对接连接两部分：客户使用的预订网站，以及为其提供机票结果的Kiwi.com Tequila账户。PHPTRAVELS在机票类别中提供Kiwi模块。您在后台输入AffilID和API密钥，模块会向Tequila验证凭证，之后搜索即可返回已加价的Kiwi.com行程。Tequila访问权限由Kiwi.com授予，请在规划上线前确认您的账户。
- 向Kiwi.com申请Tequila API访问权限，获取AffilID和API密钥
- 在PHPTRAVELS后台打开“模块”，在Kiwi设置中输入两项凭证
- 保存后运行凭证检查，即向Tequila API发起一次真实的机场查询
- 设置加价，并核对成人、儿童和婴儿票价
- 在向所有客户开放Kiwi.com票价之前，先完成少量真实预订
- 环境
- 仅生产环境
- AffilID
- youragency_affil
- 接口地址
- Tequila API v2 · api.tequila.kiwi.com
- API密钥
- ••••••••••••••••
- 加价
- Kiwi.com票价加价6%
搜索与预订
Kiwi.com行程进入搜索结果，预订进入您的后台
每条Kiwi.com结果都包含航空公司、航班时间、舱位和行李额度，以及结账时预订该行程所需的预订令牌。
- Direct07:15 BCN → 08:40 STN直飞 · 经济舱 · 手提行李10公斤US$64总价
- 1 stop10:05 BCN → 14:30 LHR经停1次 · 经济舱 · 托运行李20公斤US$118总价
- 18:50 BCN → 20:10 LGW直飞 · 经济舱 · 托运行李15公斤US$92总价
单程和往返搜索
出发地、目的地、日期、乘客、舱位和币种发送到Tequila搜索接口，匹配的Kiwi.com行程返回到您的结果中。
多城市行程
多城市请求的每一段都会单独向Kiwi.com搜索，再将结果组合成完整行程。
舱位等级
经济舱、高端经济舱、商务舱和头等舱对应Kiwi.com要求的舱位代码。
结果中显示行李额度
Kiwi.com提供的托运和手提行李重量随每个票价显示，方便客户对比。
加价与分乘客价格
您的加价叠加在Kiwi.com价格之上，成人、儿童和婴儿价格与供应商成本一并保存。
凭令牌预订
确认时，模块将预订令牌和乘客信息发送到Tequila预订接口。
预订流程
从Kiwi.com搜索到预订确认
一个Kiwi.com票价在您网站上的完整路径，包括客户付款之后的环节。
搜索
客户的行程、乘客和舱位发送到Kiwi.com，返回可选行程。
定价
应用您的加价，并以客户选择的币种显示票价。
结账
为每位旅客收集姓名、称谓、国籍、邮箱和电话。
预订
将预订令牌和乘客名单发送到Kiwi.com以创建预订。
售后
取消和退款需通过Kiwi.com客服申请，而非通过API。
职责分工
Kiwi API对接中各方的职责
可用的Kiwi.com连接需要一个预订平台、一个已获批的Tequila账户，以及旅行社的售后流程。
PHPTRAVELS：您的预订平台
网站、Kiwi模块设置、加价、结账和预订管理。您的套餐决定更多B2C和B2B工具。
Kiwi.com：您的机票内容
通过Tequila API提供行程、价格和预订。访问权限、航线和售后规则由Kiwi.com和航空公司决定。
您的旅行社：商业流程
销售价格、客户付款和客服，包括旅客要求取消或变更时由谁联系Kiwi.com。
后台管理
在后台管理Kiwi.com机票销售
Kiwi.com预订的凭证、定价和售后规则，与您其他旅游业务在同一后台。
模块设置
AffilID和API密钥保存在“模块”中，即时检查会提示密钥缺失、无效或超出调用限制。
加价与供应商成本
每笔预订都保存加价后的售价和Kiwi.com原价，每笔订单的利润一目了然。
币种
搜索按客户币种请求价格，同一币种随预订数据一起保存。
取消申请
Kiwi.com不支持通过API取消，后台会标记这些预订，由您的团队向Kiwi.com客服提交。
B2C和B2B渠道
决定Kiwi.com票价面向公开网站、代理还是两者，并分别验证定价。
扩展流程
额外行李、选座或模块以外的其他步骤，可作为集成定制进行评估。
对比
自行基于Kiwi.com API开发与使用PHPTRAVELS对比
Kiwi.com提供机票API，但您仍需要一个完整的预订产品。以下是自主开发与PHPTRAVELS通常的差别。
| 方面 | 基于Tequila自主开发 | PHPTRAVELS |
|---|---|---|
| 客户网站 | 基于Tequila自主开发搜索、结果和结账页面需从零设计和开发 | PHPTRAVELS品牌化的机票搜索、结果和结账已就绪 |
| Kiwi.com连接 | 基于Tequila自主开发搜索、多城市和预订调用需自行编写和测试 | PHPTRAVELS现成的Kiwi模块，含凭证检查和加价 |
| 后台与利润 | 基于Tequila自主开发预订后台和定价规则仍需开发 | PHPTRAVELS预订、供应商成本和售价集中在一个后台 |
| 代理渠道 | 基于Tequila自主开发B2B门户是另一个独立项目 | PHPTRAVELS平台内置B2B和B2C工具，视套餐而定 |
| 其他供应商 | 基于Tequila自主开发每个新航司来源或产品都要重新开发 | PHPTRAVELS同一安装中还有机票、酒店、旅游和租车等模块 |
适用场景
哪些企业将Kiwi.com接入PHPTRAVELS
新的在线旅行社
以Kiwi.com行程作为首个内容来源上线机票预订网站，之后再添加更多供应商。
经济型和休闲旅行社
销售短途和休闲航线，每个票价都标明行李额度，并与自有套餐一起销售。
B2B代理网络
按套餐约定，为合作代理提供Kiwi.com票价，并设置各自的访问权限和定价规则。
为什么选择PHPTRAVELS
您的Kiwi.com账户、您的平台、您的代码
包含源代码
按商业许可自托管，您的开发人员可以扩展Kiwi.com流程。
您的Tequila凭证
AffilID和API密钥由您持有，保存在您自己的安装中。
有文档的配置
docs.phptravels.com机票板块中提供Kiwi模块指南。
B2C和B2B
一次安装同时支持公开网站和代理门户，提供24种语言。
它通过机票类别中的Kiwi模块，将Kiwi.com Tequila API连接到您的PHPTRAVELS预订平台。Kiwi.com提供行程并接收预订；PHPTRAVELS提供客户网站、加价和旅行社后台管理。
Tequila访问权限由Kiwi.com授予。获批后您将获得AffilID和API密钥，并在Kiwi模块设置中填写。资格和商务条款请直接与Kiwi.com确认。
该模块仅连接Kiwi.com生产环境API，并会拒绝示例密钥。在向客户开放之前，请先完成少量真实预订，或仅向员工账户开放Kiwi.com票价进行验证。
支持。单程和往返使用一次搜索；多城市请求会分别向Kiwi.com搜索每一段，再合并结果。
不可以。模块使用的Kiwi.com API不提供取消或退款功能。您的团队需通过Kiwi.com客服申请，是否符合条件取决于Kiwi.com和航空公司的规则。
不要默认功能完全一致。额外行李、选座等服务需根据您的PHPTRAVELS版本和Kiwi.com账户确认，并可作为定制添加。