住宿收款模式下的付款
访问允许您的旅客到店付款的住宿预订。
如何运作
住宿收款允许您访问需要旅客到店付款的住宿，而不是以预付方式在线付款。住宿收款预订要求旅客提供详细信用卡信息以作担保。此功能使用 property_collect 参数。要了解完整的 API 集成详细信息，请参阅选购 API 文档。
由于您将要处理详细信用卡信息，这部分 API 要求您符合 PCI 要求。
潜在交易
通过住宿收款选项进行预订，住宿接待方将在客户入住时向客户收款。但是，在以下情况下，住宿或 Rapid 可以在客户到达之前对付款卡进行交易：
- **交易预授权：**需要一张有足够余额的卡来确保顺利完成住宿收款预订。住宿可能需要预授权，信用卡提供商会冻结一笔持卡人批准的金额，而不是从卡中将钱款扣除。如果客户完成预订交易，付款人的银行通常会在几个月内自动释放资金。
- **象征性金额的交易结算：**作为住宿收款预订担保的替代选项，住宿接待方可能会收取象征性金额以验证付款卡。这种行为是旅游接待行业的常见做法。随后，支付的金额将会退还或从应在住宿支付的最终款项中扣除。
- **部分或全部不可退款：**当住宿收款预订进入部分/全部不可退款期限内时，住宿可能会收取不可退款部分的费用。支付的金额将会退还或从应在住宿支付的最终款项中扣除。取消政策由选购 API 的响应元素
refundable=false和<cancel_penalties>返回。 - 需付押金的住宿收款预订：需付押金的住宿收款预订库存为住宿提供了按计划收取押金的选项。默认 API 配置已包含此库存。
- **预订后未入住：**如果客户第一晚未入住，住宿或 Rapid* 将根据取消政策从付款卡中收取预订后未入住的手续费（最高为预订价值的 100%）。
- **逾期取消：**在免费取消截止日期之后取消订单将产生手续费。住宿或 Rapid* 根据取消政策从付款卡中收取取消手续费。
- **免费取消：**如果客户在免费取消截止日期之前取消了住宿收款预订，但在付款卡账单上仍然看到住宿收取了费用，我们建议客户直接与住宿接待方联系以确保退款。
- **虚拟卡和公司卡：**如果您计划集成虚拟卡或公司卡来预订住宿收款库存，请先与您的 Rapid partner connect 代表商讨此事。
* 仅当住宿或付款卡涉及 PSD2 合规项目时，Rapid 才会成为住宿收款预订的记录商户。您可以要求我们为您排除此类潜在住宿，并集成注册付款信息 API 以确认付款卡是否需要双重身份验证。账单描述符可以帮助您识别交易来源。Rapid 交易的账单描述符默认显示为“travel reservation”，也可根据您的要求自定义。
货币
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 客服或联盟伙伴 Voyager（若设置中包含）也可以帮助您查看预订取消的来源。
如果您将行程的状态值作为基于 API 的自助服务系统的一部分使用，或者触发您自己的客户电子邮件通知，则可以使用管理预订 API 更新预订状态并核对系统中的取消。
有两种方法可以随时了解住宿取消情况：
Rapid 通知
Rapid 将通过标准的 POST 消息将变更详细信息直接推送到您的系统。当发生可能影响您业务的变更时，我们的通知服务会立即将变更详细信息发送到您的系统，以便您实时了解变更情况。
Rapid 自动化电子邮件通知
当住宿取消预订时，Rapid 总能直接向您发送联盟伙伴电子邮件通知，但您必须负责管理旅客通信。我们的自动化电子邮件系统会提醒您有关住宿取消的情况，尤其是在临近入住时间的情况下进行的预订。我们将向您注册的邮箱发送电子邮件。
**请注意：**我们强烈建议您集成通知服务，这样您就可以实时了解住宿取消情况、简化操作并扩展您的业务。如果您无法集成通知服务，那么我们建议依靠联盟伙伴电子邮件通知来随时了解住宿取消的情况。
联盟伙伴电子邮件住宿接待方取消通知示例
每当发生住宿接待方取消时，我们都会向您发送如下所示格式的电子邮件通知。
