忠誠度獎勵的 API 交付
透過 Loyalty Earn，您可將顧客忠誠度 Rewards 與您的計劃進行對帳。您亦可運用這些數據，提供待審核與已核發點數的 up-to-date 視圖，分析計畫趨勢，並為相關利害關係人建立報告。
配送選項
我們的忠誠度獎勵方案允許您透過拉取機制檢索資料，該機制提供詳細行程數據以支援：
- 數據分析
- 授予客戶獎勵點數
- 服務台調查
此服務包含兩個HTTP GET 端點，可讓您：
- 查看資料最後更新的時間。忠誠積分每日更新。
- 使用
transaction_date_start、transaction_date_end、and membership_id或itinerary_id變數，建立指定時間範圍內待處理或已兌換的忠誠度貨幣清單
有關驗證流程的詳細資訊，請參閱API 設定。
可用欄位
下表列出我們推播和提取交付方法所提供的欄位，包括所有嵌入物件。
| 欄位名稱 | 定義 | 範例 |
|---|---|---|
itinerary_id | 行程編號或銷售點訂單參考編號。 | 72622069245694 |
transaction_type | 已記錄交易的類型。 | 可能的值： 購買 獎項 修改 取消 |
transaction_date* | 預訂最後修改日期。若預訂從未更新，此情況與book date 相同。以 ISO 8601 日期格式表示（YYYY-MM-DD). | 2023-02-05 |
transaction_datetime* | 預訂最後修改的日期與時間。若未進行任何更新，此值與 . 相同book_date。 | 2023-10-21T00:00:00.000Z |
booking_item | 代表個別預訂元素的物件。請參閱嵌套項目的booking_item 表格。 | — |
package_indicator | 該預訂項目是否屬於套裝行程的一部分 (例如航班 + 飯店)。 | 可能的值： 包裝的一部分 純訂房 未知 |
currency_code | 預訂所支付的貨幣，以標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
gross_booking_value | 總預訂價值 (GBV)，即包含稅金與費用的總預訂金額，以實際支付貨幣計價。 | 694.89 |
base_price | 向旅客收取的金額，不含稅費、費用且未經調整，此為獎勵積分的基礎。以付款所用貨幣顯示。 | 154.78 |
award_date* | 點數發放日期，以 ISO 8601 日期格式表示（YYYY-MM-DD). | 2023-03-14 |
point_definition | 標示某項活動或促銷將改變您計劃的基本收益模式。 | Partner_2X_promo |
pending_points | 已賺取但尚未發放的點數數量。 | 細分為： 總計：－100.11 基數：－90.01 獎勵：－10.1 |
awarded_points | 本次交易所獲點數數目。 | 細分為： 總計：100.11 基數：90.01 獎勵：10.1 |
program_name | 會員計畫的名稱。 | 獎勵 |
member | 代表客戶資訊的物件。請參閱嵌套項目的member 表格。 |
所有欄位的備註
日期欄位採用太平洋標準時間 (PST)，並包含夏令時間調整。
個人可識別資訊 (PII) 數據。請務必依照貴公司的指導方針正確處理此事，並僅在絕對必要時才納入考量。
API 詳細資料
在此頁面探索端點的定義，然後使用 API 測試軟體，了解範例和結構描述定義與實際輸出的比較。