Appearance
雲帳戶餘額
路徑：/admin/finance/cloud-balance | 快捷鍵：8 → X
管理所有商戶的雲帳戶餘額，可進行手動加款或扣款操作。頁面透過 WebSocket 即時更新餘額。
只要「雲帳戶餘額－查看」權限就打得開
這一頁不再需要另外勾選商戶資料管理的查看權 —— 商店代碼與名稱改由餘額本身帶出來。 （編輯保留款仍屬寫入動作，需要商戶編輯權限。） 若載入失敗，畫面會直接顯示錯誤訊息，不會再是一張看起來正常、金額卻全是 $0.00 的空表。
總餘額
頁面頂部顯示 全部餘額合計（所有商戶雲帳戶餘額總和，大字粗體）。右側另有 「異動類型管理」 按鈕，可維護調整餘額時可選的異動類型（見下方「調整餘額」）。
表格欄位
| 欄位 | 說明 |
|---|---|
| NO. | 列表序號 |
| 商店代碼 | 商戶識別碼（等寬字型） |
| 商店名稱 | 商戶顯示名稱 |
| 帳戶餘額 | 目前雲帳戶餘額（粗體，$ 前綴） |
| 保留款 | 該商戶設定的保留款金額，可就地編輯 |
| 可用餘額 | 餘額扣除保留款後的可用金額（綠色正數，紅色負數） |
| 操作 | 調整餘額按鈕 |
啟用雙錢包的站點版面不同
部分站點把餘額拆成兩個錢包，表格會變成一個商戶佔兩排、欄位也不一樣， 詳見下方雙錢包：主錢包與卡卡錢包。
調整餘額
點擊錢包圖示開啟調整彈窗（滑鼠懸停時以 tooltip 提示功能名稱）：
操作類型
| 類型 | 說明 | 按鈕顏色 |
|---|---|---|
| 收入 | 增加商戶餘額 | 綠色 |
| 支出 | 扣減商戶餘額 | 紅色 |
表單欄位
| 欄位 | 說明 |
|---|---|
| 金額 | 必填，最小值為 1（$ 前綴） |
| 異動類型 | 從預設或自訂類型中選擇。預設類型：撥款入帳 / 退款 / 手動調帳 / 提領 / 手續費 / 其他 |
| 自訂異動類型 | 當選擇「其他」時顯示的自由輸入欄位 |
| 備註 | 選填的操作備註 |
確認流程
填寫完成後會顯示二次確認彈窗，包含操作類型、類別、備註等資訊，確認後執行操作。
雙錢包：主錢包與卡卡錢包（站點限定）
部分站點將卡對卡（卡片轉帳）通道的下撥金額與其他支付方式分離到兩個獨立錢包。
| 錢包 | 資金來源 |
|---|---|
| 主錢包 | 超商代碼 / ATM / 信用卡 的下撥 |
| 卡卡錢包 | 卡對卡通道的下撥 |
商戶端不感知錢包區分
錢包的區分僅系統人員可見可控。商戶後台與 API 串接看到的餘額一律是兩個錢包的加總， 商戶申請代付時也不需要（也無法）選擇錢包。
表格版面：一個商戶兩排
啟用雙錢包時，表格改成一個商戶佔兩排 —— 主錢包一排、卡卡錢包一排， 錢包合併成一欄，後面的欄位跟著逐排顯示：
| 欄位 | 說明 |
|---|---|
| 錢包 | 主錢包 / 卡卡錢包。是代付來源的那一排會加粗 |
| 帳戶餘額 | 該錢包的餘額 |
| 代付來源 | 每排一顆圓點，點未選的那一顆即切換。點選即時儲存，不需按儲存按鈕 |
| 代付申請中 | 該商戶待審核代付單的金額合計（含手續費），有待審單時以橙字標示 |
| 保留款 | 該商戶設定的保留款金額 |
| 可用餘額 | 該錢包的可用金額（綠色正數，紅色負數） |
NO. / 商店代碼 / 商店名稱 / 操作 是商戶層級的欄位，跨兩排合併顯示。
頁面頂端的「全部餘額合計」為兩錢包加總，旁邊另外以標籤顯示各錢包的全站小計，方便對帳。
代付申請中與可用餘額怎麼算
代付申請中與保留款只會出現在「代付來源」那一排，另一排顯示「—」。 每一排的可用餘額是：
可用餘額 ＝ 該錢包餘額 −（是代付來源時才扣掉申請中與保留款）
為什麼只算代付來源那一包
代付實際只從指定的那一包扣款。商戶送出代付申請時，系統就是用 「該錢包餘額 − 待審核總額 − 保留款」在判斷夠不夠 —— 把申請中攤在兩包、或改用兩錢包加總，都會出現 「後台顯示還有很多可用、商戶那邊卻推不出單」的落差。 另一包要頂上只能先做錢包互轉，所以它在代付這件事上就是 0。
數字會即時更新
新的代付申請進來、或待審單被核准／駁回時，代付申請中與可用餘額都會自動更新， 不必手動重新整理。
未啟用雙錢包的站點沒有這些欄位，表格維持一個商戶一排，可用餘額仍是「餘額 − 保留款」。
餘額可能為負數
代付核准時不會檢查選定錢包的餘額是否足夠。因為商戶端看到的是兩錢包加總， 商戶可能在加總足夠、但單一錢包不足的情況下送出申請，核准後該錢包就會變成負數。 餘額為負時會以紅字標示，看到請盡快用錢包互轉補足。
未設定時預設卡卡錢包
新商戶若未設定代付來源，系統預設從卡卡錢包扣款。
錢包互轉
點擊操作欄的左右箭頭圖示開啟互轉彈窗：
| 欄位 | 說明 |
|---|---|
| 轉出錢包 | 選擇主錢包或卡卡錢包，轉入錢包自動為另一個 |
| 互轉金額 | 必須大於 0，且不可超過轉出錢包的餘額 |
| 備註 | 選填 |
送出後會顯示二次確認彈窗，確認才執行。
互轉不需雙人審核
即使站點啟用了雙人審核，互轉也不經過審核流程。原因是互轉的兩個錢包加總守恆、 不改變商戶的總餘額；而「調整餘額」會實際增減金額，所以才需要審核。
但互轉會檢查轉出錢包的餘額是否足夠 —— 否則等於能用互轉把某個錢包推成負數。
互轉會產生兩筆雲帳戶歷程紀錄（轉出 −X、轉入 +X），共用同一個關聯單號，方便成對查詢。
調整餘額時選擇錢包
調帳彈窗新增「調整錢包」下拉，可指定要調整主錢包或卡卡錢包。 若站點同時啟用雙人審核，待審核卡片上會以標籤顯示這筆調帳的目標錢包。
權限
| 權限代碼 | 說明 |
|---|---|
cloudBalance.setWallet | 設定商戶的代付扣款來源錢包 |
cloudBalance.transfer | 執行錢包互轉 |
INFO
兩項權限僅在啟用雙錢包的站點才會出現在角色列表的權限編輯彈窗中，預設已分配給系統管理員（systemAdmin）角色。
一鍵校正功能停用
啟用雙錢包的站點不提供餘額一鍵校正。該功能的演算法建立在「單一錢包」的假設上， 在雙錢包環境下執行會把已成功的代付從主錢包重複扣一次而弄壞餘額。
雙人審核（站點限定）
部分站點啟用 雙人審核 機制，調整餘額不再由單一管理員直接生效，必須由 另一位 管理員核准後才會實際異動餘額。
運作流程
- 填寫調整表單並確認後，系統建立一筆審核請求，餘額 尚未 異動
- 頁面上方出現橘色的 「待審核」 卡片
- 由另一位管理員核准後，才實際執行加款／扣款
待審核卡片
| 項目 | 說明 |
|---|---|
| 申請人 | 送出此次調帳申請的管理員 |
| 申請時間 | 送出審核的時間 |
| 商戶 | 調帳對象商戶 |
| 收支 | 加款（Income）／扣款（Expense） |
| 金額 | 調整金額 |
| 分類 | 調帳類別 |
| 剩餘時間 | 距離自動過期的倒數（橘色 Badge） |
操作按鈕
| 角色 | 可用操作 |
|---|---|
| 申請人本人 | 取消 —— 撤回自己送出的申請 |
| 其他管理員 | 核准 —— 立即執行調帳 駁回 —— 需填寫駁回備註後送出 |
不可自審
送出申請的管理員無法核准自己的申請，只能取消。
30 分鐘自動過期
審核請求送出後 30 分鐘 內未被處理會自動過期，需要重新送出申請。
即時同步
待審核卡片透過 WebSocket 即時更新，其他管理員的送出／核准／駁回／取消動作會立即反映在你的畫面上。
權限
| 權限代碼 | 說明 |
|---|---|
cloudBalance.review | 審核（核准／駁回）雲帳戶調帳申請 |
INFO
此權限僅在啟用雙人審核的站點才會出現在角色列表的權限編輯彈窗中，預設已分配給系統管理員（systemAdmin）角色。
類別管理
點擊「管理類別」按鈕開啟類別管理彈窗：
內建類別（不可刪除）
| 類別 | 說明 |
|---|---|
| settlement | 下撥 |
| refund | 退款 |
| adjust | 調整 |
| withdraw | 提款 |
| fee | 手續費 |
自訂類別
- 輸入名稱後點擊新增
- 自訂類別可個別刪除
- 類別儲存於瀏覽器 localStorage
即時更新
頁面透過 WebSocket 連線即時接收餘額變更，餘額會自動更新無需重新整理。