發票與分類帳
**管理後台位置：**Finance › Billing（
/billing），包含Overview、Transactions（/billing/ledger）、Invoices（/billing/invoices）、Top-ups（/billing/deposits）、Payouts（/billing/payouts）、Vouchers（/billing/vouchers）與Reports（/billing/reports）分頁。**入口網站位置：**Billing（/billing）。
功能
NexCMP 中的每個金額均以美元美分儲存並記錄一次。核心概念：錢包分類帳是餘額的唯一真實來源；發票、加值付款與報表都是基於它所建立的檢視。分類帳是僅供附加 (append-only) 的 — 錯誤只能透過新增沖銷分錄來修正，絕不透過編輯歷史記錄來修改。
需求
| 項目 | 需求 |
|---|---|
| 角色 | 管理員。 |
| 賣家詳細資料 | 在 System › Settings › General 的 Seller & invoicing 分頁 (/settings?tab=seller) 中的 Seller details (printed on invoices) 卡片，設定法定名稱、統一編號、地址、聯絡電子郵件及發票號碼前綴。 |
| 相依項目 | 用於資金流入的 Payment channels。 |
組成元件
| 後台分頁 | 清單內容 | 典型用途 |
|---|---|---|
| Overview | 今日與本月營收、依種類區分的總帳總計（存款、扣款、退款、調整、折價券）、依狀態區分的發票、待處理退款、捷徑、過去 30 天內每個服務的消費 | 每日檢查 |
| Transactions | 錢包總帳，每個異動一行 | 說明客戶的餘額 |
| Invoices | 發票，以及包含每個服務每次購買記錄的第二個檢視畫面 Orders | 尋找文件、重新寄送、標記為已付款 |
| Top-ups | 透過支付閘道收到的款項 | 檢查付款、進行退款 |
| Payouts | 信用卡退款、聯盟行銷分潤、經銷商提領 | 核准支出款項 |
| Vouchers | 加值代碼 | 參見 Promotions |
| Reports | 依服務、依經銷商區分的營收 | 會計 |
交易（總帳）
欄位：時間、客戶、種類、服務、金額（帶正負號）、虛擬機器、參考編號、操作者、備註。篩選條件：種類、服務、客戶 ID、網站（當您有多個經銷商時）、日期範圍，以及虛擬機器連結。
| 類型 | 含意 |
|---|---|
deposit | 來自支付閘道的加值 |
charge | 為服務扣取的款項（訂單、續約、按小時計費等） |
refund | 退回錢包的款項 |
adjust | 管理員信用額度或借方，以及加值代碼（參考編號開頭為 vch:）——總覽將折價券顯示為獨立的一行 |
每一列都有一個參考編號，例如 dep:stripe:<payment-id>；相同的參考編號永遠不能寫入兩次，這就是為什麼重複的 Webhook 無法重複入帳。使用 Customers › List › customer › Credit / debit 來新增手動調整：原因為必填欄位，正數金額也會嘗試解鎖因資金不足而遭鎖定的虛擬機器，且該動作需要兩步驟確認。
發票
當客戶購買或續約從錢包扣款的項目，或是進行加值時，系統會自動建立發票。編號格式如 <prefix><YYYYMM>-<000001>（例如 NX202610-000042）；經銷商網站使用其專屬的前綴與序號。當您變更前綴時，現有編號絕不會改變。
| 欄位 | 數值 |
|---|---|
| 類型 | 收據、續約、加值、手動、退款 |
| 狀態 | 未付、已付、逾期、已取消、已退款 |
列上的動作：
| 動作 | 效果 |
|---|---|
| View / Print | 開啟發票；客戶入口網站也可以列印或儲存為 PDF。 |
| Mark paid（僅限未付或逾期） | 在不動用錢包資金的情況下將其標記為已付款——當客戶在 NexCMP 外部付款給您時使用。原因為必填欄位。對於續約發票，它也會延長並解鎖被鎖定的虛擬機器。 |
| Cancel（僅限未付或逾期） | 取消發票。原因為必填欄位。 |
| Resend | 再次以電子郵件寄送發票。 |
建立手動發票（分頁頂部的按鈕）：客戶 ID、1 至 50 行（說明、數量、單價）、選填的 VM ID、選填的到期天數（0 至 365，預設 7）、選填備註。建立時為未付款狀態；客戶可在 Billing › Invoice History 中檢視。
只要錢包有資金，服務的未付款發票將自動從錢包結清，因此客戶只需進行加值即可。
加值（付款）
每筆嘗試佔一行：時間、客戶、閘道與付款方式、類型（加值或自動加值）、狀態（待處理、已完成、失敗、已退款、有爭議、已取消）、客戶支付金額、手續費、實際入帳金額、閘道參考編號與完成時間。已完成的 Stripe 與 PayPal 付款提供 Refund 動作。使用「閘道事件」頁面檢視 Webhook（Payment channels）。
Payouts
三個子分頁：Card refunds（核准或拒絕退款請求；該請求由已完成的付款建立）、Affiliate payouts（佣金提領）與 Reseller withdrawals。所有決定皆會留下稽核記錄。
Reports
Revenue（30 天趨勢、按月統計、前幾大客戶）、By service 與 By reseller。
客戶看到的畫面
在Billing中，客戶擁有Balance、Deposit、Redeem code、Settings（自動加值）以及包含Invoice History、Payment Order、Ledger與Orders等頁籤的歷史紀錄（所有服務集中於單一列表，並可依服務與類型篩選）。每張發票均提供View、Print與Save as PDF；金額以USD計算，並可選擇以顯示貨幣呈現。
驗證
- 以測試客戶身分進行小額加值。
- Transactions顯示一筆
deposit紀錄，Top-ups顯示付款狀態為 Completed，且Overview的營收隨之增加。 - 購買項目：出現一筆
charge紀錄，且Invoices顯示帶有所設定賣家資訊的 Receipt 或 Renewal 發票。
限制與注意事項
- **僅供附加。**無法編輯或刪除帳戶明細行；如需修正請新增附帶原因的調整項目。
- **貨幣。**金額為USD；顯示貨幣僅供參考（參見Currency and exchange rates）。
- 退款至卡片分為兩個步驟（先提出申請，再於Payouts中審核）；USDT與銀行轉帳無法退款至原金流來源。
- 所有操作皆會記錄稽核於System › Logs › Admin actions中，並記錄您輸入的原因。
- **訂單與發票。**按小時計算的用量不會按小時開立發票；Orders檢視會將其按天數群組以便檢視。
故障排除
| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 客戶餘額異常 | 發生未預期的扣款、調整或優惠券 | 依客戶ID篩選Transactions並閱讀參照編號與備註。 |
| "發票已經付款" (409) | 對已付費的發票標記為已付 | 無需處理。 |
| 無法取消發票 | 僅能取消未付或逾期發票 | 已付發票請使用退款或調整項目。 |
| 發票缺少賣家資訊 | 尚未填寫 | 請在System › Settings › General › Seller & invoicing中填寫Seller details。 |
| 信用卡拒付 | 金額為零或超過 $100,000 | 請使用 1 分錢到 $100,000 之間的金額。 |
| 付款狀態長時間顯示 Pending | Webhook遺失 | 參見Gateway events並重新發送。 |