For the complete documentation index, see llms.txt. This page is also available as Markdown.

FR 集成

瑞安航空(FR)特定预订流程,包括订单确认、价格透明度和儿童座位规则。

💬 需要帮助? 如果遇到问题,请在帮助中心咨询 Eva,快速获取诊断建议。

咨询 Eva

当您集成瑞安航空(FR)预订流程时使用此页面。

何时使用此流程

在以下情况下使用 FR 流程:

  • 航司代码为 FR

  • 最终支付前需要订单确认

  • 需要弹窗或 iframe 确认

  • 适用瑞安航空特定的展示和儿童座位规则

FR 与标准流程的区别

与常规预订流程相比,FR 增加了额外要求:

  • 运价和附加服务费用的价格透明度

  • 在 FR 确认页面上获取明确的乘客同意

  • 支付前必须执行 orderCommit.do 步骤

  • 儿童座位场景的特殊处理

  • FR 特定的 UAT 和 IP 白名单

FR 工作流图

此流程在 order.dopay.do 之间增加了一个 FR 确认页面。

FR 预订流程

1

搜索

调用 搜索 并保存选定的 routingIdentifier

2

验价

调用 验价 并保存返回的 sessionId

3

可选座位选择

如果您支持 FR 座位选择,请在预订前调用 座位

如果您使用 FR 儿童座位简化方案,请跳过此步骤。

4

创建订单

使用乘客信息、联系方式和所需的 FR 字段调用 创建订单

确保订单请求包含:

  • 乘客邮箱

  • 订阅方邮箱

  • 订阅方公司名称(在 clientContact 中)

  • locale

5

收款并提交订单

在此阶段,OTA 向用户收款。 请不要调用 pay.do

然后调用 确认订单

Atlas 返回 confirmationUrl,用于弹窗模式或 iframe 模式。

6

用户在 FR 页面确认

向用户展示 confirmationUrl

FR 确认页面包含所需的条款与条件以及同意复选框。用户必须在出票前完成此步骤。

7

支付与出票

仅在用户完成确认后,调用 支付与出票

支付可使用 VCCDeposit

8

轮询最终状态

使用 查询订单 直到 orderStatus=2ticketStatus=0

确认订单模式

弹窗模式

发送订单号和一个 redirectUri。 Atlas 返回 confirmationUrl。 将终端用户重定向到该页面。

准备一个重定向页面 URL 并与 Atlas 共享。 该页面应接受 AtlasOrderNumber 作为输入参数。

用户确认后,FR 将用户重定向回您的 redirectUri

Iframe 模式

发送订单号并设置 iframe=true。 Atlas 返回 confirmationUrl。 在您的 iframe 流程中展示该页面。

在 iframe 模式下,redirectUri 将被忽略。

支付时机规则

在订单确认完成之前,不要调用 pay.do

如果用户在订单创建后 30 分钟内未确认:

  • 订单状态变为 Expired(已过期)

  • Atlas 不会出票

  • 如已收款,OTA 应向终端用户退款

如果在用户完成 FR 确认之前尝试调用 pay.do,航司支付可能失败,订单可能被取消。

必需的 FR 业务规则

价格透明度

将航司运价与以下费用分开展示:

  • 航司支付手续费

  • Atlas 服务费

  • 订阅方加价

  • 附加服务费用

从搜索和验价响应中的 cardChargeList 读取支付手续费数据。

确保用户能够清晰识别 Ryanair 的实际价格。

乘客同意

FR 确认页面必须收集用户对以下内容的同意:

  • 服务条款

  • 隐私政策

  • Cookie 政策

  • myRyanair 账户确认

联系信息

同时提供:

  • 乘客邮箱

  • 订阅方邮箱和公司名称(在 clientContact 中)

  • 必需的预订 locale

这有助于确保双方都能收到航司通知。

有关支持的 locale 值,请参阅 语言环境参考

儿童座位规则

当包含 12 岁以下儿童时,FR 适用特殊规则。

重要行为

  • 每位成人最多携带 4 名儿童

  • 至少一名成人可能需要付费座位

  • 儿童必须与陪同成人坐在同一排

  • 支付前座位选择可能变为强制要求

Atlas 简化选项

如果您尚未准备好支持 FR 带儿童的全量座位选择逻辑:

  1. 禁用座位选择

  2. 收取强制性座位费

  3. 让 Atlas 自动分配第一名成人和儿童的座位

使用搜索和验价响应中的 childMandatorySeatingFee

同时确保每个预订中儿童数量不超过 4 名。

UI 指导

推荐最大宽度:

  • 弹窗:1028px

  • iframe:1028px

建议的桌面/移动端断点:

  • 768px

UAT 要求

IP 白名单

在开始实时 FR 预订测试之前,提供静态 IP 地址用于 Ryanair 白名单。

FR 沙箱 VCC 测试卡

卡号
类型

5200000000002235

Mastercard,批准

4000000000002701

Visa,批准

5476850000000002

拒绝卡

5100000014101198

拒绝卡

使用拒绝卡验证支付失败处理。

FR 测试航线

  • DUB-KIR

  • KIR-DUB

  • DUB-LON

  • LON-DUB

  • MAN-DUB

  • DUB-MAN

UAT 场景

使用下面的 FR 特定 UAT 文件。

相关页面

Last updated

Was this helpful?