商戶管理員

路徑：/admin/users/merchant  |  快捷鍵：4 → M  |  權限要求：merchantUsers

此頁面管理所有商戶端的管理員帳號。每個商戶管理員帳號必須綁定一個商戶，登入商戶後台後只能看到所綁定商戶的資料。

INFO

此頁面需要 merchantUsers.read 權限。內建角色中，root 與 系統管理員（systemAdmin） 預設具備完整的增刪改權限，系統人員（systemStaff） 預設看不到此頁面。

頁面說明

欄位	說明
帳號	登入用的使用者名稱
綁定商戶	綁定的商戶名稱與代碼；未綁定時顯示「未綁定」
角色	指派的商戶類型角色名稱（如「商戶負責人」）
IP 鎖定	是否啟用 IP 白名單登入限制（黃色「已啟用」/ 灰色「未啟用」）
IP 白名單	已設定的 IP 數量（N IPs），點擊可直接新增／複製／移除，不必進入編輯彈窗
Google 驗證	是否已啟用 2FA（綠色「已啟用」/ 灰色「未啟用」）
狀態	帳號啟用狀態（綠色「已啟用」/ 紅色「未啟用」）
操作	登入歷程、編輯、刪除按鈕

新增商戶管理員

1. 點擊右上角 「新增用戶」 按鈕（需 merchantUsers.create 權限）
2. 填寫以下資訊：

欄位	必填	說明
帳號	是	登入用的使用者名稱，至少 3 個字元，建立後不可修改
密碼	是	登入密碼，至少 4 個字元
綁定商戶	是	從商戶列表中搜尋選取，顯示為「商戶名稱（代碼）」
角色	是	從商戶類型角色中選擇，預設為商戶負責人
已啟用	否	預設啟用
啟用 IP 白名單登入限制	否	開啟後可新增允許登入的 IP（支援 IPv4 / IPv6，可多筆）

3. 點擊 「確認」 完成建立

此頁面沒有「顯示名稱」欄位

商戶管理員帳號的顯示名稱由系統沿用帳號名稱，新增與編輯彈窗都不會出現此欄位。

TIP

一個商戶可以有多個管理員帳號，每個帳號可分配不同角色以控制權限範圍。

編輯商戶管理員

1. 點擊操作欄的編輯圖示
2. 可修改的欄位：
   • 帳號：不可修改
   • 密碼：留空則不修改
   • 綁定商戶：可重新綁定至其他商戶
   • 角色：可重新指派
   • 啟用狀態：可切換
   • IP 鎖定與白名單：可切換並管理

查看登入歷程

點擊操作欄的歷史圖示，開啟彈窗顯示該商戶管理員的登入紀錄（時間、IP、裝置、結果、失敗原因）。

刪除商戶管理員

點擊刪除按鈕並確認即可刪除帳號。

商戶端人員管理

商戶負責人（merchantOwner）可在商戶後台的商戶人員頁面自行管理旗下人員帳號，包含新增帳號、指派角色、設定 IP 鎖定等功能，無需透過系統管理員操作。