與住宿業者分享預訂資訊

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

簡介

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物件是可選的，但建議使用。

附帶額外處理功能的虛擬信用卡範例

{
 ...
 "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": [
 "早餐",
 "網路"
 ],
 "total_charges_allowed": {
 "value": "875.00",
 "currency": "USD"
 },
 "is_cvc_required": true,
 "authorizing_company": "確認",
 "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.<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` | 該卡可用於消費的有效日期範圍 (通常與住宿日期一致，並附加一段短暫的緩衝期)。 |