Cổng Thanh toán Tự động
Hướng dẫn cấu hình mã VietQR, gọi QR nhanh trong chat, BankQR trên bill và nạp cọc.
Tính năng Thanh toán QR cho phép bot tạo mã VietQR theo từng bill hoặc yêu cầu nạp cọc. Khi khách chuyển khoản đúng số tiền và nội dung, bot tự lên bill hoặc tự cộng cọc mà không cần supporter kiểm tra tài khoản.
Hoá đơn phí bank và gia hạn bot (Bill thanh toán kết hợp)
Quản trị viên dùng renew hoặc payment để nhận một bill thanh toán VietQR kết hợp bao gồm cả khoản gia hạn bot và các dòng phí dịch vụ bank đã được duyệt tới ngày thanh toán. Yêu cầu này thay thế cách gửi các thẻ thanh toán riêng biệt.
Giao diện hoá đơn hiển thị rõ ràng từng khoản phí:
- Phí duy trì bot
- Phí bank theo từng kỳ và nhà cung cấp (kèm hạn thanh toán)
- Tổng tiền thanh toán chung trên một mã VietQR
Quản trị viên hoặc developer có thể nhấn nút Huỷ gói bank ngay trên hoá đơn nếu không còn nhu cầu sử dụng tính năng bank tự động. Khi yêu cầu được ghi nhận, hệ thống tạo QR mới chỉ thu phí duy trì bot và tạm ngừng tính năng bank tự động cho tài khoản đó. Chủ hệ thống vẫn cần xác nhận việc ngừng ở nhà cung cấp và đối soát phí cũ; thao tác này không tự miễn nợ hoặc hoàn tiền.
Chỉ chuyển tiền theo QR mới sau khi huỷ. Nếu đã chuyển vào QR cũ hoặc QR hết hạn, liên hệ chủ hệ thống để đối soát; tiền đó không tự chuyển sang bill mới. Nếu truy vấn phí bank gặp lỗi, bot dừng tạo bill để tránh thiếu khoản phí; hãy thử lại hoặc liên hệ hỗ trợ.
Thanh toán đúng tổng bill chung sẽ tự động gia hạn bot và hoàn tất nghĩa vụ phí bank của các kỳ tương ứng.
1. Yêu Cầu
- Người cấu hình: quyền
Owner. - Kết nối ngân hàng: do đội vận hành Motional Hub thiết lập (qua cổng Pay2S, SePay hoặc ApiPay). Máy chủ cần đăng ký gói thuê API Bank / Open Banking của ngân hàng tại Việt Nam và được xác minh kết nối trước khi dùng QR nhận tiền.
Mục Tài khoản nhận tiền của /payment-config hiển thị trạng thái kết nối thanh toán. Nếu bot báo kết nối chưa được bật, hãy liên hệ đội hỗ trợ.
Điều Kiện Tích Hợp QR
QR nhận tiền của máy chủ gồm nạp cọc (/deposit, nút Nạp cọc), Book / Donate / Đi chơi bằng BankQR và gọi QR trong chat. Đội vận hành thiết lập kết nối thanh toán; máy chủ cấu hình ngân hàng và số tài khoản trong /payment-config. Khi tích hợp đầy đủ thì dùng QR; không chặn theo active, hạn hoặc binding subscription. Chưa tích hợp/thiếu cấu hình thì bot cảnh báo và hướng dẫn setup.
- Cần cấu hình QR khả dụng: tạo yêu cầu QR, tạo lại QR và lưu chỉnh sửa bill BankQR đang chờ. Bot kiểm tra lại cấu hình khi thao tác từ UI cũ.
- Không phụ thuộc tích hợp QR nhận tiền: Bank thủ công, thanh toán bằng Cọc hoặc Lương, cộng / trừ / chuyển cọc, quản lý lương, quỹ, cửa hàng, hoàn bill, chốt kỳ và QR trả lương cho player.
- Xác nhận nhận tiền thủ công vẫn kiểm tra quyền staff và trạng thái pending, không yêu cầu subscription. Yêu cầu đã nhận tiền vẫn được xử lý để hoàn tất bill hoặc cộng cọc. Xem, kiểm tra, hủy yêu cầu cũ và thử tạo lại bill đã nhận tiền không yêu cầu tạo QR mới.
Khi Bot Báo QR Chưa Khả Dụng
Bot chỉ hiện thông báo “Tính năng QR thanh toán chưa khả dụng trên server này.” Người có quyền Supporter trở lên thấy nút Thắc mắc / Xem chi tiết. Bấm nút để xem riêng lý do hiện tại và yêu cầu đăng ký; bot kiểm tra lại quyền tại thời điểm bấm. Khách và Player không thấy nút này nếu chưa có quyền Supporter.
Yêu cầu đăng ký được hiển thị trong phần xem chi tiết
Cần gói thuê API Bank / Open Banking của ngân hàng tại Việt Nam. Thông tin cần chuẩn bị: số tài khoản (STK), số CCCD, số điện thoại và họ tên. Đây là hướng dẫn chuẩn bị hồ sơ; bot không thu các thông tin này qua nút xem chi tiết. Các ô cấu hình QR bên dưới không phải biểu mẫu đăng ký API Bank.
2. Cấu Hình QR Của Máy Chủ
Gõ /payment-config để mở bảng cấu hình thanh toán. Bảng dùng giống /config: chọn mục ở danh sách phía trên, bấm nút để sửa, mọi thay đổi lưu ngay.
Bước 1: Nhập Tài Khoản Nhận Tiền
Mục Tài khoản nhận tiền ➔ bấm Nhập Tài Khoản và điền:
| Ô nhập | Ý nghĩa |
|---|---|
| Ngân hàng | Tên hoặc mã ngân hàng, ví dụ VCB, MB |
| Số tài khoản | Số tài khoản nhận tiền của máy chủ |
| Chủ tài khoản | Tên chủ tài khoản |
| Nội dung chuyển khoản mặc định | Để trống để dùng tên bot |
| Tin nhắn gọi QR | Chữ gõ để gọi QR nhanh (mặc định qr) |
Bước 2: Chọn Kênh Thông Báo Thanh Toán
Mục Kênh thông báo ➔ chọn kênh trong danh sách.
Bước 3: Chỉnh Hình QR (Tùy Chọn)
Mục Hình QR hiện ngay ảnh QR khách sẽ nhận, ảnh cập nhật sau mỗi lần chỉnh:
| Nút | Ý nghĩa |
|---|---|
| Nghiêng trái / phải 1° · 5° | Nghiêng QR từng bước, tối đa 45° mỗi phía |
| Kích Thước & Vị Trí | Kích thước QR (25 - 75%), độ nghiêng, dịch QR lên / xuống |
| Bật / Tắt nền trắng | Lớp nền trắng phía sau QR |
| Đặt Ảnh Nền · Bỏ Ảnh Nền | Tải ảnh lên hoặc dán URL ảnh làm nền cho QR |
| Xem Demo | Xem yêu cầu thanh toán khách sẽ nhận, chỉ bạn thấy |
Nút Về mặc định ở cuối mỗi mục xóa riêng phần của mục đó: kênh thông báo hoặc các chỉnh sửa hình QR. Ở mục Tài khoản nhận tiền nút này tên là Xoá Tài Khoản, ở mục Kênh Bank QR của player là Bỏ Kênh.
3. Gọi Nhanh QR Trong Chat
qr
qr 100kBot gửi mã VietQR kèm mã chuyển khoản riêng. Khi tiền về, tin QR tự chuyển sang trạng thái đã thanh toán.
- Nếu người gõ là Supporter, bot hỏi trước ai là người chuyển khoản: Khách hàng hoặc Bản thân.
- QR gọi nhanh không tạo bill. Muốn có bill, dùng BankQR ở mục dưới.
4. BankQR Trên Bill Book Và Donate
BankQR là cách trả bằng chuyển khoản: trong lệnh, trên bill và trên bảng tự phục vụ đều ghi là BankQR (chuyển khoản).
Khi lên bill, chọn thanh-toán: BankQR (chuyển khoản):
- Bot gửi QR với đúng số tiền của bill và mã chuyển khoản riêng.
- Khách chuyển khoản đúng số tiền và nội dung.
- Tiền về là bot tự lên bill, cộng lương và giờ cho player.
Mã QR hết hạn sau 3 giờ nếu chưa thanh toán. Cách xử lý khi bill chưa tự lên: BankQR đang chờ.
Dùng cọc trước khi tạo QR: nếu khách đang còn cọc, bot hỏi có muốn trả bằng cọc không. Xem Tiền cọc.
5. Nạp Cọc Bằng QR
Khách tự nạp cọc bằng /deposit hoặc nút Nạp cọc trên bảng tự phục vụ. Tiền về là bot cộng cọc ngay, không tạo bill. Xem Tiền cọc.
6. QR Bank Lương
Bank lương cho player theo tổng lương bot đã tính là tính năng riêng, khác với QR thanh toán của máy chủ. Xem QR Bank lương.
7. Câu Hỏi Thường Gặp
Tài khoản nhận tiền khác gì kênh Bank QR của player?
Cả hai nằm trong /payment-config. Mục Tài khoản nhận tiền là QR để khách trả tiền cho máy chủ. Mục Kênh Bank QR của player thuộc QR Bank lương: nơi player gửi QR để được bank lương.
Khách chuyển sai nội dung thì sao? Bot không tự khớp được. Supporter kiểm tra kênh log bank; khi thấy bot đã gửi thông báo nhận tiền thì bấm Check trên tin QR rồi Xác nhận đã nhận tiền để duyệt tay bill BankQR.