Cổng Thanh toán Tự động & Quản lý QR Ngân hàng
Hướng dẫn cấu hình mã VietQR tự động, trigger chat gọi QR và quản lý QR nhận lương player qua /setupbankqr và /bankqr.
Tính năng Thanh toán QR Tự động trong Booking Bot V2 cho phép bot tạo mã VietQR động theo từng đơn đặt lịch hoặc yêu cầu nạp cọc. Khi khách hàng quét mã và chuyển khoản thành công, hệ thống sẽ tự động xác nhận hóa đơn và cộng tiền vào ví trong vòng 1–3 giây mà không cần nhân viên kiểm tra tài khoản thủ công.
Bên cạnh đó, hệ thống còn cung cấp giải pháp quản lý mã QR nhận lương của đội ngũ Player vô cùng chuyên nghiệp.
1. Cơ Chế Hoạt Động & Yêu Cầu
- Người cấu hình: Bắt buộc có quyền
Ownertrong bot. - Phía hệ thống: Máy chủ bot cần kích hoạt cổng dịch vụ HTTP Webhook để nhận tín hiệu giao dịch từ các cổng thanh toán.
- Phía Discord Server: Chủ máy chủ chỉ cần cài đặt thông tin số tài khoản ngân hàng và kênh nhận thông báo bằng lệnh
/payment-config.
2. Các Bước Cấu Hình Thanh Toán QR Máy Chủ
Bước 1: Thiết Lập Kênh Thông Báo Thanh Toán
Chỉ định kênh chat để bot gửi mã QR thanh toán cho khách hàng và thông báo trạng thái giao dịch:
/payment-config set-channel channel:#kenh-thanh-toanBước 2: Khai Báo Thông Tin Tài Khoản Ngân Hàng
Nhập chính xác thông tin tài khoản thụ hưởng của bạn để bot tạo mã VietQR chuẩn NAPAS:
/payment-config set-qr \
bank-name:VCB \
account-number:1234567890 \
account-name:"NGUYEN VAN A" \
description:"Thanh toan booking"Các tham số tùy chọn nâng cao:
| Tham số | Ý nghĩa | Mặc định |
|---|---|---|
trigger-message | Cụm từ khách hàng/supporter gõ để lấy nhanh mã QR chuyển khoản | qr |
background-image | Tải lên ảnh nền trang trí cho khung chứa mã QR | Không có |
background-image-url | Đường dẫn URL ảnh nền trang trí | Không có |
qr-size | Kích thước hiển thị mã QR (pixel) | 300 |
qr-offset-y | Độ lệch vị trí QR theo chiều dọc trên ảnh nền | 0 |
qr-rotation | Góc nghiêng của mã QR trên ảnh nền (độ) | 0 |
remove-qr-background | Xóa phông nền trắng của mã QR để tiệp màu với ảnh nền | False |
Bước 3: Xem Trước & Tinh Chỉnh Giao Diện
Sau khi cài đặt, bạn có thể kiểm tra hình ảnh mã QR mẫu hiển thị thực tế:
# Xem bảng thông số và ảnh QR mẫu
/payment-config view
# Xoay mã QR sang trái / phải nếu cần khớp với phông nền
/payment-config rotate-left degrees:5
/payment-config rotate-right degrees:5
# Đưa toàn bộ cấu hình hiển thị về mặc định ban đầu
/payment-config reset3. Lệnh Trigger Chat Gọi QR Nhanh Cho Khách
Supporter và khách hàng có thể gọi nhanh mã QR thanh toán vào trong kênh chat bằng câu lệnh ngắn gọn:
qr <số-tiền>- Ví dụ:
qr 100000➔ Bot sẽ tạo ngay một ảnh VietQR trị giá 100.000 VNĐ kèm thông tin tài khoản đã thiết lập. - Số tiền có thể để trống trong một số trường hợp tùy cấu hình máy chủ. Supporter nên kiểm tra và xác nhận khách đã sẵn sàng trước khi gửi QR.
4. Quản Lý QR Ngân Hàng Của Player (Nhận Lương)
Booking Bot V2 giải quyết triệt để tình trạng thất lạc số tài khoản khi chi trả lương cho Player nhờ hệ thống lưu trữ QR tập trung:
Bước 1: Thiết Lập Kênh Nhận QR Player (/setupbankqr)
Chủ máy chủ chỉ định một kênh riêng tư để player gửi ảnh mã QR tài khoản nhận tiền:
/setupbankqr channel:#nhan-qr-playerBước 2: Player Gửi Ảnh QR
- Player chỉ cần gửi hình ảnh mã VietQR ngân hàng cá nhân vào kênh đã được thiết lập.
- Bot sẽ tự động nhận diện, lưu trữ hình ảnh vào hồ sơ của player và gửi thông báo xác nhận thành công.
Bước 3: Quản Lý & Xuất Danh Sách Chi Trả Lương (/bankqr)
Vào mỗi kỳ quyết toán, ban quản trị hoặc bộ phận Kế toán (vai trò Cash) sử dụng lệnh /bankqr:
/bankqr- Lọc theo mức lương tối thiểu: Chỉ hiển thị những player có số dư lương đạt ngưỡng quy định để chuyển khoản hàng loạt.
- Quản lý phiên thanh toán (Sessions): Tạo phiên chi trả mới (
new session), kiểm tra danh sách (list), hoặc tái tạo phiên (recreate) giúp việc chi lương diễn ra tuần tự, không sợ trùng lặp hay sót người.
5. Các Cổng Thanh Toán Được Hỗ Trợ
Booking Bot V2 hỗ trợ linh hoạt 3 cổng đối soát giao dịch phổ biến nhất tại Việt Nam:
Pay2S Gateway:
- Cổng thanh toán ổn định, hỗ trợ quét biến động số dư Vietcombank, MBBank, Techcombank, TPBank, ACB, VietinBank và ví điện tử MoMo.
- Thời gian phản hồi webhook trung bình: 1 - 2 giây kể từ khi khách chuyển khoản thành công.
- Phù hợp cho các máy chủ có tần suất đơn booking dày đặc.
SePay Gateway:
- Tích hợp chuẩn Open Banking qua Webhook bảo mật bằng API Key.
- Tự động nhận diện nội dung chuyển khoản theo mã
bill-idđể khớp lệnh chính xác 100%. - Cung cấp giao diện quản trị biến động số dư chi tiết trên website SePay.
ApiPay Gateway:
- Giải pháp đối soát linh hoạt cho các chủ máy chủ sử dụng hệ thống tài khoản riêng biệt.
- Hỗ trợ cơ chế chữ ký điện tử (Signature Verification) chống giả mạo giao dịch.
6. Xử Lý Khi Khách Hàng Gõ Nhầm Nội Dung
Mỗi mã VietQR do bot tạo ra đều gắn liền với một mã hóa đơn duy nhất (ví dụ: DH12345 hoặc NAPCOC67890).
- Nếu chuyển khoản đúng cú pháp: Bot đối soát và xác nhận bill tự động trong tích tắc.
- Nếu chuyển khoản sai cú pháp hoặc ngân hàng xử lý chậm: Hóa đơn sẽ được đưa vào hàng đợi kiểm duyệt an toàn. Nhân viên có thể tra cứu và duyệt thủ công bằng quy trình tại Cơ chế duyệt BankQR Pending.