與物業共享預訂情境

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

簡介

Rapid API 提供多種選項，協助住宿業者在預訂過程中分享更多預訂背景資訊，從而為旅客提供更優質的服務。它們特別適用於商務旅客，但不限於此。

這些選項有助於物業：

識別企業與差旅管理公司 (TMC) 的關係
理解虛擬信用卡的使用時機及其應對方式

主要特點如下：

合作夥伴與客戶識別：與物業共享預訂來源資訊 (e.g.、TMC 及企業客戶)。
虛擬信用卡使用說明：提供清晰指引，說明如何使用虛擬信用卡進行旅宿收費預訂。

這些在與以下項目結合使用時尤其有用：

合作夥伴與客戶識別

目的

合作夥伴與客戶識別功能可讓您在預約請求中包含資訊，以便旅宿查閱：

哪個合作夥伴處理了預訂事宜 (例如特定的差旅管理公司)及／或
哪間企業客戶僱用了該名旅行者

此情境使房源在預訂來源中獲得更高的能見度，讓房源能夠：

識別旅客透過快速夥伴預訂的行程
識別常客或高價值企業賓客
提供更為量身訂製的旅遊體驗
維持頻繁出差企業旅客的治療連續性

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`	您希望旅宿看到的標籤 (例如 TMC 或經銷商品牌)，請使用 partner-facing 或 traveler-facing 格式。
`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",
 "address": {
 "line_1": "555 1st St",
 "line_2": "10th Floor",
 "line_3": "Unit 12",
 "city": "Seattle",
 "state_province_code": "華盛頓州",
 "postal_code": "98121",
 "country_code": "美國"
 }
 },
 "additional_handling": {
 "authorized_expenses": "total_plus_incidentals",
 "specified_incidental_expenses": [
 "早餐",
 "網路"
 ],
 "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": "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. 美元) |
| `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` | 卡片可用於扣款的日期範圍 (通常與住宿日期對應，並附加少量緩衝期)。 |