自動加值

管理後台位置：Finance › Payment channels › Fees & limits（/payments/fees），卡片Wallet & top-up (Billing › Policy)，區塊Auto top-up (Stripe / PayPal)。**入口網站位置：**Billing › Settings（/billing?settings=1）。

功能

當客戶的錢包餘額過低時，NexCMP 會向其已儲存的付款方式扣款並存入錢包，以避免執行中的服務因資金不足而遭到暫停。背景作業會每 5 分鐘檢查所有啟用的客戶。

需求

項目	需求
管道	已設定 Stripe 及/或 PayPal。
已儲存的方法	客戶擁有已儲存的卡片或 PayPal 帳號。
網站	主站，或是其 Stripe/PayPal 管道由平台代收的經銷商網站。
全域開關	Auto top-up enabled 為開啟狀態（預設為開啟）。

運作原理

在客戶進行首次 Stripe 或 PayPal 加值後，伺服器會儲存付款方式，並以 By usage 模式開啟自動加值功能——前提是該客戶從未自行設定過自動加值。存款畫面沒有額外的勾選方塊；伺服器會記錄時間、IP 位址與付款方式作為憑證。如果客戶後來關閉自動加值，系統將不會再自動重新開啟。

模式	觸發條件（當餘額低於...）	扣款金額
By usage（首次加值後預設）	接下來 24 小時的服務執行成本（計時虛擬機器加上 24 小時內到期的預付續約），但絕不高於 $5	四捨五入至整數美元的 24 小時成本，至少為minimum top-up，至多為 maximum top-up 與每日上限
Fixed amount	客戶自訂的門檻（$1 至 $500）	客戶自訂的金額（從 minimum top-up 到 $1,000，且大於門檻）

在 By usage 模式下若無執行中的服務，則不會進行扣款。

與門檻進行比較的餘額為錢包中的真實現金。促銷代碼產生的服務點數會分開保存且不予計入（參閱 Promotions）。

此費用比照一般加值處理：當開啟 Customer pays top-up fee 時，系統會向卡片收取金額加上費用，而錢包會獲得完整金額；若關閉該選項，錢包獲得的金額則為扣除費用後的金額。

設定全域限制

1. 開啟 Finance › Payment channels › Fees & limits (/payments/fees)。

2. 在 Auto top-up (Stripe / PayPal) 中設定：

   設定	預設值	Range	含意
   Auto top-up enabled	開啟	on 或 off	Off 會立即停止所有背景扣款。
   預設自動加值門檻（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）、預估當前用量與下次扣款，以及 Recent automatic top-ups。
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 進行一次加值。
錯誤 no_card (422)	所選的付款閘道沒有儲存的付款方式	請選擇有付款方式的閘道，或儲存一個付款方式。
金額發生錯誤 invalid_argument	固定模式超出允許的範圍	閾值 $1–$500，金額介於最低加值額與 $1,000 之間，且金額須大於閾值。
餘額偏低但未進行任何扣款	全域開關已關閉、依使用量模式下無運行中的服務、已達每日限制，或先前的扣款仍在等待中	請檢查開關、記錄與限制。
「連續 N 次嘗試失敗 — 自動加值在 3 次後關閉」	信用卡持續扣款失敗	客戶更換為新的存款信用卡。
狀態 Needs your confirmation	銀行要求進行 3-D Secure 驗證	客戶手動完成一次正常加值。