Tab Payment Method

Chọn phương thức thanh toán cho POS - drag-drop reorder, deep-link sang setting payment khi cần config.

Tab paymentmethod của /setting-sale/general.

POS Settings > Phương thức thanh toán. URL: /setting-sale/general/tab/paymentmethod.

Component: features/setting/sale/SettingSalePaymentMethod.tsx.

Section "Phương thức thanh toán"

Field hidden: pos_allow_payment_method_list - CSV id Order.PAYMENT_METHOD_*.

UI:

<Select> chọn thêm method (showSearch, autoClearSearchValue, filter theo label).
List drag-drop method đã chọn (giống POS Suggestion).
Mỗi row có:
- <IconPaymentMethod method={id} size={24}> - icon theo phương thức.
- Tên method (label).
- Icon Settings (chỉ hiện cho method online cần config) → click navigate /setting/website/tab/payment.
- Icon X (Popconfirm xác nhận xoá).

Logic `isPaymentMethodAllowed`

Phương thức bị disable (không show trong dropdown chọn):

disabledPosPaymentMethods = [
  PAYMENT_METHOD_GIFTCARD,
  PAYMENT_METHOD_CUSTOMER_POINT,
  PAYMENT_METHOD_MEMBERCARD,
  PAYMENT_METHOD_MOMO,
  PAYMENT_METHOD_SEPAY_GATEWAY,
]

Phương thức gate theo CompanyFeature:

Phương thức	Feature gate
`PAYMENT_METHOD_CARD`	`ACCOUNTING_PAYMENT_BANK_CARD`
`PAYMENT_METHOD_GIFTCARD`	`ACCOUNTING_PAYMENT_GIFT_CARD`
`PAYMENT_METHOD_CUSTOMER_POINT`	`ACCOUNTING_PAYMENT_LOYALTY`
`PAYMENT_METHOD_MEMBERCARD`	`ACCOUNTING_PAYMENT_MEMBERCARD`
`PAYMENT_METHOD_MOMO`	`INTEGRATION_MOMO`
`PAYMENT_METHOD_VNPAY`, `VNPAY_QR`, `VNPAY_SMARTPOS`	`INTEGRATION_VNPAY`
`PAYMENT_METHOD_SEPAY`, `SEPAY_GATEWAY`	`INTEGRATION_SEPAY`
`PAYMENT_METHOD_ZALOPAY`	`INTEGRATION_ZALOPAY`
Các method khác	luôn allowed

Logic `requiresSettings` (icon Settings)

needSettingMethodList = [
  COD, MOMO, VNPAY, VNPAY_QR, VNPAY_SMARTPOS,
  SEPAY, ZALOPAY, ONLINE_BANKING, PAY_LATER,
]

Click icon Settings → navigate("/setting/website/tab/payment") để cấu hình credentials (merchant ID, API key, ...).

Khi nào dùng

Bật/tắt phương thức cho POS theo gói.
Sắp xếp thứ tự phương thức trên POS UI.
Đi nhanh sang config online payment provider.

Các lối đi từ trang

/setting/website/tab/payment - cấu hình credentials provider.
Tab Order Source, Kiosk... cùng /setting-sale/general.

Lưu ý - Lỗi thường gặp

Phương thức không có trong danh sách: gói chưa bật tích hợp tương ứng, hoặc phương thức đó đang bị tắt trong cấu hình kỹ thuật—cần nhờ IT hoặc triển khai kiểm tra.
Bấm Cài đặt nhảy sang trang khác: đúng thiết kế—nhập mã kết nối gateway thường nằm tại Cấu hình website > tab thanh toán (/setting/website/tab/payment).
Một cổng chạy được, cổng khác không: có thể cổng đó đang nằm trong danh sách không dùng trên POS dù gói đã bật—cần đối chiếu với đội kỹ thuật.
Tiền mặt không có nút Cài đặt: đúng—tiền mặt không cần cấu hình kết nối.

Ai được xem và chỉnh?

Mở tab và Lưu: người có quyền Cài đặt công ty / quản trị cài đặt.