自动充值

管理后台位置：Finance › Payment channels › Fees & limits（/payments/fees），卡片Wallet & top-up (Billing › Policy)，分区Auto top-up (Stripe / PayPal)。**门户位置：**Billing › Settings（/billing?settings=1）。

功能说明

当客户的钱包余额过低时，NexCMP会对其saved payment method进行扣款并充值到钱包，从而避免运行中的服务因资金不足而被暂停。后台任务会每隔5分钟检查所有启用的客户。

前提条件

项目	要求
渠道	配置了Stripe和/或PayPal。
保存的方法	客户拥有保存的卡片或PayPal账户。
站点	主站点，或是其Stripe/PayPal通道由平台收款的分销商站点。
全局开关	Auto top-up enabled处于开启状态（默认开启）。

工作原理

在客户进行首次 Stripe 或 PayPal 充值后，服务器将保存支付方式并在 By usage 模式下开启自动充值——前提是该客户此前从未自己设置过自动充值。充值页面上没有多余的勾选框；服务器会记录时间、IP 地址和支付方式作为凭证。如果客户随后关闭了自动充值，系统将不会再自动将其重新开启。

模式	触发条件（当余额低于...）	扣款金额
By usage（首次充值后的默认模式）	未来 24 小时运行服务的费用（按小时计费的虚拟机加上 24 小时内到期的预付费续费），但绝不低于 $5	四舍五入到整美元的 24 小时费用，至少为最低充值金额，至多为最高充值金额和每日上限
Fixed amount	客户自定义的阈值（$1 至 $500）	客户自定义的金额（从最低充值金额到 $1,000，且大于阈值）

如果在 By usage 模式下没有运行中的服务，则不会扣费。

与阈值进行比较的余额是钱包中的真实资金。来自促销代码的服务额度单独存放且不计入在内（参见 Promotions）。

此费用的处理方式与普通充值相同：当开启 Customer pays top-up fee 时，卡片将扣除金额加上手续费，且钱包获得全额；关闭时，钱包获得金额减去手续费。

配置全局限制

1. 打开 Finance › Payment channels › Fees & limits (/payments/fees)。

2. 在 Auto top-up (Stripe / PayPal) 中设置：

   设置	默认值	范围	说明
   Auto top-up enabled	开启	开或关	关闭会立即停止所有后台扣款。
   默认自动充值阈值（USD，固定模式回退）	$5.00	$0 到 $10,000	仅用作固定模式下的起始阈值。
   每个客户每24小时最大自动充值次数	3	1 至 50	计算成功和待处理的尝试次数。
   每个客户每24小时自动充值金额上限（USD）	$500.00	$0 至 $1,000,000	滚动一天内的自动扣款总额。

3. 点击 Save Wallet & top-up。

客户所见内容

1. 在门户中，客户打开 Billing 并点击 Settings。
2. 面板显示保存的支付方式、开关、模式（By usage 或 Fixed amount）、预计当前使用量与下一次扣款，以及近期自动充值。
3. 切换到 Fixed amount 允许他们输入阈值和金额。关闭开关可停止扣款。

验证

1. 作为测试客户，使用测试卡（Stripe）进行首次充值。打开Billing › Settings：自动充值已开启。
2. 运行一个小型虚拟机以产生用量，并将余额降至阈值以下（例如通过 Customers › customer › Credit / debit）。
3. 大约 5 分钟内会完成扣款。在客户的 Overview › Payment 卡片中，Auto top-up history 显示状态为 Done 的尝试，并且会发送 Top-up received 通知。

限制与注意事项

• **每次扣款触发一次。**扣款后，任务会暂停，直到余额回升至阈值以上或等待时间结束：成功后1小时，待处理扣款后24小时，系统错误后30分钟。
• **每日限制。**当达到任一每日限制时，将不进行扣款，并写入一条 Daily limit reached 记录（每6小时最多一次）。
• **失败处理。**拒付卡、过期卡或余额不足均计为卡片失败。任务将在1小时后重试，接着是6小时后，然后是24小时后。在连续3次卡片失败后，自动充值将被关闭，并会通知客户 (Auto top-up failed)。需要客户确认的付款（例如3-D Secure）不计入失败；系统会提示客户进行确认。
• **无重复扣款。**每次扣款在低于阈值时按原子操作执行，并在网关处使用幂等键。
• 移除卡片会关闭自动充值。
• **分销商。**如果分销商使用自己的支付通道，客户将无法启用自动充值（HTTP 403 feature_disabled）。

故障排查

症状	原因	解决办法
客户无法开启："使用银行卡或 PayPal 充值一次"	无保存的支付方式	请先通过银行卡或 PayPal 进行一次充值。
Error no_card (422)	所选网关没有保存的支付方式	选择一个有支付方式的网关，或保存一种支付方式。
Error invalid_argument on amount	固定模式超出允许范围	阈值 $1–$500，金额介于最低充值额与 $1,000 之间，且金额大于阈值。
余额虽低但未进行任何扣款	全局开关关闭、按使用量模式下无运行中的服务、已达到每日限制，或者上一次扣款仍在等待中	检查开关、历史记录和限制。
"连续失败 N 次 — 自动充值在 3 次后关闭"	银行卡持续扣款失败	客户更换一张新卡并进行存款。
状态 需要您确认	银行要求进行 3-D Secure 验证	客户手动完成一次常规充值。