---
title: 自動加值
description: 透過已儲存的卡片或 PayPal 帳號自動維持客戶錢包餘額 — 支援用量計費與固定模式、全域限制及失敗處理。
url: https://nexcmp.com/zh-tw/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 自動加值 {#auto-top-up}

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

## 功能 {#what-it-does}

當客戶的錢包餘額過低時，NexCMP 會向其[已儲存的付款方式](https://nexcmp.com/zh-tw/docs/billing/saved-payment-methods/)扣款並存入錢包，以避免執行中的服務因資金不足而遭到暫停。背景作業會**每 5 分鐘**檢查所有啟用的客戶。

## 需求 {#requirements}

| 項目 | 需求 |
|---|---|
| 管道 | 已設定 [Stripe](https://nexcmp.com/zh-tw/docs/billing/stripe/) 及/或 [PayPal](https://nexcmp.com/zh-tw/docs/billing/paypal/)。 |
| 已儲存的方法 | 客戶擁有已儲存的卡片或 PayPal 帳號。 |
| 網站 | 主站，或是其 Stripe/PayPal 管道由平台代收的經銷商網站。 |
| 全域開關 | **Auto top-up enabled** 為開啟狀態（預設為開啟）。 |

## 運作原理 {#how-it-works}

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

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

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

與門檻進行比較的餘額為**錢包中的真實現金**。促銷代碼產生的服務點數會分開保存且不予計入（參閱 [Promotions](https://nexcmp.com/zh-tw/docs/billing/promotions/)）。

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

## 設定全域限制 {#configure-the-global-limits}

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**。

![具有全域開關與每日限制的 Fees and limits 頁面自動加值區段](https://nexcmp.com/zh-tw/docs/images/billing/auto-top-up-01-limits.webp)

## 客戶看到的畫面 {#what-the-customer-sees}

1. 在客戶端入口網站中，客戶會開啟 **Billing** 並點擊 **Settings**。
2. 面板會顯示已儲存的付款方式、開關、模式（**By usage** 或 **Fixed amount**）、預估當前用量與下次扣款，以及 **Recent automatic top-ups**。
3. 切換至 **Fixed amount** 可讓他們輸入門檻與金額。關閉開關即可停止扣款。

![具備 By usage 模式自動加值與近期自動加值的客戶帳單設定](https://nexcmp.com/zh-tw/docs/images/billing/auto-top-up-02-portal.webp)

## 驗證 {#verify}

1. 以測試客戶身分使用測試卡進行首次加值（[Stripe](https://nexcmp.com/zh-tw/docs/billing/stripe/#verify)）。前往**Billing › Settings**：自動加值已開啟。
2. 執行小型虛擬機器以產生用量，並將餘額降至門檻以下（例如透過 **Customers › customer › Credit / debit**）。
3. 大約 5 分鐘內就會完成扣款。在客戶的 **Overview › Payment** 卡片中，**Auto top-up history** 會顯示狀態為 *Done* 的嘗試紀錄，並會發送 *Top-up received* 通知。

## 限制與注意事項 {#limits-notes}

- **每次餘額下降執行一次扣款。** 扣款後，作業會等待，直到餘額回升至閾值以上或等待時間結束：成功後 1 小時、待處理扣款後 24 小時、系統錯誤後 30 分鐘。
- **每日限制。** 當達到任一每日限制時，將不會進行扣款，並會寫入一筆 *Daily limit reached* 記錄（每 6 小時最多一次）。
- **失敗。** 信用卡被拒、過期或餘額不足均視為信用卡失敗。系統將在 1 小時後、6 小時後以及 24 小時後重試任務。**連續 3 次信用卡失敗後，自動加值將被關閉**，並且會通知客戶 (*Auto top-up failed*)。需要客戶確認的付款（例如 3-D Secure）不計入失敗；系統會提示客戶進行確認。
- **無重複扣款。** 每筆扣款在低於閾值時以原子方式執行，並在金鑰閘道使用冪等性金鑰。
- **移除信用卡**會關閉自動加值。
- **經銷商。** 若經銷商使用自己的付款管道，客戶將無法啟用自動加值 (HTTP 403 `feature_disabled`)。

## 故障排除 {#troubleshooting}

| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 客戶無法開啟：「請使用信用卡或 PayPal 加值一次」 | 無儲存的付款方式 | 請先使用信用卡或 PayPal 進行一次加值。 |
| 錯誤 `no_card` (422) | 所選的付款閘道沒有儲存的付款方式 | 請選擇有付款方式的閘道，或儲存一個付款方式。 |
| 金額發生錯誤 `invalid_argument` | 固定模式超出允許的範圍 | 閾值 $1–$500，金額介於最低加值額與 $1,000 之間，且金額須大於閾值。 |
| 餘額偏低但未進行任何扣款 | 全域開關已關閉、依使用量模式下無運行中的服務、已達每日限制，或先前的扣款仍在等待中 | 請檢查開關、記錄與限制。 |
| 「連續 N 次嘗試失敗 — 自動加值在 3 次後關閉」 | 信用卡持續扣款失敗 | 客戶更換為新的存款信用卡。 |
| 狀態 *Needs your confirmation* | 銀行要求進行 3-D Secure 驗證 | 客戶手動完成一次正常加值。 |