入住時付款

可存取允許旅客現場付款的旅宿。

運作方式

入住時付款可讓您存取旅客須現場付款的旅宿，而不僅限以 Expedia Collect 線上付款的旅宿。入住時付款預訂會要求旅客提供信用卡資料以做為保證。此功能使用 property_collect 參數。若需要完整的 API 整合資料，請參閱「購物 API」文件。

由於需要處理信用卡資料，此 API 部分必須符合支付卡產業安全標準。

可能的交易情況

若預訂入住時付款選項，旅宿將在旅客辦理入住時向旅客收取費用。然而若符合下列情況，旅宿或 Rapid 可在旅客抵達前預先透過支付卡收取費用：

**預先授權交易：**使用入住時付款預訂時，旅客會需要以一張足額的支付卡做為保證。旅宿會要求預先授權，也就是發卡銀行在持卡人同意後，先凍結一定的額度 (尚未正式扣款)。若旅客完成預訂交易，發卡銀行通常會在數月後自動釋放該筆額度。
**名目金額交易結算：**入住時付款預訂還有另一個保證方式，即旅宿透過旅客的支付卡收取一筆名目費用，以驗證該張卡片。這種做法在旅宿業很常見。該名目金額可於日後退回，或從支付給旅宿的費用中扣除。
**部分退款或不得退款：**旅宿可先收取一旦入住時付款預訂進入部分/不得退款期限時的不得退款金額。該筆金額可於日後退回，或從支付給旅宿的費用中扣除。取消規定由購物 API 的回應元素 refundable=false 和 <cancel_penalties> 回傳。
入住時付款訂金：入住時付款訂金API 的預設設定中已納入此庫存。
**預訂後未入住：**若旅客在預訂的第一晚沒有入住，旅宿或 Rapid* 可依取消規定透過支付卡收取未到罰款 (最高為預訂金額的 100%)。
**逾期取消：**在免費取消期限過後，旅客取消預訂需支付罰款。旅宿或 Rapid* 可依取消規定透過支付卡收取取消費用。
**免費取消：**若旅客在免費取消期限內取消預訂，但支付卡明細表上仍出現旅宿收取的費用，建議旅客直接聯絡旅宿，以確認退款。
**虛擬卡和公司卡：**若您想整合虛擬卡或公司卡，用以預訂入住時付款的庫存客房，請先與您的 Rapid Partner Connect 客服專員討論。

*唯有當旅宿或所使用的支付卡參與 PSD2 合規計畫時，Rapid 才是入住時付款預訂的交易記錄商戶。您可以要求排除掉這類型的旅宿，並整合「註冊付款 API」來確認支付卡是否需要雙重授權。使用顯示請款店家名稱的方式有助於辨識交易對象。Rapid 的預設請款店家名稱為「旅遊預訂 (Travel Reservation)」，也可改為您要求的名稱。

貨幣

「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 自助系統之一，或用來發送自己的旅客電子郵件通知，可以用「管理預訂 API」來更新預訂狀態，再把取消預訂整合入系統。