住宿收款模式下的付款
访问允许旅行者亲自付款的房源预订页面。
如何运作
住宿收款允许您访问需要旅客到店付款的住宿，而不是以预付方式在线付款。住宿收款预订要求旅客提供详细信用卡信息以作担保。此功能使用 property_collect 参数。
>> 请参阅购物 API 文档，了解完整的 API 集成详情。
由于您将要处理详细信用卡信息，这部分 API 要求您符合 PCI 要求。
潜在交易
通过住宿收款选项进行预订，住宿接待方将在客户入住时向客户收款。但是，在以下情况下，住宿或 Rapid 可以在客户到达之前对付款卡进行交易：
- 交易预授权： 需要一张有足够资金的信用卡来担保房产预订。酒店可能会要求预授权，即发卡机构会冻结持卡人授权的金额，而不是直接从卡中扣款。如果客户完成预订交易，付款人的银行通常会在几个月内自动释放资金。
>> 阅读更多关于 pre-authorization 的信息 - **象征性金额的交易结 算：**作为住宿收款预订担保的替代选项，住宿接待方可能会收取象征性金额以验证付款卡。这种行为是旅游接待行业的常见做法。随后，支付的金额将会退还或从应在住宿支付的最终款项中扣除。
- **部分或全部不可退款：**当住宿收款预订进入部分/全部不可退款期限内时，住宿可能会收取不可退款部分的费用。支付的金额将会退还或从应在住宿支付的最终款项中扣除。取消政策由选购 API 的响应元素
refundable=false和<cancel_penalties>返回。 - 物业收取押金： 物业收取押金清单为物业提供了根据时间表收取押金的选项。默认 API 配置已包含此库存。
>> 阅读更多关于押金房产收取的信息 - No-show: 如果顾客未入住第一晚，酒店或 Rapid* 将根据取消政策向支付卡收取 no-show 罚款（最高可达预订金额的 100%）。
- **逾期取消：**在免费取消截止日期之后取消订单将产生手续费。住宿或 Rapid* 根据取消政策从付款卡中收取取消手续费。
- **免费取消：**如果客户在免费取消截止日期之前取消了住宿收款预订，但在付款卡账单上仍然看到住宿收取了费用，我们建议客户直接与住宿接待方联系以确保退款。
- **虚拟卡和企业卡：**如果您计划将虚拟卡或企业卡集成到预订房产库存中，请先与您的 Rapid 合作伙伴连接代表讨论此事。
>> 了解虚拟卡或企业卡
**注意：**仅当房产或支付卡涉及 SCA 合规性时，Rapid 才会成为房产收款预订的记录商户。您可以要求我们为您排除此类潜在住宿，并集成注册付款信息 API 以确认付款卡是否需要双重身份验证。它可以帮助您识别交易来源。Rapid 交易的账单描述符默认显示为“travel reservation”，也可根据您的要求自定义。
>> 了解注册支付 API >> 更多关于计费描述符的信息 >> 阅读更多关于 SCA 合规性的信息
货币
Rapid 内容会针对每家住宿返回 onsite_payments.currency 以指明住宿在入住时接受的货币，以防客户需要在店内支付任何费用，例如洗衣服务和迷你吧消费。住宿设置此货币，与预订使用的信用卡交易货币无关。
作为住宿收款预订货币的独立来源，totals.inclusive.billable_currency 中的信息会在 Rapid 选购 API 和 Rapid 管理预订 API 中返回，这将有助于客户了解正确币种的预订价值。
此外，totals.inclusive.request_currency 会按照您要求的货币提供信息，这通常也是客户的首选货币。
注意：onsite_payments.currency 和 totals.inclusive.billable_currency.currency 值可能不同。
记账货币是住宿接待方用于向住宿收款预订提供的卡收取费用的货币。记账货币由住宿接待方在定义其住宿收款价格时规定。住宿接待方可能会以非当地货币（店内付款货币）的记账货币发布住宿收款价格。费用（例如逾期取消手续费）将以这种记账货币向付款卡收取。
用户界面示例
欧元是客户的首选货币；美元是预订货币；埃及镑是当地货币：
住宿取消
对于住宿收款预订，住宿接待方在初次确认后最迟可在 72 小时内取消订单。请注意，正确处理这些取消并发送消息是我们住宿收款上线要求的一部分。
住宿取消的最常见原因之一是信用卡无效。大多数住宿不会冒险接待无法在入住前提供有效付款方式的旅客。确保您的卡号确认流程符合我们的建议，以尽量减少发生此类取消情况。
取消通知
- 如果您预订的是酒店到店自取价格，我们建议您启用通知服务，以便及时了解酒店取消预订的情况。
- 如果我们没有从您的端点收到确认接收信息（200 OK 状态代码），通知服务将认为该消息无法送达，并且该消息将排队等待重试。使用通知无法送达 API 检索过去 7 天内所有无法送达的消息。 - 如果您的集成项目中有任何相关系统未能与通知服务集成，住宿取消则可能不会向旅客显示或可能会被误认为是客户要求的取消。
- 除了通知无法送达 API 之外，Rapid 客服或 Affiliate Voyager（若设置中包含）也可以帮助您查看预订取消的来源。
- 如果您将行程状态值用作 API-based self-service 系统的一部分，或用于触发您自己的客户电子邮件通知，则可以使用“管理预订 API”来更新预订状态并核对您的系统中的取消。
有两种方法可以随时了解住宿取消情况：
Rapid 通知
Rapid 将通过标准的 POST 消息将变更详细信息直接推送到您的系统。当发生可能影响您业务的变更时，我们的通知服务会立即将变更详细信息发送到您的系统，以便您实时了解变更情况。
Rapid 自动化电子邮件通知
当住宿取消预订时，Rapid 总能直接向您发送联盟伙伴电子邮件通知，但您必须负责管理旅客通信。我们的自动化电子邮件系统会提醒您有关住宿取消的情况，尤其是在临近入住时间的情况下进行的预订。我们将向您注册的邮箱发送电子邮件。
**请注意：**我们强烈建议您与通知服务集成，以便您随时了解 real-time 中的房产取消情况，简化操作并扩展您的业务。如果您无法集成通知服务，那么我们建议依靠联盟伙伴电子邮件通知来随时了解住宿取消的情况。
联盟伙伴电子邮件住宿接待方取消通知示例
每当发生住宿接待方取消时，我们都会向您发送如下所示格式的电子邮件通知。
