預訂
「預訂 API」可讓您預訂客房,且房型和房價已由價格檢查回應確認。
「預訂 API」的主要行程方式,會針對選取的旅宿、客房、房價和入住率建立預訂。要求當中會直接提供帳單/持卡人聯絡資訊等付款資訊。
每個執行成功的預訂回應皆會包含連結,以取回行程或取消預訂。詳情請參閱我們的管理預訂專區,以及處理預訂請求 頁面。
若要預訂客房類型的 multi-room 訂位,您必須先發出Shopping API請求,並針對每個客房傳入獨立的occupancy參數。接著,在預訂請求中,針對您欲預訂的每個客房,請在 room 陣列中加入相應的獨立 rooms 實例。
若要在完成預訂前短期保留可訂空房 (例如建立套裝行程),請參閱我們的「暫停與繼續處理」說明文件。
若要執行信用卡不扣款或不傳送至旅宿的測試預訂,請參閱我們的「測試要求」說明文件。
預訂連結過期
來自先前「價格檢查」回應的預訂連結,會在短時間內到期。若您在第一次嘗試時收到 HTTP 503 錯誤,表示連結可能已到期。請取得新連結並重新嘗試預訂。
INR 和 BRL 預訂的稅務編號
基於稅務法規要求,部分以印度盧比 (INR) 及巴西雷亞爾 (BRL) 進行的 Rapid API 交易,需在tax_registration_number 參數中提供付款旅客的有效個人稅務識別號碼。
若此參數留空或提供無效的稅務識別號碼,來自「建立預訂」API 的請求可能會失敗。要求會回傳 HTTP 400 錯誤,以及錯誤原因為tax_registration_number