Nạp tiền tự động bằng crypto giúp website ghi nhận giao dịch và cộng số dư mà không cần quản trị viên kiểm tra thủ công. Luồng cơ bản gồm tạo yêu cầu thanh toán, theo dõi giao dịch blockchain, xác minh số lần xác nhận và cập nhật số dư đúng một lần.
Vì đây là tính năng liên quan trực tiếp đến tài sản, bạn nên triển khai trên môi trường thử nghiệm, đọc tài liệu mới nhất của cổng thanh toán và bắt đầu bằng giao dịch giá trị nhỏ.
Chuẩn bị trước khi tích hợp
- Tài khoản tại cổng thanh toán được phiên bản mã nguồn CMSNT hỗ trợ.
- Địa chỉ ví đúng đồng tiền và đúng mạng lưới, ví dụ USDT trên TRON (TRC20).
- Quyền truy cập phần cấu hình nạp tiền trong Admin Panel.
- Một tài khoản hoặc ví khác để thực hiện giao dịch thử.
Lưu ý: Gửi tài sản sai mạng lưới có thể dẫn đến mất tiền. Luôn đối chiếu đồng tiền, network và địa chỉ trước khi giao dịch.
Kết nối cổng thanh toán với website
- 01
Tạo tài khoản dịch vụ
Đăng ký tài khoản, hoàn tất các bước xác minh cần thiết và bật bảo mật hai lớp nếu nhà cung cấp hỗ trợ.
- 02
Thêm địa chỉ ví nhận tiền
Chọn đúng loại tài sản và mạng lưới, nhập địa chỉ ví nhận. Kiểm tra lại ký tự đầu, cuối trước khi lưu.
- 03
Lấy thông tin kết nối
Sao chép token/API key và thông tin ví từ trang quản lý. Không chia sẻ token trong ảnh chụp hoặc kho mã công khai.
- 04
Cấu hình trong CMSNT
Vào phần Cài đặt nạp tiền Crypto, nhập token, địa chỉ ví và các trường liên quan rồi bật phương thức thanh toán.
- 05
Nạp số tiền thử nghiệm
Tạo một yêu cầu nạp mới, chuyển số tiền nhỏ đúng nội dung được hướng dẫn và theo dõi trạng thái cho đến khi đủ xác nhận.
Nguyên tắc xử lý giao dịch an toàn
- Mỗi giao dịch blockchain chỉ được cộng số dư một lần, kể cả webhook được gửi lặp.
- Chỉ ghi nhận khi số tiền, loại tài sản, mạng lưới và địa chỉ nhận đều khớp.
- Đợi đủ số lần xác nhận theo chính sách của cổng thanh toán.
- Lưu mã giao dịch (transaction hash), thời gian và tài khoản nhận để đối soát.
- Thiết lập cảnh báo cho giao dịch thất bại, thiếu số tiền hoặc quá thời gian xử lý.
Checklist trước khi mở cho khách hàng
- Kiểm tra tỷ giá, phí và số tiền nạp tối thiểu đang được áp dụng.
- Thử giao dịch đúng số tiền, thiếu số tiền và gửi lặp webhook.
- Đảm bảo token không xuất hiện trong HTML, log công khai hoặc thông báo lỗi.
- Viết hướng dẫn rõ về network, thời gian xác nhận và kênh hỗ trợ.
- Chuẩn bị quy trình xử lý thủ công khi nhà cung cấp hoặc blockchain gián đoạn.
Lưu ý khi vận hành
Phí dịch vụ, mạng lưới hỗ trợ và quy trình API có thể thay đổi. Quản trị viên cần đối chiếu tài liệu chính thức của nhà cung cấp theo định kỳ, theo dõi số dư vận hành và không để toàn bộ tài sản trong ví nóng kết nối trực tiếp với hệ thống.
