Cấu hình Thanh toán

Hướng dẫn thiết lập kênh nhận thông báo giao dịch và QR thanh toán bằng lệnh /payment-config

Hệ thống thanh toán cho phép Quản trị viên cấu hình kênh nhận thông báo giao dịch, thiết lập thông tin tài khoản nhận tiền và tùy chỉnh giao diện QR thanh toán.

Cấu hình thanh toán được lưu độc lập với hệ thống log chung của bot.

Việc kết nối tài khoản ngân hàng hoặc cổng thanh toán với hệ thống để tự động kiểm tra biến động số dư vẫn cần được đội ngũ Motional Hub hỗ trợ cài đặt.

Quản trị viên có thể tự cấu hình thông tin hiển thị QR, nội dung chuyển khoản và kênh nhận thông báo bằng lệnh /payment-config, nhưng việc nhập thông tin QR không đồng nghĩa với việc tài khoản ngân hàng đã được kết nối với hệ thống thanh toán tự động.

Lệnh cấu hình thanh toán

/payment-configSlash Command

Administrator

Quản lý kênh thông báo giao dịch và cấu hình QR thanh toán

Chỉ thành viên có quyền Administrator mới có thể sử dụng lệnh này.

Các lệnh con

Lệnh con	Mục đích	Cú pháp
`/payment-config set-channel`	Thiết lập kênh nhận thông báo giao dịch	`/payment-config set-channel channel:#payment-logs`
`/payment-config set-qr`	Thiết lập thông tin và giao diện QR thanh toán	`/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU"`
`/payment-config view`	Xem cấu hình thanh toán hiện tại	`/payment-config view`
`/payment-config rotate-left`	Nghiêng QR sang trái	`/payment-config rotate-left degrees:5`
`/payment-config rotate-right`	Nghiêng QR sang phải	`/payment-config rotate-right degrees:5`
`/payment-config remove`	Xóa cấu hình kênh thông báo	`/payment-config remove`
`/payment-config remove-qr`	Xóa cấu hình QR thanh toán	`/payment-config remove-qr`

Thiết lập kênh nhận thông báo

Sử dụng lệnh sau để chọn kênh Discord nhận thông báo khi hệ thống phát hiện giao dịch mới:

/payment-config set-channel channel:#payment-logs

Tham số

Tham số	Bắt buộc	Mô tả
`channel`	Có	Kênh văn bản Discord dùng để gửi thông báo giao dịch

Chỉ các kênh thuộc loại Guild Text Channel mới có thể được lựa chọn.

Bot cần có tối thiểu các quyền sau trong kênh:

View Channel
Send Messages
Embed Links
Attach Files nếu thông báo có đính kèm hình ảnh hoặc QR

Thiết lập QR thanh toán

Lệnh set-qr dùng để thiết lập thông tin tài khoản nhận tiền và tùy chỉnh giao diện QR.

Cú pháp cơ bản

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU"

Các tham số

Tham số	Bắt buộc	Mô tả
`bank-name`	Có	Tên ngân hàng hoặc brand name của ngân hàng
`account-number`	Có	Số tài khoản nhận tiền
`account-name`	Có	Tên chủ tài khoản
`description`	Không	Nội dung chuyển khoản mặc định
`trigger-message`	Không	Tin nhắn kích hoạt bot gửi QR, mặc định là `qr`
`background-image`	Không	Tệp ảnh nền tải trực tiếp từ Discord và lưu vào hệ thống
`background-image-url`	Không	URL ảnh nền được hệ thống tải và lưu lại
`qr-offset-y`	Không	Dịch QR theo chiều dọc, tính bằng pixel; số dương là xuống
`qr-rotation`	Không	Góc nghiêng của QR; số dương là nghiêng phải
`qr-size`	Không	Kích thước QR tính theo phần trăm, ví dụ `46` là `46%`
`remove-qr-background`	Không	Bật hoặc tắt lớp nền trắng phía sau QR

Ví dụ cấu hình đầy đủ

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" description:"THANH TOAN DICH VU" trigger-message:qr qr-offset-y:20 qr-rotation:0 qr-size:46 remove-qr-background:false

Nội dung chuyển khoản mặc định

Tham số description xác định nội dung được điền sẵn khi khách hàng quét QR.

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" description:"THANH TOAN DICH VU"

Nội dung thực tế vẫn có thể được thay đổi bởi từng chức năng booking, hóa đơn hoặc thanh toán của bot.

Tin nhắn kích hoạt QR

Tham số trigger-message xác định nội dung thành viên cần gửi để bot phản hồi bằng QR.

Giá trị mặc định là:

qr

Ví dụ thay đổi thành bank:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" trigger-message:bank

Sau khi cấu hình, thành viên chỉ cần gửi bank trong kênh phù hợp để nhận QR.

Nên sử dụng một từ khóa ngắn, dễ nhớ và không trùng với các tin nhắn thông thường trong server.

Tùy chỉnh ảnh nền QR

Hệ thống hỗ trợ hai cách thiết lập ảnh nền.

Tải ảnh trực tiếp

Sử dụng tham số background-image và đính kèm ảnh từ thiết bị:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" background-image:<tệp-đính-kèm>

Sử dụng URL ảnh

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" background-image-url:https://example.com/payment-background.png

Chỉ nên sử dụng một trong hai tùy chọn background-image hoặc background-image-url trong cùng một lần thiết lập.

Không nên sử dụng URL yêu cầu đăng nhập, URL tạm thời hoặc URL có thời hạn quá ngắn.

Điều chỉnh vị trí QR

Tham số qr-offset-y dùng để dịch QR lên hoặc xuống trên ảnh nền.

Giá trị dương: dịch QR xuống dưới.
Giá trị âm: dịch QR lên trên.
Giá trị 0: giữ QR tại vị trí mặc định.

Ví dụ dịch QR xuống 20px:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" qr-offset-y:20

Điều chỉnh góc nghiêng QR

Tham số qr-rotation dùng để thiết lập góc nghiêng của QR theo đơn vị độ.

Giá trị dương: nghiêng sang phải.
Giá trị âm: nghiêng sang trái.
Giá trị 0: không nghiêng.

Ví dụ nghiêng QR sang phải 3°:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" qr-rotation:3

Không nên sử dụng góc nghiêng quá lớn vì có thể làm giảm khả năng nhận diện QR của ứng dụng ngân hàng.

Điều chỉnh kích thước QR

Tham số qr-size xác định kích thước QR theo phần trăm so với vùng thiết kế.

Ví dụ đặt kích thước QR thành 46%:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" qr-size:46

Sau khi thay đổi, nên dùng /payment-config view để kiểm tra kết quả hiển thị.

Xóa nền trắng của QR

Sử dụng remove-qr-background:true để loại bỏ lớp nền trắng phía sau QR:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" remove-qr-background:true

Để giữ hoặc khôi phục nền trắng:

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" remove-qr-background:false

Chỉ nên xóa nền trắng khi ảnh nền vẫn tạo đủ độ tương phản. Ảnh nền quá nhiều chi tiết hoặc màu sắc có thể khiến QR khó quét.

Nghiêng QR sang trái

Lệnh rotate-left cho phép tinh chỉnh góc nghiêng hiện tại mà không cần nhập lại toàn bộ cấu hình.

/payment-config rotate-left

Mặc định, mỗi lần sử dụng sẽ nghiêng QR sang trái 1°.

Có thể chỉ định số độ:

/payment-config rotate-left degrees:5

Tham số	Bắt buộc	Mô tả
`degrees`	Không	Số độ cần nghiêng sang trái, mặc định là `1`

Nghiêng QR sang phải

/payment-config rotate-right

Mặc định, mỗi lần sử dụng sẽ nghiêng QR sang phải 1°.

Có thể chỉ định số độ:

/payment-config rotate-right degrees:5

Tham số	Bắt buộc	Mô tả
`degrees`	Không	Số độ cần nghiêng sang phải, mặc định là `1`

Xem cấu hình hiện tại

/payment-config view

Lệnh này có thể hiển thị:

Kênh nhận thông báo giao dịch.
Trạng thái truy cập của kênh.
Tên ngân hàng.
Số tài khoản.
Tên chủ tài khoản.
Nội dung chuyển khoản mặc định.
Tin nhắn kích hoạt QR.
Trạng thái ảnh nền.
Vị trí, kích thước và góc nghiêng của QR.
Trạng thái nền trắng phía sau QR.
Bản xem trước QR nếu hệ thống hỗ trợ.

Hệ thống cũng kiểm tra xem kênh còn tồn tại, bot còn đủ quyền và cấu hình QR có đầy đủ dữ liệu bắt buộc hay không.

Xóa cấu hình kênh thông báo

/payment-config remove

Lệnh này chỉ xóa cấu hình kênh nhận thông báo thanh toán.

Thông tin QR, tài khoản ngân hàng, ảnh nền và nội dung chuyển khoản không bị xóa.

Xóa cấu hình QR

/payment-config remove-qr

Lệnh này xóa toàn bộ cấu hình QR thanh toán, bao gồm:

Tên ngân hàng.
Số tài khoản.
Tên chủ tài khoản.
Nội dung chuyển khoản mặc định.
Tin nhắn kích hoạt.
Ảnh nền QR.
Vị trí, kích thước và góc nghiêng.
Thiết lập nền trắng.

Cấu hình kênh nhận thông báo giao dịch không bị ảnh hưởng.

Sau khi xóa cấu hình QR, các chức năng yêu cầu bot tạo hoặc gửi QR thanh toán sẽ không hoạt động cho đến khi QR được thiết lập lại.

Luồng xử lý kỹ thuật

Xác thực quyền quản trị: Bot kiểm tra người sử dụng có quyền Administrator trước khi cho phép xem, cập nhật hoặc xóa cấu hình.
Xác thực quyền trong kênh: Khi chạy set-channel, bot kiểm tra các quyền cần thiết như View Channel, Send Messages, Embed Links và Attach Files.
Kiểm tra dữ liệu QR: Khi chạy set-qr, hệ thống kiểm tra các trường bắt buộc, định dạng dữ liệu và khả năng xử lý ảnh nền.
Lưu trữ ảnh nền: Ảnh được cung cấp qua tệp đính kèm hoặc URL sẽ được tải và lưu lại trên hệ thống thay vì phụ thuộc lâu dài vào URL nguồn.
Kiểm tra trạng thái: Lệnh view kiểm tra cả dữ liệu đã lưu và trạng thái hoạt động thực tế của kênh, quyền bot và tài nguyên QR.
Độc lập cấu hình: Cấu hình thanh toán được lưu trong phân mục dữ liệu riêng và không bị ảnh hưởng khi reset cấu hình server chung bằng /settings server.

Thiết lập đề xuất

/payment-config set-channel channel:#payment-logs

/payment-config set-qr bank-name:MBBank account-number:024122021 account-name:"DO VAN TUAN TU" description:"THANH TOAN DICH VU" trigger-message:qr qr-offset-y:20 qr-rotation:0 qr-size:46 remove-qr-background:false

Sau đó kiểm tra bằng:

/payment-config view

Quản trị viên nên thử quét QR bằng ít nhất một ứng dụng ngân hàng trước khi sử dụng chính thức.

Tính năng theo yêu cầu

Tính năng theo yêu cầuTính năng này chỉ khả dụng trên một số bot, được làm riêng theo yêu cầu.

/payment-config chỉ đăng ký trên bot thuộc danh sách trả phí. Kết nối cổng thanh toán tự động vẫn cần Motional Hub cài đặt.

On this page