Tuỳ biến (Customization)Cài đặt bán hàng (Setting Sale)
Tab Kiosk
Cấu hình self-service kiosk - Welcome URL / Idle URL + payment methods riêng cho kiosk (chỉ VNPAY_QR / VNPAY_SMARTPOS / SEPAY).
Tab kiosk của /setting-sale/general.
Vị trí menu admin
POS Settings > Kiosk. URL: /setting-sale/general/tab/kiosk.
Component: features/setting/sale/SettingSaleKiosk.tsx.
Section "Hiển thị Kiosk" (kiosk_section_display)
| Field | Loại | Ghi chú |
|---|---|---|
kiosk_welcome_url | <Input.TextArea rows={2} allowClear> | URL màn hình chào (kiosk hiện trước khi user touch). Tooltip _help. Placeholder _placeholder. |
kiosk_idle_url | <Input.TextArea rows={2} allowClear> | URL màn hình idle khi kiosk không có hoạt động một lúc. |
Section "Phương thức thanh toán Kiosk" (sale_section_kiosk_payment_method)
Field hidden: kiosk_allow_payment_method_list - CSV id.
Whitelist KIOSK_ALLOWED_METHODS - hardcode chỉ 3 method được phép cho kiosk:
[PAYMENT_METHOD_VNPAY_QR, PAYMENT_METHOD_VNPAY_SMARTPOS, PAYMENT_METHOD_SEPAY]Lý do: kiosk self-service không có thu ngân, chỉ cho phương thức không-cần-cash-handling.
Mỗi method còn gate CompanyFeature:
| Method | Feature |
|---|---|
VNPAY_QR, VNPAY_SMARTPOS | INTEGRATION_VNPAY |
SEPAY | INTEGRATION_SEPAY |
UI giống tab Payment Method (drag-drop, X, Settings deep-link /setting/website/tab/payment). Confirm delete dùng key i18n riêng kiosk_payment_method_confirm_delete.
Khi nào dùng
- Triển khai kiosk self-service tại quầy/cửa hàng.
- Cấu hình màn hình chào (logo, video, banner).
- Cấu hình màn hình idle (sau X giây không touch).
Các lối đi từ trang
/setting/website/tab/payment- config credentials VNPAY/SEPAY.- Tab khác trong cùng
/setting-sale/general.
Lưu ý - Lỗi thường gặp
- Method không hiện trong dropdown: do whitelist chỉ cho 3 method + thiếu feature integration.
- Welcome URL không hiển thị: kiosk app phải implement load URL này. Test bằng cách paste URL trên browser.
- Kiosk không idle về URL: timeout idle có thể là setting riêng của kiosk app, không phải Setting Sale.
- Cần thêm CASH cho kiosk: hiện không cho phép. Phải sửa code
KIOSK_ALLOWED_METHODS.
Ai được xem và chỉnh?
- Người có quyền Cài đặt công ty / quản trị cài đặt mới mở và chỉnh được.
- Save: cùng role.