---
title: Tự động nạp tiền
description: Tự động nạp tiền vào ví khách hàng từ thẻ đã lưu hoặc PayPal — hỗ trợ theo mức dùng và cố định, hạn mức chung cùng xử lý lỗi.
url: https://nexcmp.com/vi/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Tự động nạp tiền {#auto-top-up}

> **Vị trí trong admin:** Finance › Payment channels › Fees & limits (`/payments/fees`), thẻ **Wallet & top-up (Billing › Policy)**, mục **Auto top-up (Stripe / PayPal)**. **Vị trí trong portal:** Billing › Settings (`/billing?settings=1`).

## Chức năng {#what-it-does}

Khi số dư ví của khách hàng xuống quá thấp, NexCMP sẽ trừ tiền qua [phương thức thanh toán đã lưu](https://nexcmp.com/vi/docs/billing/saved-payment-methods/) và nạp vào ví, giúp các dịch vụ đang chạy không bị tạm ngưng vì thiếu tiền. Một tiến trình chạy ngầm sẽ kiểm tra tất cả khách hàng đã bật tính năng này **mỗi 5 phút**.

## Yêu cầu {#requirements}

| Hạng mục | Yêu cầu |
|---|---|
| Kênh | Đã cấu hình [Stripe](https://nexcmp.com/vi/docs/billing/stripe/) và/hoặc [PayPal](https://nexcmp.com/vi/docs/billing/paypal/). |
| Phương thức đã lưu | Khách hàng có thẻ đã lưu hoặc tài khoản PayPal đã liên kết. |
| Trang | Trang chính, hoặc trang reseller có kênh Stripe/PayPal do nền tảng trực tiếp thu hộ. |
| Công tắc toàn cục | **Auto top-up enabled** đang bật (mặc định bật). |

## Cách thức hoạt động {#how-it-works}

Sau **lần nạp tiền đầu tiên qua Stripe hoặc PayPal** của khách hàng, máy chủ sẽ lưu phương thức thanh toán và tự động bật tính năng tự động nạp ở chế độ **By usage** — chỉ khi khách hàng đó chưa từng tự cấu hình tự động nạp. Không có ô tick bổ sung nào trên màn hình nạp tiền; máy chủ sẽ ghi lại thời gian, địa chỉ IP và phương thức thanh toán làm bằng chứng. Nếu sau đó khách hàng tắt tự động nạp, tính năng này sẽ không bao giờ tự bật lại.

| Chế độ | Điều kiện kích hoạt (khi số dư thấp hơn...) | Số tiền bị trừ |
|---|---|---|
| **By usage** (mặc định sau lần nạp đầu tiên) | chi phí cho 24 giờ tiếp theo của các dịch vụ đang chạy (VM tính theo giờ cộng với các khoản gia hạn trả trước đến hạn trong 24 giờ), nhưng không bao giờ dưới **$5** | chi phí 24 giờ được làm tròn lên số USD nguyên, tối thiểu bằng [mức nạp tối thiểu](https://nexcmp.com/vi/docs/billing/minimum-top-up/), tối đa bằng mức nạp tối đa và hạn mức ngày |
| **Fixed amount** | ngưỡng do chính khách hàng đặt ($1 đến $500) | số tiền do chính khách hàng đặt (từ mức nạp tối thiểu đến $1,000, và lớn hơn ngưỡng kích hoạt) |

Khi không có dịch vụ nào đang chạy ở chế độ **By usage**, hệ thống sẽ không trừ tiền.

Số dư được so sánh với ngưỡng kích hoạt là **tiền thực tế trong ví**. Tín dụng dịch vụ từ mã khuyến mại được hạch toán riêng và không được tính (xem [Khuyến mại](https://nexcmp.com/vi/docs/billing/promotions/)).

Phí được xử lý như một lần nạp tiền thông thường: khi bật **Customer pays top-up fee**, thẻ sẽ bị trừ số tiền nạp cộng với phí và ví nhận đủ số tiền nạp; khi tắt, ví sẽ nhận số tiền nạp trừ đi phí.

## Cấu hình giới hạn toàn cục {#configure-the-global-limits}

1. Mở **Finance › Payment channels › Fees & limits** (`/payments/fees`).
2. Trong **Auto top-up (Stripe / PayPal)**, hãy thiết lập:

   | Cài đặt | Mặc định | Khoảng giá trị | Ý nghĩa |
   |---|---|---|---|
   | Auto top-up enabled | On | bật hoặc tắt | Tắt sẽ dừng ngay lập tức mọi giao dịch trừ tiền chạy ngầm. |
   | Ngưỡng nạp tiền tự động mặc định (USD, dự phòng cho chế độ cố định) | $5.00 | $0 đến $10,000 | Chỉ dùng làm ngưỡng khởi đầu trong chế độ cố định. |
   | Số lần nạp tiền tự động tối đa mỗi 24 giờ cho mỗi khách hàng | 3 | 1 đến 50 | Tính cả các lượt thử thành công lẫn đang chờ xử lý. |
   | Hạn mức số tiền nạp tự động mỗi 24 giờ cho mỗi khách hàng (USD) | $500.00 | $0 đến $1,000,000 | Tổng số tiền trừ tự động trong một ngày luân phiên (24 giờ). |

3. Nhấp vào **Save Wallet & top-up**.

![Phần Auto top-up của trang Fees and limits với công tắc toàn cục và các hạn mức hàng ngày](https://nexcmp.com/vi/docs/images/billing/auto-top-up-01-limits.webp)

## Giao diện khách hàng thấy {#what-the-customer-sees}

1. Trong portal, khách hàng mở **Billing** rồi nhấp vào **Settings**.
2. Bảng điều khiển hiển thị (các) phương thức đã lưu, công tắc bật/tắt, chế độ (**By usage** hoặc **Fixed amount**), mức sử dụng ước tính hiện tại cùng lần trừ tiền tiếp theo, và mục **Recent automatic top-ups**.
3. Chuyển sang **Fixed amount** cho phép họ nhập ngưỡng kích hoạt và số tiền nạp. Gạt tắt công tắc sẽ dừng mọi lượt trừ tiền.

![Cài đặt thanh toán của khách hàng với tính năng tự động nạp tiền ở chế độ By usage và các lần tự động nạp gần đây](https://nexcmp.com/vi/docs/images/billing/auto-top-up-02-portal.webp)

## Kiểm tra {#verify}

1. Với tư cách khách hàng thử nghiệm, hãy nạp tiền lần đầu bằng thẻ thử nghiệm ([Stripe](https://nexcmp.com/vi/docs/billing/stripe/#verify)). Mở **Billing › Settings**: tự động nạp tiền đã được bật.
2. Chạy một VM nhỏ để phát sinh mức sử dụng, rồi giảm số dư xuống dưới ngưỡng (ví dụ qua **Customers › customer › Credit / debit**).
3. Trong khoảng 5 phút, một khoản phí sẽ được trừ. Trong thẻ **Overview › Payment** của khách hàng, **Auto top-up history** hiển thị lượt nạp với trạng thái *Done*, đồng thời thông báo *Top-up received* được gửi đi.

## Hạn mức & lưu ý {#limits-notes}

- **Mỗi lần giảm chỉ trừ một lần.** Sau khi trừ tiền, tác vụ sẽ chờ cho đến khi số dư tăng trở lại trên ngưỡng hoặc hết thời gian chờ: 1 giờ sau khi thành công, 24 giờ sau khi giao dịch đang chờ xử lý, 30 phút sau khi gặp lỗi hệ thống.
- **Hạn mức hàng ngày.** Khi đạt đến bất kỳ hạn mức hàng ngày nào, hệ thống sẽ không trừ tiền và ghi nhận một dòng *Daily limit reached* (tối đa một lần mỗi 6 giờ).
- **Thất bại.** Thẻ bị từ chối, thẻ hết hạn hoặc không đủ số dư được tính là lỗi thẻ. Tác vụ sẽ thử lại sau 1 giờ, sau đó là 6 giờ, rồi 24 giờ. **Sau 3 lần lỗi thẻ liên tiếp, tính năng tự động nạp tiền sẽ bị tắt** và khách hàng nhận được thông báo (*Auto top-up failed*). Thanh toán cần khách hàng xác nhận (ví dụ 3-D Secure) không bị tính là thất bại; khách hàng sẽ được nhắc xác nhận giao dịch.
- **Không trừ tiền trùng lặp.** Mỗi lần trừ tiền được xử lý nguyên tử cho mỗi lần số dư giảm xuống dưới ngưỡng và sử dụng idempotency key tại cổng thanh toán.
- **Xóa thẻ** sẽ tắt tính năng tự động nạp tiền.
- **Reseller.** Nếu reseller sử dụng kênh thanh toán riêng, khách hàng sẽ không thể bật tính năng tự động nạp tiền (HTTP 403 `feature_disabled`).

## Xử lý sự cố {#troubleshooting}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Khách hàng không thể bật: "Top up once with a card or PayPal" | Chưa lưu phương thức thanh toán | Thực hiện nạp tiền một lần bằng thẻ hoặc PayPal trước. |
| Lỗi `no_card` (422) | Cổng thanh toán được chọn chưa có phương thức đã lưu | Chọn cổng thanh toán đã có phương thức lưu sẵn, hoặc lưu một phương thức mới. |
| Lỗi `invalid_argument` về số tiền | Chế độ Fixed nằm ngoài phạm vi cho phép | Ngưỡng $1–$500, số tiền nằm trong khoảng từ mức nạp tối thiểu đến $1,000, số tiền lớn hơn ngưỡng. |
| Không bị trừ tiền dù số dư đang ở mức thấp | Công tắc chung bị tắt, không có dịch vụ nào đang chạy ở chế độ By usage, đạt hạn mức hàng ngày hoặc lần trừ tiền trước đó vẫn đang chờ xử lý | Kiểm tra công tắc, lịch sử và các hạn mức. |
| "N lần thử thất bại liên tiếp — tự động nạp tiền sẽ tắt sau 3 lần" | Thẻ liên tục bị lỗi | Khách hàng thay thẻ bằng một lần nạp tiền mới. |
| Trạng thái *Needs your confirmation* | Ngân hàng yêu cầu 3-D Secure | Khách hàng hoàn tất một lần nạp tiền thông thường. |