優惠券驗證 API

優惠券驗證如何運作

將「優惠券驗證 API」與例如購物網站和銷售點 (POS) 系統等系統整合。若要驗證優惠券,請在 couponsToValidate 要求內容中提供最多 1,000 個手動輸入的優惠券代碼。

如果手推車已在其優惠券欄位中包含優惠券代碼,則 API 也會發現並驗證這些代碼。您不需要將這些代碼複製到 couponsToValidate。針對通過優惠券層級檢查的優惠券,API 會根據每個代碼附加的位置評估促銷資格。

• 針對附加至手推車標題的優惠券,API 會評估整個手推車。
• 針對附加至手推車條列的優惠券,API 只會評估該條列。條列必須參與與優惠券相關聯的促銷。

在要求中提供手推車及其條列項目,使用與 符合資格的促銷 API 和 促銷評估和執行 API 相同的手推車結構。

優惠券驗證結果

針對每個優惠券代碼,回應會提供以下詳細資料。

• 跨適用範圍的彙總狀態。當優惠券通過至少一個適用範圍的驗證時,狀態為 Valid。否則,狀態為 Invalid。
• 針對有效的優惠券,有效範圍、相關聯的促銷識別碼,以及適用的手推車條列項目識別碼 (針對 Line 範圍)。
• 針對無效的優惠券,這是驗證失敗的原因。