航班 API 集成
面向旅行社和 OTA 的PKFARE API 集成
在您自己的预订网站和代理门户上销售 PKFARE 航班内容。PKFARE 提供票价并创建订单；PHPTRAVELS 在同一个后台中负责搜索、结账、加价、付款、PNR 记录和售后。
- 单程、往返和多程
- 每个票价都显示退改规则和行李额
- 付款后生成订单和 PNR
- docs.phptravels.com 上的设置指南
工作原理
在您自己的预订引擎中销售 PKFARE 航班
PKFARE API 集成将客户和代理使用的预订网站与为其提供航班结果的 PKFARE 账户连接起来。PHPTRAVELS 在航班类别中提供 PKFARE 模块：输入您的 partner ID 和 API key 后，每个请求都会使用它们签名，搜索将返回已应用您的加价和币种的 PKFARE 票价。付款确认后，预订会发送到 PKFARE，订单号和 PNR 会保存在该预订中。访问权限和商务条款由 PKFARE 决定，因此请在规划上线前确认您的账户。
- 与 PKFARE 确认访问权限和范围，获取 partner ID 和 API key
- 在 PHPTRAVELS 后台打开模块，在 PKFARE 设置中填写这两项
- 设置加价和币种，并检查成人、儿童和婴儿价格
- 用少量真实预订测试搜索、付款、PNR 和取消
- 将 PKFARE 票价开放给您的 B2C 网站、代理或两者
- 环境
- 生产环境
- Partner ID
- youragency_partner
- 接口地址
- api.pkfare.com · 搜索与预订
- API key
- ••••••••••••••••
- 加价
- B2C 7% · 代理 4%
搜索与票价
PKFARE 票价附带规则、行李额和按乘客计价
每条 PKFARE 结果都包含旅客付款前会比较的信息：航班时间、经停、舱位、托运和手提行李额、退改规则以及您的售价。
- Direct08:05 HKG → 11:55 SIN直飞 · 经济舱 · 托运 30 公斤 · 手提 7 公斤US$412总价
- 1 stop13:20 HKG → 21:45 SIN经 KUL 中转 1 次 · 经济舱 · 托运 20 公斤US$338总价
- 19:40 HKG → 23:30 SIN直飞 · 商务舱 · 托运 40 公斤US$1,184总价
单程和往返搜索
出发地、目的地、日期、乘客、舱位和币种发送到 PKFARE 搜索 API，匹配的票价返回到您的结果中。
一次请求完成多程搜索
PKFARE 支持一次提交多个航段，因此多程行程只需一次调用即可搜索，并作为一个行程定价。
四种舱位
经济舱、超级经济舱、商务舱和头等舱会映射为 PKFARE 所需的舱位值。
结果中显示行李额
PKFARE 提供的托运和手提行李额随每个票价显示，方便客户进行同等比较。
付款前就知道能否退票
PKFARE 的票价规则会把每条结果标记为可退或有退改费用，客户在结账前即可看到。
按乘客类型加价和换算币种
成人、儿童和婴儿的票价与税费分别加价，并分别换算为客户币种。
预订流程
从 PKFARE 搜索到带 PNR 的订单
一个 PKFARE 票价在您网站上的完整路径，包括客户付款之后发生的事情。
搜索
行程、乘客和舱位发送到 PKFARE，并返回票价。
定价
按乘客类型应用您的加价和币种。
结账
收集旅客姓名、护照信息和联系方式。
付款
客户通过您的支付网关付款，或代理从钱包中支付。
预订
付款后预订发送到 PKFARE，并保存订单号和 PNR。
取消
在后台按订单号向 PKFARE 发送取消请求，以 PKFARE 规则为准。
职责分工
PKFARE API 集成中各方的职责
一个可用的 PKFARE 连接需要预订平台、已获批准的 PKFARE 账户，以及旅行社的售后流程。
PHPTRAVELS：您的预订平台
网站、代理门户、PKFARE 模块设置、加价、结账、付款和预订管理。
PKFARE：您的航班内容
票价、可售座位、票价规则、订单和 PNR。访问权限、航线和出票条款由 PKFARE 和航空公司规定。
您的旅行社：商务流程
售价、客户收款和客户服务，包括按照 PKFARE 和航空公司规则处理的改签和退款。
后台管理
在您的后台管理 PKFARE 机票销售
PKFARE 的凭证、定价和预订记录，与您其他旅游业务在同一个后台中。
模块设置
Partner ID 和 API key 保存在您自己安装中的模块设置里，绝不会展示给客户。
加价与供应商成本
每个预订都会将售价与 PKFARE 票价和税费并列保存，每笔预订的利润一目了然。
订单和 PNR 记录
订单号、PNR、乘客、付款状态以及完整的 PKFARE 响应都与预订一起保存。
避免重复订单
已有确认 PNR 的预订在重试付款时不会再次发送到 PKFARE。
B2B 代理销售
代理在代理门户中以自己的加价和钱包余额预订 PKFARE 票价。
管理预订
员工按编号查找预订，在同一处查看乘客、行程、付款和备注，无需切换到其他门户。
对比
销售 PKFARE 航班的几种方式
合适的方式取决于您希望掌控多少客户旅程和后台流程。以下是常见方案的一般对比。
| 方面 | 供应商门户或自行开发 | PHPTRAVELS |
|---|---|---|
| 搜索 | 供应商门户或自行开发员工在供应商门户中查价，再复制到报价中 | PHPTRAVELSPKFARE 票价直接出现在您的品牌搜索和代理门户中 |
| 定价 | 供应商门户或自行开发手动加价或从零开发加价逻辑 | PHPTRAVELS按乘客类型自动应用加价和币种规则 |
| 预订 | 供应商门户或自行开发乘客信息需重新录入供应商门户 | PHPTRAVELS付款后自动创建订单和 PNR |
| 记录 | 供应商门户或自行开发供应商记录与内部备注分开保存 | PHPTRAVELS管理员、客户和代理共用同一条预订记录 |
| 上线时间 | 供应商门户或自行开发自行开发还需设计网站、后台和财务流程 | PHPTRAVELS现成的 PKFARE 模块，内置于完整的预订平台 |
使用场景
哪些企业将 PKFARE 接入 PHPTRAVELS
B2C 机票预订网站
公开的航班搜索、在线刷卡支付、客户账户和预订历史，集中在一个品牌网站中。
B2B 代理分销
为旅行社和批发商提供子代理登录、专属加价以及钱包或授信付款。
机票加酒店和旅游产品
OTA 和旅游运营商将 PKFARE 航班与酒店、旅游和接送组合在同一行程中。
为什么选择 PHPTRAVELS
您的 PKFARE 账户、您的平台、您的代码
包含源代码
在商业许可下自行托管，您的开发人员可以扩展 PKFARE 流程。
您的 PKFARE 凭证
partner ID 和 API key 由您持有，保存在您自己的安装中。
有文档的设置流程
docs.phptravels.com 航班部分提供 PKFARE 模块指南。
B2C 和 B2B
一套安装同时支持公开网站和代理门户，提供 24 种语言。
它通过航班类别中的 PKFARE 模块，将 PKFARE 的航班内容接入您的 PHPTRAVELS 预订平台，让客户和代理在您自己的网站上搜索、查看票价规则、付款并获得 PNR。
访问权限由 PKFARE 授予。获批后，您会收到 partner ID 和 API key，并在 PKFARE 模块设置中填写。资格和商务条款请直接与 PKFARE 确认。
供应商登录适合快速查询，但无法提供品牌预订引擎、自有结账流程、代理加价、发票或客户账户。许多旅行社保留登录账号用于客服，并通过集成进行销售。
订单号和 PNR 保存在预订中，员工可以在后台查看乘客、行程、付款状态和备注。取消请求按订单号发送到 PKFARE；能否取消、改签或退款以 PKFARE 和航空公司规则为准。
支持。可进行单程、往返和多程搜索，多程航段会在一次请求中发送到 PKFARE。
取决于您的套餐和启用的产品。套餐起价为 Startup $2499 一次性许可；请查看价格页面或向销售团队索取报价。PKFARE 的商务条款需与 PKFARE 约定。