USDT (Binance)
Vị trí trong admin: Finance › Payment channels › USDT (
/payments/usdt). Bật/tắt và phí: Finance › Payment channels › Fees & limits (/payments/fees). Tiền nạp chưa khớp: Finance › Payment channels › Gateway events › PayPal & USDT (/payments/events?tab=gateways).
Chức năng
Khách hàng gửi USDT vào địa chỉ nạp Binance của bạn; NexCMP sẽ đọc lịch sử nạp thông qua Binance API key chỉ đọc và cộng tiền vào ví khi khoản nạp khớp với một yêu cầu đang mở. Bạn không phải chịu thêm phí xử lý thanh toán nào ngoài phí của Binance, và NexCMP không bao giờ lưu trữ private key.
Yêu cầu
| Hạng mục | Yêu cầu |
|---|---|
| Tài khoản Binance | Tài khoản Binance đã xác minh và đã bật nạp USDT trên mạng bạn chọn. |
| API key | Một Binance API key chỉ có quyền Enable Reading. Enable Withdrawals, Internal Transfer và Spot/Margin Trading phải ở trạng thái off. |
| Giới hạn IP | Rất khuyến nghị: giới hạn key theo IP outbound của server (hộp thoại Test & verify address có hiển thị IP này). |
| Mạng | HTTPS outbound tới api.binance.com. Không cần mở cổng inbound. |
| Các mạng được hỗ trợ | TRX (Tron, TRC20), BSC (BNB Smart Chain, BEP20), SOL (Solana), ETH (Ethereum, ERC20). Coin được cố định là USDT. |
| Thành phần phụ thuộc | Không có. |
Chọn mạng một lần duy nhất
Khách hàng gửi nhầm mạng sẽ bị mất tiền. Hãy chọn mạng có phí thấp mà các sàn giao dịch của khách hàng hỗ trợ (TRX và BSC là các lựa chọn phổ biến) và không nên thay đổi thường xuyên.
Chuẩn bị hạ tầng
- Trên Binance, mở Account › API Management và tạo một API key mới (do hệ thống tạo). Đặt cho nó một nhãn như "NexCMP".
- Chỉnh sửa quyền: chỉ để chọn Enable Reading. Không bật quyền rút tiền, chuyển khoản hoặc giao dịch.
- Tại mục Restrict access to trusted IPs only, thêm địa chỉ IP public của máy chủ NexCMP của bạn. Nếu bạn chưa biết địa chỉ này, hãy tạo key mà không giới hạn IP, chạy kiểm tra lần đầu trong NexCMP (hệ thống sẽ hiển thị outbound IP), sau đó thêm IP vào.
- Sao chép API key và Secret key (khóa bí mật chỉ hiển thị một lần duy nhất).
- Mở Wallet › Deposit › Crypto, chọn USDT cùng mạng bạn sẽ sử dụng, rồi sao chép địa chỉ nạp tiền (ví dụ: địa chỉ
T...trên TRX hoặc0x...trên BSC/ETH).
Kết nối trong NexCMP
- Mở Finance › Payment channels › USDT (
/payments/usdt). - Tại mục API key (Binance › API Management), dán API key và API secret. Cả hai đều phải được nhập cùng nhau.
- Tại Deposit address, chọn Network và dán địa chỉ nạp USDT trên mạng đã chọn. Định dạng sẽ được kiểm tra theo từng mạng (
T+ 33 ký tự cho TRX,0x+ 40 ký tự hex cho BSC và ETH, base58 cho SOL). - Nhấp vào Save. Việc thay đổi địa chỉ hoặc mạng sẽ đặt lại trạng thái xác minh và tạm dừng kênh thanh toán cho đến khi bạn xác minh lại; trang sẽ yêu cầu bạn xác nhận.
- Nhấp vào Test & verify address. (Các thay đổi chưa lưu sẽ bị từ chối — quá trình kiểm tra chạy trên cấu hình đã lưu.) Hộp thoại sẽ hiển thị:
- các quyền của key (reading, withdrawals, internal transfer, trading, giới hạn IP) — cảnh báo màu đỏ cho các quyền nguy hiểm;
- outbound IP của máy chủ (để nhập vào Binance);
- mạng (nạp tiền đang mở hay đóng, số xác nhận yêu cầu, dust);
- địa chỉ mà Binance cấp cho mạng đó và liệu nó có khớp với địa chỉ của bạn hay không.
- Khi địa chỉ khớp, NexCMP sẽ ghi lại thời gian xác minh. Chỉ khi đó bạn mới có thể mở Fees & limits, bật USDT (Binance), kiểm tra USDT fee % (mặc định 1) cùng USDT request expires after (mins) (5–180, mặc định 30), rồi nhấp vào Save channels & fees.
Cơ chế khớp thanh toán
- Khách hàng nhập số tiền trong Billing › Deposit › USDT và nhấp vào Get deposit address.
- NexCMP tạo một yêu cầu và hiển thị địa chỉ, mạng cùng số tiền chính xác với 6 chữ số thập phân — ví dụ:
19.173742. Bốn chữ số thập phân cuối cùng là một nonce ngẫu nhiên giúp số tiền trở thành duy nhất cho yêu cầu đó. - Khách hàng phải gửi chính xác số tiền đó trên đúng mạng đó. Khoản thanh toán không khớp (làm tròn số tiền, sai mạng) sẽ không thể tự động gán.
- Cứ mỗi 60 giây, NexCMP sẽ đọc các giao dịch nạp trên Binance trong 24 giờ qua. Giao dịch nạp trùng khớp sẽ chuyển yêu cầu sang trạng thái confirming và sau khi Binance có đủ số xác nhận cần thiết, tiền sẽ được cộng vào ví. Yêu cầu đã ghi nhận tiền sẽ không bao giờ hết hạn trong khi đang chờ xác nhận.
- Yêu cầu không được thanh toán trong thời gian hiệu lực (mặc định 30 phút) sẽ được đánh dấu là hết hạn.
Kiểm tra
- Sau khi địa chỉ đã được xác minh và USDT đã được bật, hãy đăng nhập với tư cách khách hàng thử nghiệm và tạo yêu cầu nạp một khoản nhỏ (mức nạp tối thiểu).
- Gửi chính xác số tiền đó từ một ví hoặc sàn giao dịch khác. Chờ trong vài phút.
- Portal hiển thị Transfer seen — confirming, sau đó là USDT received — balance updated.
- Trang USDT hiển thị thời gian Last poll gần đây và Unmatched ở mức 0.
Hạn mức & lưu ý
- Tỷ giá. 1 USDT = 1.00 USD. Mức phí trong USDT fee % được hiển thị cho khách hàng và được trừ vào hoặc cộng thêm vào số tiền tùy thuộc vào Customer pays top-up fee.
- Không hoàn tiền. Các khoản thanh toán USDT không bao giờ được NexCMP hoàn lại về nguồn (HTTP 409
usdt_no_refund). Hãy hoàn tiền thủ công ngoài hệ thống nếu cần. - Giới hạn yêu cầu chờ. Khách hàng có số lượng yêu cầu đang mở bị giới hạn; vượt quá mức này máy chủ sẽ trả về
too_many_pending(HTTP 429). - Resellers có thể dùng tài khoản Binance riêng; xem Resellers.
- Nếu bạn dùng chung tài khoản Binance với hệ thống khác, hãy gán cho mỗi hệ thống một mạng khác nhau để hai poller không bao giờ nhìn thấy cùng một khoản nạp.
Khoản nạp không khớp
Một khoản nạp không khớp với bất kỳ yêu cầu nào (sai số tiền, sai mạng, yêu cầu đã hết hạn) sẽ tạo một sự kiện deposit.unmatched và cảnh báo cho quản trị viên. Mở Payment channels › Gateway events › PayPal & USDT, tìm sự kiện, kiểm tra giao dịch trên Binance và nhấp vào thao tác gán để cộng tiền cho đúng khách hàng. Bộ đếm Unmatched trên trang USDT và trên trang tổng quan kênh thanh toán sau đó sẽ giảm về 0.
Xử lý sự cố
| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| "API key và secret phải được nhập cùng nhau" | Chỉ điền một trường | Điền cả hai. |
| "Địa chỉ không đúng định dạng của mạng ..." | Địa chỉ không khớp với mạng đã chọn | Sao chép lại từ Binance cho đúng mạng đó. |
| "Thay đổi chưa lưu — Hãy Save trước rồi mới Test" | Kiểm tra chỉ chạy trên các cài đặt đã lưu | Nhấp vào Save, sau đó kiểm tra. |
| Cảnh báo "key có Enable Withdrawals" | Thừa quyền | Gỡ bỏ quyền này trong Binance API Management. |
| Cảnh báo "key chưa giới hạn IP" | ipRestrict đang tắt | Thêm IP outbound của máy chủ hiển thị trong hộp thoại. |
| Cảnh báo "key thiếu quyền Enable Reading" | Thiếu quyền | Bật Enable Reading. |
| Cảnh báo "Binance đã tắt nạp USDT trên mạng này" | Mạng bị tạm dừng | Chọn mạng khác hoặc chờ. |
| "NGUY HIỂM: địa chỉ được cấu hình khác với địa chỉ Binance cung cấp" | Sai địa chỉ hoặc mạng | Sao chép lại địa chỉ từ Binance cho mạng đó. |
| Công tắc USDT bị mờ trong Fees & limits | Địa chỉ chưa được xác minh | Chạy Test & verify address cho đến khi khớp. |
| Khách hàng đã thanh toán nhưng chưa được cộng tiền | Số tiền bị làm tròn hoặc sai mạng | Tìm sự kiện trong Gateway events và gán thủ công. |
| Đã ghi nhận khoản nạp nhưng thời gian chờ lâu | Chưa đủ số lượt xác nhận | Hãy chờ; yêu cầu sẽ không hết hạn trong khi đang xác nhận. |