旅游与活动 API
面向旅行社的Viator API 集成
通过 Viator Partner API，将 Viator 的旅游、景点和活动加入您的 PHPTRAVELS 预订网站。Viator 提供产品、价格、行程和评价；PHPTRAVELS 负责搜索、加价、货币和预订记录。
- 旅游类别中的 Viator 模块
- 沙盒与生产环境端点
- 每个 Viator 价格均可加价
- 行程、包含项目与评价
工作原理
在您自己的旅游网站中销售 Viator 体验
Viator API 集成将您的预订网站与 Viator 合作伙伴账户连接起来，让旅游和活动与您的机票、酒店一同展示。PHPTRAVELS 在旅游类别中提供 Viator 模块：在后台粘贴 Viator API 密钥，选择沙盒或生产环境，目的地搜索即可返回已加价的 Viator 产品。合作伙伴权限及其预订模式由 Viator 授予，请在规划上线前确认您的账户类型。
- 申请加入 Viator 合作伙伴计划并获取 API 密钥
- 在 PHPTRAVELS 后台打开模块，在 Viator 设置中填入密钥
- 选择沙盒环境并保存，运行凭证校验
- 设置加价，并测试主要目的地的搜索
- 结果和价格确认无误后切换到生产环境
- 环境
- 沙盒
- 端点
- Partner API v2 · api.sandbox.viator.com
- API 密钥
- ••••••••-••••-••••
- 加价
- Viator 价格加价 10%
- 显示货币
- 客户会话货币
搜索与详情
Viator 产品进入您的旅游结果，并附带客户关心的详情
每条 Viator 结果包含标题、起价、时长、评分和图片，详情页还会显示包含项目、不包含项目、行程站点和取消政策。
- 4.7★傍晚沙漠冲沙之旅含晚餐6 小时 · 评分 4.7 · 免费取消US$72每位成人
- 4.5★迪拜码头单桅帆船晚餐游船2 小时 · 列出包含与不包含项目US$58每位成人
- 从迪拜出发的阿布扎比一日游10 小时 · 行程附地图站点US$115每位成人
目的地搜索
目的地和日期发送至 Viator 自由文本产品搜索，支持价格和评分筛选，每页最多 100 个产品。
位置校验
结果会与产品地址和标题中的目的地进行比对，无关的备选旅游产品会从列表中剔除。
完整产品详情
详情页加载 Viator 产品：描述、包含项目、不包含项目和行程站点，Viator 提供时还会显示地图位置。
评分与评价
每个旅游产品都显示 Viator 的平均评分和评价总数，方便客户比较体验。
取消政策
Viator 取消政策文本会显示在产品页，并根据产品的政策类型标注是否可退款。
加价与货币
您的加价会叠加到 Viator 起价上并换算为客户货币，同时保存供应商价格。
预订流程
从 Viator 搜索到已记录的预订
在标准模块下，一个 Viator 产品在您网站上的完整路径。
搜索
目的地、日期和旅客信息发送至 Viator，返回匹配的产品。
定价
对每个起价应用您的加价和货币换算。
详情
客户打开产品，查看行程、包含项目和取消政策。
记录
在后台保存预订记录，包含旅客、供应商价格和销售价格。
在 Viator 完成
客户在新窗口中跳转到 Viator 产品页完成预订。
职责分工
Viator API 集成中的分工
一个可用的 Viator 连接需要预订平台、已获批准的 Viator 合作伙伴账户，以及关于由谁收款的明确约定。
PHPTRAVELS：您的预订平台
网站、Viator 模块设置、加价、货币、旅游页面和预订记录。您的套餐决定其他 B2C 和 B2B 工具。
Viator：您的体验内容
通过 Partner API 提供产品、价格、行程、评价和取消政策。访问级别和预订条款由 Viator 决定。
您的旅行社：商业流程
销售价格、客户沟通和售后支持，包括由谁与 Viator 处理变更和取消。
后台管理
在后台管理 Viator 销售
Viator 产品的凭证、定价和预订记录，与您自有的旅游产品及其他供应商在同一后台。
模块设置
API 密钥和环境保存在模块中，凭证校验会在上线前拒绝占位密钥。
供应商价格与销售价格
每条预订记录都并列保存 Viator 价格和您加价后的成人、儿童价格，每笔预订的利润一目了然。
货币
Viator 价格从产品货币换算为客户会话货币，两种货币均会保存。
与自有旅游产品并存
Viator 产品与您在旅游模块中创建的产品并列，共用一个搜索和一个后台。
Viator Merchant 模块
独立模块可保存并校验 Viator Merchant API 密钥和 Merchant ID，适用于该模式的账户。
在您的网站上结账
在您自己的结账流程中收款并确认 Viator 预订，按项目作为定制开发评估。
对比
自行基于 Viator API 开发 vs PHPTRAVELS
Viator 提供产品 API，您仍需要围绕它的预订网站。以下是自行开发通常涉及的工作与 PHPTRAVELS 的对比。
| 方面 | 基于 Viator API 自行开发 | PHPTRAVELS |
|---|---|---|
| 旅游网站 | 基于 Viator API 自行开发搜索、结果和产品页需从零设计和开发 | PHPTRAVELS品牌化的旅游搜索、结果和详情页已就绪 |
| Viator 连接 | 基于 Viator API 自行开发搜索、产品详情和定价调用需自行编写和测试 | PHPTRAVELS现成的 Viator 模块，含沙盒、凭证校验和加价 |
| 产品内容 | 基于 Viator API 自行开发行程、包含项目和评价的映射仍需开发 | PHPTRAVELS包含项目、不包含项目、行程、评价和政策已映射 |
| 后台与利润 | 基于 Viator API 自行开发预订记录和定价规则仍需开发 | PHPTRAVELS每笔预订都保存供应商价格和销售价格 |
| 其他产品 | 基于 Viator API 自行开发机票、酒店和自有旅游产品各是独立项目 | PHPTRAVELS机票、酒店、租车和自有旅游模块在同一安装中 |
应用场景
谁在将 Viator 接入 PHPTRAVELS
在线旅行社
在机票和酒店旁增加当地活动，让旅客在一个网站上规划整个行程。
目的地管理公司
在您未自营所有旅游产品的目的地，将自有短途游与 Viator 产品组合销售。
旅游内容发布者
将目的地指南变成预订网站，为您覆盖的每个城市列出 Viator 体验。
为什么选择 PHPTRAVELS
您的 Viator 账户、您的平台、您的代码
包含源代码
基于商业许可自托管，您的开发人员可以扩展 Viator 流程。
您的 Viator 凭证
API 密钥由您持有，保存在您自己的安装中，并在保存时校验。
先用沙盒
在将模块切换到生产环境之前，先用 Viator 沙盒端点测试。
B2C 与 B2B
一个安装同时支持公开网站和代理门户，支持 24 种语言。
它通过旅游类别中的 Viator 模块，将 Viator Partner API 连接到您的 PHPTRAVELS 预订平台。Viator 提供带价格、行程和评价的旅游与活动；PHPTRAVELS 提供网站、加价、货币和预订记录。
Viator 通过其合作伙伴计划授予 API 访问权限。获批后您会收到 API 密钥，将其填入 Viator 模块设置即可。资格、访问级别和商业条款请直接与 Viator 确认。
有。模块可以指向 Viator 沙盒端点或生产环境，凭证校验会针对您所选的环境运行。请在测试搜索和价格之后再切换到生产环境。
使用标准模块时，PHPTRAVELS 会保存包含旅客和价格的预订记录，然后打开 Viator 产品页，由客户在那里完成预订。在您自己的结账流程中付款和确认，按定制开发评估。
可以。您在 PHPTRAVELS 旅游模块中创建的产品与 Viator 产品共用同一搜索和后台，Tiqets 也可作为另一个旅游供应商接入。
docs.phptravels.com 上尚未发布专门的 Viator 指南。设置只需在模块设置中填写 API 密钥并选择环境，PHPTRAVELS 团队可在上线过程中提供帮助。