📱 Thanh toán VietQR trên đơn bán
Tính năng Thanh toán VietQR giúp Xbook tự sinh mã QR VietQR ngay trên đơn bán hàng đã xác nhận, để khách hàng quét và chuyển khoản ngân hàng nhanh đúng số tiền, đúng nội dung của đơn. Mã QR được tạo từ tài khoản ngân hàng nhận tiền của công ty và gắn liền với từng đơn (số tiền và nội dung chuyển khoản).
📷 Cần chèn ảnh:
/img/modules/sale/vietqr/01.png— Mã QR VietQR hiển thị ở góc trên đơn bán hàng đã xác nhận.
Cách hoạt động
Mã QR được sinh tự động theo trạng thái của đơn, bạn không cần thao tác thủ công:
- Khi đơn bán được xác nhận (chuyển sang trạng thái Đơn bán hàng — sale), hệ thống sinh mã QR VietQR cho đơn đó.
- Khi tổng tiền của đơn thay đổi (thêm/sửa/xóa dòng sản phẩm), mã QR được làm mới lại theo số tiền mới.
- Khi đơn bị hủy, mã QR và nội dung chuyển khoản sẽ được xóa khỏi đơn.
Mỗi mã QR đã chứa sẵn số tiền (bằng tổng tiền đơn — amount_total) và nội dung chuyển khoản, nên khi khách quét sẽ tự điền đúng thông tin chuyển khoản.
💡 Mã QR có thể có thời hạn hiệu lực (theo cấu hình QR Expiry). Khi mã hết hạn, hệ thống sẽ tự sinh lại mã mới ở lần thao tác/in kế tiếp.
Thông tin VietQR trên đơn
Trên biểu mẫu đơn bán hàng, ngoài hình ảnh mã QR ở góc trên, hệ thống còn ghi nhận các trường liên quan:
| Trường | Ý nghĩa |
|---|---|
| Mã QR (VietQR Image) | Hình ảnh mã QR VietQR sinh cho đơn, hiển thị ở góc trên biểu mẫu đơn (chỉ đọc). |
| Nội dung chuyển khoản (VietQR Transfer Content) | Nội dung khách ghi khi chuyển khoản. Tự tạo từ thông tin đơn/khách hàng, có thể chỉnh sửa thủ công. |
| QR hết hạn lúc (VietQR Expires At) | Thời điểm mã QR hết hiệu lực (chỉ đọc); để trống nếu mã không hết hạn. |
⚠️ Nếu bạn sửa Nội dung chuyển khoản (VietQR Transfer Content) trên đơn, hệ thống sẽ sinh lại mã QR theo nội dung mới.
📷 Cần chèn ảnh:
/img/modules/sale/vietqr/02.png— Trường Nội dung chuyển khoản và QR hết hạn lúc trên đơn bán.
Cấu hình tài khoản ngân hàng / VietQR
Để mã QR sinh đúng tài khoản nhận tiền, cần khai báo nhà cung cấp thanh toán VietQR một lần. Mã QR chỉ được sinh khi tồn tại nhà cung cấp VietQR ở trạng thái Đã bật (enabled) hoặc Thử nghiệm (test).
- Mở trang cấu hình nhà cung cấp thanh toán và chọn nhà cung cấp VietQR.
- Mở thẻ VietQR Configuration trên biểu mẫu nhà cung cấp.
- Khai báo thông tin theo các nhóm bên dưới rồi lưu lại.
Thông tin xác thực API (API Credentials)
| Trường | Ý nghĩa |
|---|---|
| VietQR Client ID | Client ID do VietQR / ngân hàng đối tác cấp. |
| VietQR API Key | Khóa API để xác thực khi gọi dịch vụ VietQR. |
Tài khoản ngân hàng (Bank Account)
| Trường | Ý nghĩa |
|---|---|
| Bank | Chọn ngân hàng từ danh sách VietQR. Nhấn Sync để tải danh sách ngân hàng mới nhất. |
| Bank BIN | Mã BIN của ngân hàng (tự lấy theo ngân hàng đã chọn, chỉ đọc). |
| Account Number | Số tài khoản ngân hàng nhận tiền. |
| Account Holder Name | Tên chủ tài khoản. Hệ thống tự chuyển sang chữ in hoa, bỏ dấu. |
💡 Lần đầu cấu hình, hãy nhấn nút Sync cạnh ô Bank để hệ thống tải về danh sách ngân hàng hỗ trợ VietQR.
Thiết lập mã QR (QR Settings)
| Trường | Ý nghĩa |
|---|---|
| QR Template | Mẫu hiển thị của ảnh QR do dịch vụ trả về (Compact, Compact 2, QR Only, Print). |
| QR Expiry (minutes) | Số phút trước khi mã QR hết hạn. Đặt 0 nếu muốn mã không hết hạn. |
| Transfer Content Source | Cách tạo nội dung chuyển khoản: theo Tên khách hàng + nội dung thêm hoặc nội dung cố định. |
| Extra Transfer Content | Nội dung thêm vào sau tên khách hàng (khi chọn Tên khách hàng + nội dung thêm). |
| Fixed Transfer Content | Nội dung chuyển khoản cố định (khi chọn nội dung cố định). |
⚠️ VietQR chỉ hỗ trợ giao dịch bằng đồng Việt Nam (VND). Với các loại tiền tệ khác, hệ thống sẽ không áp dụng VietQR.
📷 Cần chèn ảnh:
/img/modules/sale/vietqr/03.png— Thẻ VietQR Configuration với nhóm Bank Account và QR Settings.
Nơi mã QR hiển thị
- Trên đơn bán hàng: mã QR hiện ở góc trên biểu mẫu đơn ngay sau khi đơn được xác nhận (chỉ hiện khi đã có mã QR).
- Trên bản in báo giá / đơn bán: mã QR được đưa vào dữ liệu in, để khách hàng có thể quét trực tiếp trên bản in đơn/báo giá và chuyển khoản.
💡 Khách hàng dùng ứng dụng ngân hàng quét mã QR; số tiền và nội dung chuyển khoản đã được điền sẵn theo đơn, giúp đối soát công nợ nhanh và chính xác.
Liên quan
- Đơn bán hàng — căn cứ xuất kho, giao hàng và xuất hóa đơn; nơi mã VietQR được sinh.
- Tạo hóa đơn — lập hóa đơn và ghi nhận thanh toán sau khi khách chuyển khoản.