构建取消政策
了解 Rapid Lodging API 如何构建和公开取消政策
概述
快速购物 API 会在 Availability 响应中返回每个价格的取消政策详情。每种价格的具体取消政策均由以下关键对象构成:
- tri-state 标志
current_refundability准确地表示了提出请求时利率的可退款性。 cancel_penalties对象定义了具有开始/结束日期、处罚类型和值的政策窗口。nonrefundable_date_ranges定义了预订中将保留 non-refundable 的入住日期(优先于cancel_penalties)。
注意:cancel_penalties.start 和 cancel_penalties.end中返回的 ISO-8601 偏移量是显示和计算所依据的权威值。这通常与当地房产时间一致,但可能反映 supplier-configured 时区数据,不应根据房产地址/地理位置重新计算。
本页上的所有示例都明确显示了偏移量(例如,GMT+7:00),以强调您应该保留并按给定方式显示它。
准则
可退款性
使用 current_refundability作为 refundability-driven 逻辑和用户体验的主要控件;它是策略配置最准确的表示,尤其适用于 partial-penalty 场景。
| 值 | 含义 |
|---|---|
refundable | 可全额退款 |
non_refundable | 不予退款 |
partially_refundable | 罚款金额大于 0 但小于预订总额,和/或住宿期间存在 non-refundable 日期范围 |
refundable布尔值可以显示保单的可退款性,但其功能有限,无法完全描述部分或复杂的罚款是如何运作的,也无法说明是否可能适用其他费用。预订时不可全额退款的任何价格将显示refundable=false。
Non-refundable 日期范围
使用 nonrefundable_date_ranges 对象设置在预订时不可退款的住宿日期是可选的。请注意,nonrefundable_date_range包含每晚房价以及任何税费。
如果价格在 nonrefundable_date_ranges对象中定义了 non-refundable 日期,则这些晚数将与 cancel_penalties对象中规定的任何其他取消罚款一起收取。
住宿服务费
在提及取消预订时应支付的费用时,最佳做法是使用“物业费”而不是“取消费”一词,以便更准确地反映谁收取费用以及为什么需要收取该费用。