兌換票券

兌換票券為「會員以點數兌換的票券」管理頁面，設定後會員可於 LIFF 的點數商城自助以點數換取。這裡管理的是「可被兌換的票券型錄」，不是現場核銷工具。實際核銷由各模組 POS / 結帳流程完成；本頁僅負責定義票券名稱、點數成本、類型、庫存、有效期等屬性。

進入路徑

後台左側 內容管理 → 兌換票券。

與「票券管理」的差異

本頁的票券屬於後者，會員開啟點數商城時即看到此清單。

新增兌換票券

右上點 新增兌換票券，依序填寫：

必填欄位

票券名稱　會員看到的名稱，例如「100 元餐飲券」。

票券類型　以下三選一：

- 折扣券　需填折數（如 85 代表 85 折）。 - 現金券　需填金額（如 100）。 - 禮品券　不需填金額。

兌換所需點數　會員需消耗多少點數才能兌換，必須大於 0。

選填欄位

商品圖片　建議 2:1 比例（例如 1200×600）。會顯示在點數商城列表、票券詳情頁 hero、LINE 票券發放 Flex 通知卡。

2026-06-24 規格變更：圖卡 hero 從舊版 17:7 改為標準 2:1。內容管理 → 系統圖卡 票券相關範本（票券發放通知卡、票券提醒卡、票券到期卡）的 hero 全面對齊 2:1，admin 上傳器標籤顯示「建議 2:1（1200×600）」hint。舊上傳的 17:7 圖片會被 LIFF 自動裁切，建議重新上傳。

分類　可從既有分類選擇，或點旁邊 管理 開分類管理彈窗新增。分類用於商城內篩選。

票券說明　顯示於兌換頁的說明文字。

庫存數量　不填表示 不限量；填數字後達到上限即無法繼續兌換。

到期日期　不填表示 永久有效，會員可隨時兌換。

填妥後點 建立票券。

分類管理

頂部 管理分類 或新增票券時的分類欄位旁 管理 都會開分類管理彈窗：

新增分類　填名稱、選顏色（8 色預設色盤）。

編輯分類　修改現有分類的名稱與顏色。

刪除分類　刪除後底下的票券會變成「未分類」。

清單上方有分類 chips 篩選器（全部 / 各分類 / 未分類），可快速切換。

列表欄位

桌機版以表格呈現，顯示：

票券名稱 + 縮圖 + 說明

分類（彩色徽章）

類型（折扣 / 現金 / 禮品）

兌換點數

庫存（總庫存 - 已使用）

已使用

到期日

操作　編輯 / 刪除

手機版則改為堆疊卡片格式呈現相同欄位。

編輯與刪除

編輯　可改任意欄位（包含類型、點數、庫存），更新後立即生效。

刪除　已被會員兌換的紀錄不會被刪除，會員仍可繼續使用既有票券，但無人能再兌換新的。

會員如何兌換

會員端流程（簡述，僅供參考）：

第一　會員開啟 LIFF 點數商城（圖文選單「集點兌換」入口）。

第二　瀏覽本頁設定的所有票券、看點數需求。

第三　點選兌換後系統自動扣點、發放票券到該會員的票券中心。

第四　會員於消費時出示票券，由 POS / 結帳流程核銷。

核銷碼系統（2026-06-26 新增）

當您有 多家分店 或 多位店員，可開啟此功能讓會員核銷票券時必須輸入「店員 / 分店核銷碼」，達到：

• 防誤觸：會員無法在店外不小心點掉票券（沒有店家給的碼就核銷不了）
• 多店分流統計：知道哪張票被「總店」或「分店 B」核銷
• 員工績效：每位店員一組碼，後台統計誰賣得最多

開啟方式

進入 票券管理 → 點任一張票券，下方有「核銷碼設定」section，打開開關後即可新增多組碼。

設定多組碼

每組核銷碼可設定：

• 核銷碼：建議格式 店員代號-4 位數，例 ASH-1234、A001。長度上限 32 字
• 說明 / 員工名稱：顯示在後台統計用，例「店員小美」、「總店」、「分店 B」
• 綁定分店：不選 = 共用碼（所有店都能用）；選某店 = 只該店店員 / 會員看得到

同一張票券內，核銷碼不可重複。

LIFF 端流程

開啟後，會員在票券詳情頁點「使用此票券」會出現：

請輸入店家提供的核銷碼

輸入正確才會核銷，錯誤會顯示「核銷碼錯誤，請向店員確認後重試」。

防暴力破解（2026-06-27）：同一張票券短時間內連續輸錯多次（後端 audit-based 偵測），會員端會被鎖定 30 分鐘不能繼續嘗試。畫面顯示「核銷碼輸入錯誤次數過多，請 30 分鐘後再試或聯繫店家」+ 即時倒數計時，重試按鈕在鎖定期間隱藏。鎖定期間 modal 不關，讓會員看到狀況。對應後端 BRUTE_FORCE_LOCKED 錯誤碼，避免暴力測試核銷碼。

統計查看

兩個入口：

核銷碼總覽（活動管理 → 核銷碼總覽）：跨所有票券，看哪些票券啟用、累積核銷數。

核銷碼統計（活動管理 → 核銷碼統計）：時間範圍排行，含 KPI 卡（總核銷數 / 涉及店員數 / 總值）+ 核銷碼排行榜 + 票券排行 + CSV 匯出。

軟刪 vs 真刪

刪除核銷碼是「停用」（active=false），保留歷史 redemption_count 不會影響統計。要重新啟用按「重新啟用」即可。

常見問題

Q1　會員看不到我剛建立的票券

請依序確認：

第一　兌換點數 > 0（為 0 系統會視為錯誤資料）。

第二　庫存未填或剩餘 > 0。

第三　到期日未填或尚未到期。

第四　LIFF 頁面有快取，請會員下拉刷新或關閉重開。

Q2　可以指定哪些會員才能兌換嗎

本頁的票券對所有會員開放。若需依等級 / 標籤限制，建議改用 自動行銷劇本 在 trigger 觸發時 action 直接發票券，而非走點數兌換流程。

Q3　兌換後的票券怎麼核銷

由各模組獨立負責：

美業 / 餐飲 POS　結帳流程中可選擇要核銷的票券。

現場活動　由店員透過會員資料頁找到該票券手動核銷。

會員自助核銷（2026-06-24，LIFF 「我的票券」）　會員可在 LIFF 票券詳情頁自行按「立即使用」彈出 confirm modal，確認後即標記為已使用。適合不走 POS 結帳的場景（活動報到、現場禮品兌換等）。核銷後立即顯示「已使用 + 時間戳」，無法復原。後端走 POST /api/liff/vouchers/:mv_id/redeem，原子 UPDATE 防止連點重複核銷。

LIFF「我的票券」4 tab 分類（2026-06-25）　會員開啟 LIFF /vouchers 頁面後，上方分 可使用 / 已使用 / 已轉贈 / 已過期 4 個 tab：

• 可使用　持有中可立即用（active / unused）
• 已使用　過去核銷（used / redeemed）
• 已轉贈（2026-06-25 起永久保留）　送出去過的票券歷史，右上角 chip 細分：

- 轉贈中（amber）對方還沒領 - 已領取（blue）對方已成功領取 - 已失效（gray）票券到期 - 已取消（gray）轉贈被取消

• 已過期　到期未用（expired）

「已轉贈」tab 內卡片不可點開詳情（票券已過戶）。完整轉贈管理 / OAuth 流程說明見 轉贈紀錄 模組。

「轉贈給朋友」按鈕何時才會出現（2026-08-16 起）：只有該張票券在後台開啟了「允許會員轉贈這張票券」時才顯示，新建票券預設是關閉的。若客人反映「我的票券看不到轉贈按鈕」，請先到 內容管理 → 票券管理 該張票券的「轉贈設定」確認是否已開啟。詳見 點數與票券。

詳情請參閱對應模組說明書。

Q4　可以暫停兌換但保留設定嗎

目前未提供「暫停兌換」開關。建議做法：將 庫存 改為 0，會員端即無法兌換但票券設定仍保留。需恢復時改回原數字即可。

Q5　兌換點數 / 金額可以追溯改動嗎

點數扣抵紀錄會寫入 會員管理 → 點數紀錄，可依會員 / 時間查詢。票券發放紀錄寫入 會員管理 → 票券紀錄。兩處皆為純讀，不可修改以確保稽核完整。