与酒店共享预订信息

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

概述

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

这些选项有助于房产：

识别合作伙伴
了解虚拟信用卡的使用时机和使用方法。

主要特点有：

合作伙伴和客户识别：与酒店共享有关预订来源的信息（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对象是可选的，但建议使用。

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

{
  ...
  "payments": [
    {
      "type": "virtual_card",
      "number": "4111111111111111",
      "security_code": "123",
      "expiration_month": "08",
      "expiration_year": "2028",
      "billing_contact": {
        "given_name": "John",
        "family_name": "Smith",
        "address": {
          "line_1": "555 1st St",
          "line_2": "10th Floor",
          "line_3": "Unit 12",
          "city": "Seattle",
          "state_province_code": "WA",
          "postal_code": "98121",
          "country_code": "US"
        }
      },
      "additional_handling": {
        "authorized_expenses": "total_plus_incidentals",
        "specified_incidental_expenses": [
          "breakfast",
          "internet"
        ],
        "total_charges_allowed": {
          "value": "875.00",
          "currency": "USD"
        },
        "is_cvc_required": true,
        "authorizing_company": "Conferma",
        "card_contact": {
          "email": "chucktesta@mydomain.com",
          "phone": {
            "country_code": "1",
            "area_code": "555",
            "number": "5555555"
          }
        },
        "payment_allowable_period_start": "2027-01-01",
        "payment_allowable_period_end": "2028-08-01"
      }
    }
  ]
}

关键附加处理字段

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