預訂

「預訂 API」可讓您預訂客房,且房型和房價已由價格檢查回應確認。

「預訂 API」的主要行程方式,會針對選取的旅宿、客房、房價和入住率建立預訂。要求當中會直接提供帳單/持卡人聯絡資訊等付款資訊。

每個執行成功的預訂回應皆會包含連結,以取回行程或取消預訂。請參閱我們的「管理預訂」和「處理預訂要求」等章節了解詳情。

若要預訂多間客房 (針對相同房型),您必須先發出「購物」要求,然後再針對每間客房傳送個別的 occupancy 參數。接著在「預訂」請求中,針對想要預訂的每間客房,於 rooms 陣列包含對應的 room 個別執行格體。

若要在完成預訂前短期保留可訂空房 (例如建立套裝行程),請參閱我們的「暫停與繼續處理」說明文件。

若要執行信用卡不扣款或不傳送至旅宿的測試預訂,請參閱我們的「測試要求」說明文件。

預訂連結過期

來自先前「價格檢查」回應的預訂連結,會在短時間內到期。若您在第一次嘗試時收到 HTTP 503 錯誤,表示連結可能已到期。請取得新連結並重新嘗試預訂。

INR 和 BRL 預訂的稅務編號

礙於監管稅務規定,部分透過 Rapid 以印度盧比 (INR) 和巴西雷亞爾 (BRL) 完成的交易,需在tax_registration_number參數提供付款旅客的有效個人稅務編號。

如果此參數留空或提供無效稅務編號,「建立預訂」要求可能會失敗。要求會回傳 HTTP 400 錯誤,以及錯誤原因為tax_registration_number的訊息。為修正此問題,請將 tax_registration_number 更新為有效稅務編號,並重新傳送「建立預訂」要求。

API 詳細資料

在這個頁面上探索預訂相關端點的定義,然後使用 API Explorer 或其他測試軟體,了解範例和結構描述定義與實際輸出的比較。


其他資源

無論您是想嘗試所有 Rapid API 端點,還是下載其 OpenAPI 規格或我們的 Postman Collection,我們都可協助您完成。



這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!