与酒店共享预订信息

为企业合作伙伴和客户提供无缝体验

概述

Rapid API 提供多种选项，通过在住宿预订中分享更多预订信息，帮助酒店更好地服务旅客。它们对商务旅行者尤其有用，但不仅限于此。

这些选项有助于房产：

了解企业和差旅管理公司 (TMC) 的关系
了解虚拟信用卡的使用时机和使用方法。

主要特点有：

合作伙伴和客户识别：与酒店共享有关预订来源的信息（e.g。TMC 和企业客户）。
虚拟信用卡使用说明：提供关于如何使用虚拟信用卡进行房产预订的清晰指导。

它们与以下工具结合使用时尤其有效：

合作伙伴和客户识别

目的

合作伙伴和客户身份识别功能允许您在预订请求中添加信息，以便酒店可以看到：

哪个合作伙伴负责预订（例如，特定的旅行管理公司）和/或
这位旅行者受雇于哪家企业客户？

这种方式能让酒店更清楚地了解预订来源，从而使其能够：

识别旅客通过 Rapid 合作伙伴预订的行程
识别回头客或高价值企业客户
提供更个性化的旅行体验
为经常出差的商务旅客提供持续治疗

API 参数

您可以使用预订请求中的以下字段发送此信息：

supplier_transparency （目的）
consent_to_share （布尔值，如果您希望与供应商共享数据，则为必填项）

您可以提供合伙人或客户姓名，或者两者都提供。

关键规则：

consent_to_share Rapid API 必须将数据传递给供应商
如果 consent_to_share 不是 true，则 Rapid API 不会共享合作伙伴/客户信息，即使 supplier_transparency 已填写。

合作伙伴和客户识别示例

{
  ...
  "supplier_transparency": {
    "point_of_sale_display_to_share": "PLS Partner Name",
    "company_name_to_share": "Corporate Client Name",
    "consent_to_share": true
  }
}

字段详情

字段	详细信息
`point_of_sale_display_to_share`	您希望房产看到的 partner-facing 或 traveler-facing 标签（例如 TMC 或经销商品牌）。
`company_name_to_share`	与旅行者关联的企业客户名称（例如雇主）。
`consent_to_share`	当 `true` 指示 Rapid API 最终客户已同意与供应商共享此信息（财产）。如果省略或`false`，则信息不会被转发。

虚拟信用卡使用说明

Context

企业报销计划通常采用以下几种方式支付商务旅行费用：

旅行者个人信用卡
企业支付卡
虚拟信用卡（VCC）

然而，有些房产缺乏明确的指导方针：

如何识别和处理虚拟信用卡
虚拟信用卡上哪些费用是授权的？
卡片何时可以充值（有效期）

这可能会导致办理入住和/或退房时的混乱，并给商务旅客带来不愉快的体验。

目的

虚拟信用卡使用指南为酒店和业主提供以下方面的结构化指导：

是否使用虚拟信用卡进行房产预订
包含哪些费用（房费、税费、特定杂项费用等）？
任何费用限制和有效期
如果出现问题，如何联系信用卡客服？

API 参数

这些说明通过以下方式添加到预订请求中：

支付数组：
- type使用virtual_card时识别虚拟信用卡
additional_handling 对象（在付款条目中）提供详细的付款处理说明，例如：
- authorized_expenses
- specified_incidental_expenses
- total_charges_allowed
- is_cvc_required
- authorizing_company
- card_contact
- payment_allowable_period_start
- payment_allowable_period_end

additional_handling对象是可选的，但建议使用。

虚拟信用卡示例，附带额外处理

{
...
"付款": [
{
"类型": "virtual_card",
"号码": "4111111111111111",
"security_code": "123",
"expiration_month": "08",
"expiration_year": "2025",
"billing_contact": {
"given_name": "John",
"family_name": "Smith",
"地址": {
"第一行": "第一街 555 号",
"第二行": "10 楼",
"第三行": "12 单元",
"城市": "西雅图",
"state_province_code": "华盛顿州",
"postal_code": "98121",
"country_code": "US"
}
},
"additional_handling": {
"authorized_expenses": "total_plus_incidentals",
"specified_incidental_expenses": [
"早餐",
"网络"
],
"total_charges_allowed": {
"价值": "875.00",
"货币": "USD"
},
"is_cvc_required": true,
"authorizing_company": "确认",
"card_contact": {
"电子邮件": "chucktesta@mydomain.com",
"电话": {
"country_code": "1",
"area_code": "555",
"number": "5555555"
}
},
"payment_allowable_period_start": "2024-01-01",
"payment_allowable_period_end": "2025-08-01"
}
}
]
}

### 关键附加处理字段

| 字段 | 详细信息 |
| ----- | ----- |
| `authorized_expenses` | 指示虚拟信用卡用途的高级规则，e.g。<br><br>• `room_only`<br> • `room_and_tax`<br> • `total_plus_incidentals` |
| `specified_incidental_expenses` | 允许的具体额外支出清单（例如早餐或上网费用） |
| `total_charges_allowed` | 明确规定收费上限<br><br>• 值：最大金额<br>• 货币：货币代码（e.g. USD） |
| `is_cvc_required` | 指示是否必须使用 CVC 卡才能进行刷卡消费。 |
| `authorizing_company` | 发行或管理虚拟信用卡的公司名称（例如虚拟信用卡提供商或企业实体） |
| `card_contact` | 如果酒店在信用卡扣款方面遇到任何问题，请通过以下方式联系我们：<br><br>• `email`<br> •`phone.country_code, phone.area_code, phone.number` |
| `payment_allowable_period_start / payment_allowable_period_end` | 卡片可用于消费的日期范围（通常与入住日期一致，并留出少量缓冲时间）。 |