Tự động nạp tiền

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

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

Hạng mục	Yêu cầu
Kênh	Đã cấu hình Stripe và/hoặc 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

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, 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).

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

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.

Giao diện khách hàng thấy

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.

Kiểm tra

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). 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 ý

• 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ố

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.