Appearance
超商代碼訂單
路徑：/admin/query/cvs | 快捷鍵：6 → Q
查詢所有超商代碼（CVS）的訂單紀錄，包含訂單全生命週期的詳細資訊、供應商通訊紀錄與商戶回調紀錄。
篩選條件
| 篩選項目 | 說明 |
|---|---|
| 日期欄位 | 選擇以「建立時間」或「付款時間」作為日期篩選依據 |
| 日期區間 | 日期範圍，預設為今日。提供快捷按鈕（今日、昨日、近 7 天、近 30 天等）可快速選取 |
| 訂單號查詢 | 依系統訂單號或商戶訂單號搜尋，支援搜尋歷史紀錄 |
| 狀態 | 訂單狀態篩選（全部 / PENDING / PROCESSING / SUCCESS / SETTLED 等），支援複選多個狀態同時篩選 |
| 商戶 | 特定商戶或全部 |
| 供應商 | 特定供應商或全部 |
| 繳費通路 | 7-11 / 全家 / 萊爾富 / OK / 全部 |
| 門市代號 | 依繳費門市代號搜尋 |
| 黑名單 | 篩選命中黑名單的訂單（全部 / 僅黑名單） |
| 買家姓名 | 依付款人姓名搜尋 |
| 買家電話 | 依付款人電話搜尋 |
| 付款人信箱 | 依付款人電子信箱搜尋 |
搜尋歷史
訂單號搜尋欄位支援自動記錄搜尋歷史。Focus 搜尋框時會顯示最近 10 筆搜尋過的關鍵字，點擊即可快速再次搜尋。每筆歷史可單獨刪除，也可一鍵清除全部。
統計摘要
篩選區域右側永遠顯示四個即時統計：
| 統計項目 | 說明 |
|---|---|
| 總手續費 | 符合篩選條件的手續費合計（點擊可看費用說明） |
| 總服務費 | 符合篩選條件的服務費合計 |
| 總訂單數 | 符合篩選條件的訂單總數 |
| 總金額 | 符合篩選條件的訂單金額合計 |
表格欄位
| 欄位 | 說明 |
|---|---|
| 序號 | 列表序號 |
| 建立時間 | 訂單建立的日期時間 |
| 商戶 | 商戶名稱與代碼 |
| 付款時間 | 付款完成的日期時間 |
| 供應商 | 處理此訂單的供應商名稱 |
| 金額 | 訂單金額 |
| 繳費代碼 | CVS 超商繳費代碼（顯示通路/代碼，可複製） |
| 繳費通路 | 實際繳費的通路與門市 |
| 狀態 | 訂單狀態 badge（含預約異常、黑名單警示） |
| Cashier URL | 結帳連結（可複製） |
| 操作 | 功能按鈕 |
| 系統訂單號 | 系統產生的訂單編號（可複製，位於最末欄位） |
| 商戶訂單號 | 商戶端的訂單編號（位於最末欄位） |
訂單狀態說明
| 狀態 | 說明 |
|---|---|
| PENDING | 訂單已建立，等待取號 |
| PROCESSING | 已取得繳費代碼，等待付款 |
| SUCCESS | 付款成功 |
| SETTLED | 已下撥 |
| EXPIRED | 超過繳費期限 |
| FAILED | 訂單失敗 |
預約異常警示
當系統偵測到訂單的「預約通路/門市」與「實際繳費通路/門市」不一致時，會在狀態欄位旁顯示紅色閃爍的 「預約異常」 警示標籤。支援多組預約時，任一組匹配即通過驗證。
後端驗證機制
預約異常的偵測完全由後端處理，前端僅讀取後端回傳的驗證結果。後端在查詢訂單時會自動重新驗證異常標記，確保因規則調整而變成正常的訂單不再顯示假警報。
展開該訂單的詳情可看到：
- 異常原因說明
- 預約通路 vs. 實際通路的比對
黑名單警示
當訂單的付款人資訊（姓名/手機/信箱）命中黑名單時，狀態欄位旁會顯示橘色閃爍的 「黑名單」 警示標籤。
- 不阻擋回調：僅標記提醒，不影響商戶回調流程
- 可與預約異常並存：同一筆訂單可同時顯示紅色「預約異常」與橘色「黑名單」
展開該訂單的詳情可看到：
- 命中項目（姓名/手機/信箱）
- 命中的值與備註說明
展開訂單詳情
點擊任一訂單列可展開五區塊的詳細資訊：
1. 預約資訊
- 預約驗證（多組，顯示每組的通路/門市）
- 付款人姓名
- 付款人信箱
- 付款人電話
- 商品描述
2. 超商資訊
- 指定通路
- 繳費代碼
- 繳費期限
- 條碼 1/2/3（若有）
3. 繳費結果
- 實際繳費通路
- 實際繳費門市代號
- 付款時間
- 實際付款金額
4. 撥款資訊
- 下撥時間
- 撥款批次號（可點擊跳轉至撥款歷程頁面）
- 服務費（預估值）
- 手續費（預估值）
5. 發票資訊
- 發票號碼
- 發票金額
- 發票稅率
- 作廢狀態（若發票已作廢，顯示作廢標記與時間）
狀態變更歷程
展開訂單後，底部顯示狀態變更歷程表，完整記錄每一次狀態轉換的上下文：
| 欄位 | 說明 |
|---|---|
| 時間 | 狀態變更的時間 |
| 原狀態 | 變更前的狀態 |
| 新狀態 | 變更後的狀態 |
| 觸發來源 | 建立 / 供應商回調 / 人工補登 / 撥款 / 系統 |
| 操作者 | 商戶代碼（建立時）、操作人員帳號（人工補登/撥款時）、或 -（供應商回調） |
| IP | 觸發此變更的來源 IP 位址 |
| 裝置 | User-Agent（瀏覽器/裝置資訊，滑鼠移入可查看完整字串） |
| 指紋 | 瀏覽器指紋識別碼（僅人工操作時記錄） |
| 描述 | 完善的變更說明，例如：「商戶 XXXX 建立 CVS 訂單, 金額 500」、「供應商回傳繳費資訊 (CatPay)」、「人工補登 CVS」、「batch BATCH-xxx」 |
追蹤與稽核
狀態變更歷程完整記錄了 IP、裝置指紋與 User-Agent，可供安全稽核與問題追蹤使用。供應商回調會記錄回調伺服器的 IP 與 User-Agent；人工操作會記錄管理員的瀏覽器指紋。
操作按鈕
商戶回調紀錄
點擊 Webhook 圖示開啟彈窗，顯示：
- 訂單號
- 回調網址（商戶設定的 notifyUrl）
- 人工補發回調 按鈕（僅 SUCCESS/SETTLED 狀態且有 notifyUrl 時顯示）
- 回調嘗試列表：每次嘗試顯示次數、時間（台灣時間）、HTTP 回應狀態碼、請求內容（JSON）、回應內容
人工補發回調
若商戶端未正確接收回調通知，可使用此功能重新發送。操作前會要求二次確認。
供應商通訊紀錄
點擊檔案圖示開啟彈窗，顯示：
- 發送給供應商：系統發送給上游供應商的原始請求（JSON，可複製）
- 供應商回應：供應商回傳的原始回應（JSON，可複製）
- 供應商回調紀錄：每筆回調顯示類型（取號回調/繳費回調）、時間（台灣時間）、狀態、原始資料（JSON，可複製）
人工補登
僅在 PROCESSING 狀態的訂單顯示，用於手動確認付款。需要二階段確認。
刪除訂單
點擊刪除按鈕後需輸入 TOTP 二階段驗證碼 才能刪除訂單。
DANGER
刪除訂單是不可復原的操作，請謹慎使用。
匯出 CSV
點擊 「匯出」 按鈕，依據目前篩選條件匯出所有訂單（上限 99,999 筆）。
匯出欄位包含表格可見欄位，以及展開詳情中的所有欄位（預約資訊、超商資訊、繳費結果、撥款資訊、發票資訊）。
檔案命名格式：cvs-orders-{日期}.csv
即時更新
頁面透過 WebSocket 連線即時接收訂單狀態變更。當有新的繳費代碼、付款完成或其他狀態變更時，列表中的對應訂單會自動更新，無需手動重新整理。
無限捲動
訂單列表採用無限捲動載入，每次載入 500 筆。當捲動至頁面底部附近時，自動載入下一批資料。