---
title: Kênh thanh toán
description: Cách khách hàng nạp tiền vào ví trong NexCMP — các kênh khả dụng, cách bật từng kênh, phí, hạn mức và cách theo dõi chúng.
url: https://nexcmp.com/vi/docs/billing/payment-channels/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Kênh thanh toán {#payment-channels}

> **Vị trí trong admin:** Finance › Payment channels (`/payments`). Bật/tắt và biểu phí: Finance › Payment channels › Fees & limits (`/payments/fees`).

NexCMP sử dụng **ví USD trả trước**. Khách hàng nạp tiền vào ví thông qua kênh thanh toán; mọi dịch vụ sau đó đều được thanh toán từ ví. Một kênh chỉ hiển thị cho khách hàng khi vừa được **bật** vừa được **cấu hình**.

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

Payment channels kết nối tài khoản thanh toán của bạn (Stripe, PayPal, Binance, ngân hàng Việt Nam) với ví khách hàng. Mỗi thanh toán được xác nhận sẽ tạo thành đúng một khoản cộng tiền vào ví — mỗi khoản nạp được định danh bằng payment ID từ cổng thanh toán, do đó webhook gửi lặp lại sẽ không bao giờ cộng tiền hai lần. Hãy sử dụng trang này để xem kênh nào đã sẵn sàng, hiệu quả hoạt động trong 30 ngày qua và kênh nào cần xử lý.

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

| Hạng mục | Yêu cầu |
|---|---|
| Địa chỉ HTTPS công khai | Các cổng thanh toán gửi webhook đến `https://<domain>/v1/billing/...`, vì vậy bảng điều khiển của bạn phải truy cập được từ Internet qua kết nối TLS hợp lệ (xem [DNS and Cloudflare](https://nexcmp.com/vi/docs/getting-started/dns-and-cloudflare/)). |
| Tài khoản | Tài khoản riêng của bạn tại từng nhà cung cấp muốn sử dụng. Thông tin xác thực được nhập trong trang admin và không bao giờ hiển thị lại (chỉ hiển thị 4 ký tự cuối). |
| Vai trò Admin | Một tài khoản quản trị viên. |
| Thành phần phụ thuộc | Không có. Riêng kênh ngân hàng VN cần thêm [tỷ giá quy đổi](https://nexcmp.com/vi/docs/catalog/currency-and-exchange-rates/). |

## Các kênh thanh toán {#the-channels}

| Kênh | Giao diện khách hàng thấy | Cấu hình tại | Bài viết |
|---|---|---|---|
| Thẻ (Stripe) | Biểu mẫu nhập thẻ, thẻ đã lưu | Payment channels › Stripe | [Stripe](https://nexcmp.com/vi/docs/billing/stripe/) |
| Apple Pay, Google Pay, Link | Các nút ví điện tử (Stripe Express Checkout) | Stripe, kèm xác thực tên miền | [Stripe](https://nexcmp.com/vi/docs/billing/stripe/#apple-pay-google-pay-and-link) |
| Alipay | Chuyển hướng đến Alipay (Stripe thanh toán bằng JPY) | Stripe, kèm Fees & limits | [Stripe](https://nexcmp.com/vi/docs/billing/stripe/#alipay) |
| PayPal | Các nút PayPal, tài khoản PayPal đã lưu | Payment channels › PayPal | [PayPal](https://nexcmp.com/vi/docs/billing/paypal/) |
| USDT | Địa chỉ nạp tiền và số tiền chính xác | Payment channels › USDT | [USDT](https://nexcmp.com/vi/docs/billing/usdt/) |
| Chuyển khoản ngân hàng VN | Mã QR và thông tin chuyển khoản (chỉ có trên giao diện tiếng Việt) | Payment channels › VN bank transfer | [Chuyển khoản ngân hàng (Việt Nam)](https://nexcmp.com/vi/docs/billing/bank-transfer-vn/) |

## Chuẩn bị hạ tầng {#prepare-the-infrastructure}

Không yêu cầu. Mọi thứ đều được cấu hình trong admin; không cần cài đặt gì thêm trên máy chủ.

## Kết nối trong NexCMP {#connect-in-nexcmp}

1. Mở **Finance › Payment channels** (`/payments`). Bảng tổng quan liệt kê từng kênh cùng trạng thái tương ứng.
2. Mở tab riêng của kênh (**Stripe**, **PayPal**, **USDT**, **VN bank transfer**) và làm theo bài viết hướng dẫn. Cuối mỗi tab đều có nút **Save** và nút **Test** nếu kênh đó hỗ trợ.
3. Mở **Fees & limits** (`/payments/fees`), tìm thẻ **Payment gateways & fees (wallet top-up)**, bật kênh bằng công tắc tương ứng và nhấp **Save channels & fees**.

![Tổng quan payment channels liệt kê các cổng thanh toán cùng trạng thái bật, cấu hình và số liệu thống kê 30 ngày](https://nexcmp.com/vi/docs/images/billing/payment-channels-01-overview.webp)

![Trang Fees and limits với các công tắc bật kênh và các trường cấu hình phí](https://nexcmp.com/vi/docs/images/billing/payment-channels-02-fees.webp)

### Công tắc và phí (Fees & limits) {#switches-and-fees-fees-limits}

| Cài đặt | Mặc định | Ý nghĩa |
|---|---|---|
| Thẻ (Stripe) | On | Biểu mẫu thẻ trên màn hình nạp tiền. Bị ẩn cho đến khi Stripe có secret key. |
| Apple Pay, Google Pay, Link | On | Các nút ví điện tử. Chúng chỉ xuất hiện khi tên miền đã được xác minh trên Stripe. |
| Alipay | Tắt | Cần kích hoạt Alipay trong Stripe Dashboard. |
| PayPal | Tắt | Chỉ hiển thị khi PayPal đã được cấu hình. |
| USDT (Binance) | Tắt | Nút gạt bị khóa cho đến khi địa chỉ nạp tiền được xác minh với Binance. |
| Phí Stripe % / cố định (cents) | 3.6 % và 0 | Dùng để hiển thị phí cho khách hàng và tính toán số tiền được ghi có. Hãy đặt theo biểu phí Stripe thực tế của bạn. |
| Phí PayPal % / cố định | 4.4 % và 30 cents | Tương tự, dành cho PayPal. |
| Phí USDT % | 1 % | Tương tự, dành cho USDT. |
| Khách hàng trả phí nạp tiền | Tắt | **On**: khách hàng thanh toán số tiền + phí và ví nhận toàn bộ số tiền. **Off**: phí được khấu trừ và ví nhận số tiền trừ đi phí. |

Khách hàng luôn thấy phí và số tiền thực nhận vào ví trước khi thanh toán. Việc tắt một kênh sẽ ẩn nút thanh toán và máy chủ sẽ từ chối các khoản thanh toán mới với `method_disabled` (HTTP 403).

::: tip Hạn mức nạp tiền
Số tiền tối thiểu và tối đa cho mỗi lần nạp tiền nằm trên cùng một trang — xem [Minimum top-up](https://nexcmp.com/vi/docs/billing/minimum-top-up/).
:::

## Kiểm tra {#verify}

1. Trên bảng tổng quan, kênh hiển thị **Enabled** và **Configured**; cột **Last test** sẽ được điền sau khi bạn nhấp vào **Test** trên tab của kênh.
2. Đăng nhập vào portal với tư cách khách hàng thử nghiệm và mở **Billing › Deposit**. Nút của kênh sẽ xuất hiện.
3. Thực hiện một khoản thanh toán nhỏ (xem bài viết của kênh để biết thẻ thử nghiệm hoặc tài khoản sandbox). Số dư tăng lên, thông báo **Top-up received** xuất hiện và khoản thanh toán được liệt kê trong **Finance › Billing › Top-ups** (`/billing/deposits`).

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

- **Các cột trong bảng tổng quan:** *30 days* (số lượng giao dịch, thành công, thất bại và khối lượng), *Stuck 24h* (các khoản thanh toán vẫn đang chờ xử lý sau một ngày) và *Unmatched* (USDT hoặc chuyển khoản ngân hàng đã nhận nhưng không khớp với đơn hàng nào). Hàng KPI cộng tổng khối lượng 30 ngày, số lượng kênh lỗi (đã bật nhưng chưa cấu hình, hoặc có thanh toán bị nghẽn) và tổng số khoản không khớp.
- **Các sự kiện webhook** được liệt kê tại **Payment channels › Gateway events** (`/payments/events`). Stripe có tab riêng; PayPal và USDT dùng chung một tab. Sự kiện thất bại có thể được phát lại — sổ cái ví có tính lũy đẳng, nên việc phát lại không bao giờ ghi có hai lần.
- **Resellers** có thể có các kênh Stripe, PayPal, USDT và ngân hàng riêng. Các hàng của họ cũng xuất hiện ở đây, và bộ chọn site ở phần đầu trang sẽ lọc chúng. Xem [Resellers](https://nexcmp.com/vi/docs/customers/resellers/).
- **Hoàn tiền:** Các khoản thanh toán Stripe và PayPal có thể được hoàn tiền từ danh sách thanh toán; các khoản thanh toán USDT không thể hoàn về nguồn ban đầu (máy chủ sẽ trả về `usdt_no_refund`).
- **Maintenance mode** vẫn tiếp nhận webhook từ cổng thanh toán, do đó khoản thanh toán được thực hiện ngay trước thời gian bảo trì sẽ không bị mất.

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

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Kênh thanh toán bị thiếu trên màn hình nạp tiền của khách hàng | Đã bị tắt, chưa cấu hình, hoặc (ngân hàng VN) giao diện không phải tiếng Việt | Kiểm tra **Fees & limits** và tab của kênh; xem [Bank transfer (Vietnam)](https://nexcmp.com/vi/docs/billing/bank-transfer-vn/). |
| Chỉ số KPI **Faulty channels** lớn hơn 0 | Một kênh được bật nhưng chưa có thông tin xác thực, hoặc các khoản thanh toán bị treo hơn 24 giờ | Mở hàng tương ứng và nhấp vào **Configure**; đối với các khoản thanh toán bị treo, hãy mở **Gateway events** và phát lại. |
| Khách hàng đã thanh toán nhưng số dư không thay đổi | Webhook không gửi đến được | Kiểm tra URL webhook trên tab của kênh, sau đó phát lại sự kiện trong **Gateway events**. |
| Máy chủ phản hồi `method_disabled` | Nút gạt đang tắt | Bật nút gạt trong **Fees & limits** và lưu lại. |
| Nút gạt USDT bị mờ | Địa chỉ nạp tiền chưa được xác minh | Nhấp vào **Test & verify address** trên tab USDT. |