與住宿業者分享預訂資訊

為企業合作夥伴及客戶提供無縫的體驗

簡介

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. 美元)
`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`	該卡可用於消費的有效日期範圍 (通常與住宿日期一致，並附加一段短暫的緩衝期)。