管理員指南
兌換碼管理
批次產生和管理配額兌換碼
兌換碼用於活動贈送或使用者自助儲值額度。使用者兌換入口為 `/console/wallet` 兌換碼區域。管理員批次產生與管理需透過 `POST /api/redeem_code` 等管理介面操作，Web 管理頁尚未上線。
| ID | 名稱 | 狀態 | 額度 | 建立時間 | 過期時間 | 兌換人 ID | 操作 | |
|---|---|---|---|---|---|---|---|---|
| ☐ | 101 | 活動贈送-3月 | 未使用 | 5000 | 2026-06-01 | 2026-12-31 | — | 查看 · 複製 · 編輯 · 刪除 |
| ☐ | 88 | 內測補償 | 已使用 | 1000 | 2026-05-10 | — | 2 | 查看 · 複製 · 編輯 · 刪除 |
顯示第 1 筆 – 第 10 筆，共 214 筆 · 每頁 10 筆
兌換碼列表示意：批次操作、搜尋與分頁
批次產生兌換碼
開啟產生彈窗
- 在兌換碼列表頁點擊「新增兌換碼」
- 於彈窗中填寫批次名稱、數量與額度等參數
- 也可編輯既有紀錄：列內「編輯」或
GET /api/redeem_code/{id}
設定產生參數
| 參數 | 說明 |
|---|---|
name · 名稱 | 批次名稱或前綴，方便在列表中識別 |
count · 產生數量 | 一次批次產生的兌換碼個數 |
quota · 額度 | 每個兌換碼可兌換的額度面額 |
expired_time · 過期時間 | 選填；到期後狀態變為已過期 |
status · 狀態 | 新建預設啟用；可預先停用 |
產生兌換碼
- 點擊「產生」提交
POST /api/redeem_code - 系統為每筆紀錄產生 32 位唯一
key，寫入redemption資料表 - 列表預設由
GET /api/redeem_codes分頁回傳；使用者兌換後更新used_user_id與redeemed_time - 使用者端兌換請見
/console/wallet與 配額與儲值 文件
匯出兌換碼
- 產生完成後，在結果區複製單筆 key 或「複製所選兌換碼至剪貼簿」
- 列內「複製」可快速複製一筆完整兌換碼
- 可將 key 列表匯出為文字檔案，用於活動發放或電子郵件推送
- 兌換碼 key 具有額度價值，請透過安全管道分發，勿公開提交到程式碼儲存庫
列表欄位與操作
| 欄 | 欄位 | 說明 |
|---|---|---|
| ID | id | 兌換碼紀錄 ID |
| 名稱 | name | 批次或用途名稱，方便識別 |
| 狀態 | status | 未使用 / 已使用 / 已停用 / 已過期 |
| 額度 | quota | 兌換成功後入帳的額度數量 |
| 建立時間 | created_time | 產生時間戳記 |
| 過期時間 | expired_time | 過期後不可兌換；留空表示永不過期 |
| 兌換人 ID | used_user_id | 已使用時記錄兌換使用者 ID |
- 新增兌換碼（
POST /api/redeem_code）：開啟產生彈窗，批次建立兌換碼 - 複製所選至剪貼簿：勾選多筆後複製完整 key（32 位）
- 清除失效兌換碼（
DELETE /api/redemption/invalid）：刪除已使用、已過期或已停用的紀錄 - 搜尋（
GET /api/redeem_codes?keyword=）：依 ID 或名稱關鍵字篩選
- 查看（
GET /api/redemption/{id}）：查看兌換碼詳情與完整 key - 複製：複製單筆兌換碼 key 至剪貼簿
- 編輯（
PUT /api/redeem_code/{id}）：修改名稱、額度、過期時間或狀態 - 刪除（
DELETE /api/redemption/{id}）：刪除單筆紀錄（無法復原）
管理員側邊欄可在 個人設定 → 側邊欄模組中開啟 sidebar_modules.admin.redemption。