发票与总账
**管理后台位置：**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 中的每个金额均以美元分（USD cents）存储并记录一次。核心理念：钱包总账是余额的唯一真实数据源；发票、充值付款和报告都是基于它生成的视图。总账是只追加的——错误只能通过添加红冲分录来修正，绝不能通过编辑历史记录来修改。
前提条件
| 项目 | 要求 |
|---|---|
| 角色 | 管理员。 |
| 卖家详情 | 在 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 | 按服务、按分销商统计的营收 | 会计核算 |
Transactions (ledger)
列：时间、客户、类型、服务、金额（带符号）、虚拟机、参考号、操作人、备注。筛选器：类型、服务、客户ID、站点（当您拥有分销商时）、日期范围以及虚拟机链接。
| 类型 | 说明 |
|---|---|
deposit | 来自网关的充值 |
charge | 为服务扣除的资金（订单、续费、按小时计费等） |
refund | 退回到钱包的资金 |
adjust | 管理员信用额度或借方，以及充值码（参考号以 vch: 开头）——概览将代金券显示为单独的一行 |
每一行都有一个参考号，例如 dep:stripe:<payment-id>；同一参考号永不重复写入，这就是重复的Webhook无法进行两次入账的原因。使用 Customers › List › customer › Credit / debit 添加手动调整：必须填写原因，正数金额还会尝试解锁因资金不足而被锁定的虚拟机，且该操作分两步确认。
Invoices
当客户购买或续费使用钱包支付的项目，或进行充值时，系统会自动创建发票。编号类似于 <prefix><YYYYMM>-<000001>（例如 NX202610-000042）；分销商站点使用其自己的前缀和序列。更改前缀时，现有编号永远不会改变。
| 字段 | Values |
|---|---|
| 类型 | Receipt, Renewal, Top-up, Manual, Refund |
| 状态 | Unpaid, Paid, Overdue, Cancelled, Refunded |
Actions on a row:
| 操作 | Effect |
|---|---|
| View / Print | 打开发票；门户也可以打印或保存为PDF。 |
| Mark paid（仅限未付或逾期账单） | 将其标记为已支付 而不移动钱包资金——当客户在 NexCMP 之外向您付款时使用此功能。必须填写原因。对于续费发票，它还会延长并解锁被锁定的虚拟机。 |
| Cancel（仅限未付或逾期账单） | 取消发票。必须填写原因。 |
| Resend | 再次发送发票电子邮件。 |
Create manual invoice（标签页顶部的按钮）：客户 ID、1 到 50 行（描述、数量、单价）、可选的虚拟机 ID、可选的到期天数（0 到 365，默认 7）、可选备注。创建时为未支付状态；客户可在 Billing › Invoice History 中查看。
只要账户中有余额，服务的未付账单就会从钱包中自动结算，因此客户只需进行充值即可。
Top-ups (payments)
每行代表一次尝试：时间、客户、网关和支付方式、类型（充值或自动充值）、状态（pending、completed、failed、refunded、disputed、canceled）、客户支付金额、手续费、进入钱包的金额、网关参考号及完成时间。已完成的 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；金额以美元显示，也可按显示货币呈现。
验证
- 以测试客户身份进行小额充值。
- 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并进行重试。 |