FR 集成

Ryanair 专属预订流程，包含订单确认、价格透明展示和儿童座位规则。

当你接入 Ryanair 预订流程时，使用这个页面。

什么时候使用这条流程

以下场景使用 FR 流程：

• 航司为 FR

• 最终支付前必须先做订单确认

• 需要弹窗或 iframe 确认页

• 需要遵守 Ryanair 的展示和儿童座位规则

FR 与标准流程的区别

相比标准预订流程，FR 多了这些要求：

• 票价和附加服务费用必须拆开展示

• FR 确认页必须收集旅客明确同意

• 支付前必须先调用 orderCommit.do

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

• 需要 FR 专用的 UAT 和 IP 白名单

标准 FR 预订流程

1

搜索

调用 搜索，保存选中的 routingIdentifier。

2

验价

调用 验价，保存返回的 sessionId。

3

创建订单

调用 创建订单，传入乘客、联系人和 FR 必填字段。

这个阶段可以先向用户收款。 但不要立刻调用 pay.do。

4

确认订单

调用 确认订单。 使用弹窗模式或 iframe 模式向用户展示 FR 确认页。

5

支付与出票

只有在用户完成确认后，才能调用 支付与出票。

6

轮询最终状态

调用 查询订单，直到 orderStatus=2 且 ticketStatus=0。

确认订单模式

弹窗模式

传入订单号和 redirectUri。 Atlas 返回 confirmationUrl。 把用户跳转到该页面。

用户确认后，FR 会跳回你的 redirectUri。

Iframe 模式

传入订单号，并设置 iframe=true。 Atlas 返回 confirmationUrl。 在你的 iframe 流程中展示该页面。

iframe 模式下会忽略 redirectUri。

支付时机规则

订单确认完成前，不要调用 pay.do。

如果用户在建单后 30 分钟内没有完成确认：

• 订单会过期

• Atlas 不会继续出票

• 如果 OTA 已向终端用户收款，应自行退款

FR 必要业务规则

价格透明展示

以下费用需要拆开展示：

• 航司票价

• 航司支付手续费

• Atlas 服务费

• 分销商加价

• 附加服务费用

支付手续费请读取搜索和验价响应里的 cardChargeList。

旅客同意

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

• 服务条款

• 隐私政策

• Cookie 政策

• myRyanair 账号确认

联系信息

需要同时传：

• 乘客邮箱

• clientContact 中的分销商邮箱和公司名称

这样能确保双方都能收到航司通知。

儿童座位规则

订单中包含 12 岁以下儿童时，FR 有特殊规则。

关键规则

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

• 至少一名成人可能必须购买付费座位

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

• 支付前可能必须先选座

Atlas 简化接入方案

如果你暂时还不能完整支持 FR 儿童选座逻辑：

1. 关闭选座

2. 收取强制座位费

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

金额读取搜索和验价响应中的 childMandatorySeatingFee。

同时确保单个订单中的儿童数不超过 4 名。

如果 FR 儿童座位逻辑还没准备好，请先拦截这类订单。

UI 建议

建议最大宽度：

• popup：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 文件。

19KB

Ryan Air (FR) Atlas UAT Test Shopping & Ticketing Services Only Template.xlsx

Open

相关页面

• 确认订单

• 支付与出票

• UAT 验证

• 特殊集成