入住時付款
存取旅宿的預訂資訊，讓旅客可親臨現場付款。
運作方式
入住時付款可讓您存取旅客須現場付款的旅宿，而不僅限以 Expedia Collect 線上付款的旅宿。入住時付款預訂會要求旅客提供信用卡資料以做為保證。此功能使用 property_collect 參數。
>> 請參閱「購物 API」文件，以了解完整的 API 整合細節
由於需要處理信用卡資料，此 API 部分必須符合支付卡產業安全標準。
可能的交易情況
若預訂入住時付款選項，旅宿將在旅客辦理入住時向旅客收取費用。然而若符合下列情況，旅宿或 Rapid 可在旅客抵達前預先透過支付卡收取費用：
- 交易預授權： 需持有餘額充足的卡片，方可確保旅宿預訂成功。部分住宿設施可能需要預先授權，在此情況下，發卡機構會對持卡人核准的金額進行暫扣，而非直接從卡片中扣款。若旅客完成預訂交易，發卡銀行通常會在數月後自動釋放該筆額度。
>> 進一步了解 pre-authorization - **名目金額交易結算：**入住時付款預訂還有另一個保證方式，即旅宿透過旅客的支付卡收取一筆名目費用，以驗證該張卡片。這種做法在旅宿業很常見。該名目金額可於日後退回，或從支付給旅宿的費用中扣除。
- **部分退款或不得退款：**旅宿可先收取一旦入住時付款預訂進入部分/不得退款期限時的不得退款金額。該筆金額可於日後退回，或從支付給旅宿的費用中扣除。取消規定由購物 API 的回應元素
refundable=false和<cancel_penalties>回傳。 - 旅宿預付押金收費方案： 旅宿預付押金收費方案的庫存功能，允許房源依據既定時程收取押金。API 的預設設定中已納入此庫存。
>> 進一步了解旅宿預付訂金領取服務 - No-show: 若客人未於第一晚入住，旅宿或 Rapid* 將根據取消政策，向付款卡收取 no-show 之違約金 (最高為預訂金額的 100%)。
- **逾期取消：**在免費取消期限過後，旅客取消預訂需支付罰款。旅宿或 Rapid* 可依取消規定透過支付卡收取取消罰款。
- **免費取消：**若旅客在免費取消期限內取消預訂，但支付卡明細表上仍出現旅宿收取的費用，建議旅客直接聯絡旅宿，以確認退款。
- 虛擬卡與企業卡： 若您計劃整合虛擬卡或企業卡以進行旅宿預訂並收集庫存，請先與您的 Rapid Partner Connect 代表商討此事。
>> 了解虛擬卡或企業卡
注意：僅當旅宿或支付卡涉及 SCA 合規要求時， Rapid 才會成為旅宿預訂的「記錄中的商家」。您可以要求排除掉這類型的旅宿，並整合「註冊付款 API」來確認支付卡是否需要雙重授權。這些資訊可協助您釐清交易的來源。Rapid 的預設請款店家名稱為「旅遊預訂 (Travel Reservation)」，也可改為您要求的名稱。
>> 瞭解「註冊付款 API」 >> 更多關於帳單描述資訊 >> 進一步了解 SCA 合規性
貨幣
「Rapid 內容」會回傳各旅宿的 onsite_payments.currency，以說明入住時旅宿接受的付款貨幣，方便旅客現場支付如洗衣和迷你吧等費用。此幣別為旅宿所設定，且與預訂時的支付卡交易貨幣無關。
totals.inclusive.billable_currency 為入住時付款預訂幣別唯一來源，且會回傳 到「Rapid 購物」和「Rapid 管理預訂」API，有助旅客以正確幣別得知預訂的金額。
此外，totals.inclusive.request_currency 會依照要求的貨幣 (通常是旅客偏好的幣別) 提供訊息。
請注意：onsite_payments.currency 和 totals.inclusive.billable_currency.currency 的值可能不同。
帳單幣別為旅宿接獲入住時付款預訂時，透過支付卡收費的幣別。旅宿在定義其入住時付款房價時，便決定了帳單幣別。旅宿在入住時付款上的房價可選用帳單幣別來告示，不一定要用當地幣別 (即現場付費幣別)。透過支付卡收取的費用 (例如逾期取消罰款) 會依帳單幣別計費。
使用者介面範例
EUR (歐元) 是旅客偏好的貨幣；USD (美元) 是預訂貨幣；EGP (埃及鎊) 是當地貨幣：
旅宿取消預訂
針對入住時付款預訂，旅宿在確認後的 72 小時之內可取消預訂。請注意，旅宿需自行處理並通知取消預訂，這是入住時付款的啟動條件之一。
取消預訂最常見的原因之一是信用卡無效。大多旅宿不願接待入住前無法提供有效付費方式的旅客，因為有一定的風險。請確認您的信用卡驗證程序符合我們的建議，以免預訂遭取消。
取消通知
如果您預訂的是旅宿自取方案，我們建議您整合「通知服務」，以便隨時掌握旅宿的取消資訊。
若無法從您的端點收到確認接收 (即 200 OK 狀態碼)，「通知服務」會將訊息視為無法傳送，並排入重試佇列。可使用「無法傳送通知 API」來取回過去 7 天內無法傳送的訊息。
若您的任何相關系統與「通知服務」整合失敗，旅宿取消的預訂可能無法被旅客看到，或誤解成旅客主動要求取消。
除「無法傳送通知 API」之外，也可請 Rapid 客服專員或 Affiliate Voyager (如有包含在設定中) 來幫您檢查取消預訂的來源。
如果您將行程的狀態值用於「API-based self-service」系統，或用以觸發您自己的客戶電子郵件通知，則可使用「管理預訂 API」來更新預訂狀態，並在您的系統中處理取消事宜。
您可以透過 Rapid API 的通知或自動電子郵件通知，隨時掌握旅宿取消的相關資訊。
Rapid API 通知
Rapid API 將透過標準的 POST 訊息，將變更的詳細資訊直接推送至您的系統。若出現可能影響您業務的變更，我們的通知服務會立刻把變更詳情傳送到您的系統，讓您即時掌握變更狀態。
Rapid 自動電子郵件通知
當旅宿取消預訂時，Rapid 會寄送電子郵件通知給您 (我們的直接聯盟夥伴)，然而您需要自行處理與旅客之間的溝通。我們的自動電子郵件系統會在旅宿取消預訂時提醒您，尤其是在接近入住時間進行的預訂。電子郵件會寄到您註冊時用的地址。
請注意： 我們強烈建議您整合「通知服務」，以便隨時掌握 real-time, 上的旅宿取消資訊，簡化營運流程，並擴展您的業務規模。若無法整合「通知服務」，則建議您隨時留意聯盟夥伴電子郵件通知，以掌握旅宿取消預訂訊息。
聯盟夥伴電子郵件旅宿取消通知範例
當旅宿取消預訂時，我們會以電子郵件通知您 (如下圖所示)。
