HandyCafe Docs
owner cashier

Ví Hội viên

Ví hội viên là hệ thống số dư tiền tệ cho phép hội viên trả trước dịch vụ quán. Thay vì trả tiền mặt cho mỗi phiên riêng lẻ, hội viên có thể nạp tiền vào ví và hệ thống tự động trừ khi họ sử dụng PC, console hoặc đặt hàng sản phẩm.

Kiến trúc Dựa trên Tín dụng

Ví sử dụng hệ thống tín dụng thay vì một số dư chạy đơn. Mỗi khi tiền được thêm vào ví hội viên, hệ thống tạo tín dụng ví mới. Mỗi mục tín dụng là bản ghi riêng với số dư, nguồn gốc, hạn sử dụng và giới hạn thiết bị riêng. Thiết kế này cung cấp:

  • Truy vết đầy đủ nguồn gốc mỗi đơn vị số dư.
  • Ngày hết hạn độc lập cho mỗi mục tín dụng.
  • Giới hạn thiết bị cụ thể (một số tín dụng chỉ dùng trên PC, số khác chỉ trên console).
  • Phân tách rõ ràng giữa tiền đã thanh toán và thưởng khuyến mãi.

Tổng số dư ví hội viên là tổng giá trị còn lại trên tất cả mục tín dụng hoạt động.

Loại Tín dụng

Loại Mô tả
Đã thanh toán Hội viên đã trả cho số tiền này (tiền mặt, thẻ hoặc phương thức khác). Tạo khi mua gói tiền.
Thưởng Tiền khuyến mãi cấp kèm mua gói.
Thủ công Nạp thủ công bởi thu ngân hoặc quản trị viên.
Điều chỉnh Điều chỉnh quản trị để sửa lỗi trong số dư.
Di cư Tiền nhập từ hệ thống cũ khi chuyển đổi dữ liệu.
Hoàn tiền đảo ngược Tiền khôi phục khi hoàn tiền trước đó bị đảo ngược.

Trạng thái Tín dụng

  • Hoạt động: Tín dụng còn tiền và chưa hết hạn. Tiền có thể được tiêu thụ.
  • Hết hạn: Ngày hết hạn đã qua. Tiền còn lại không thể sử dụng.
  • Đã tiêu thụ: Số dư còn lại đã về không qua tiêu thụ bình thường.
  • Đã hủy: Tín dụng bị hủy thủ công bởi quản trị viên.

Tiêu thụ Ví

Khi ví hội viên bị tính phí, hệ thống tạo bản ghi tiêu thụ ví liên kết đến mục tín dụng cụ thể và ghi nhận chính xác số tiền đã trừ.

Ngữ cảnh Mô tả
Sử dụng phiên Tiền tiêu thụ để trả cho thời gian sử dụng phiên.
Thanh toán ví Thanh toán trực tiếp từ ví (ví dụ: khi hội viên trả đơn hàng bằng số dư ví).
Đơn hàng Tiền tiêu thụ để trả đơn hàng sản phẩm.
Hoàn tiền Điều chỉnh âm khi xử lý hoàn tiền, trả lại tiền cho mục tín dụng.

Nhật ký Số dư

Hệ thống duy trì nhật ký số dư hội viên ghi nhận mọi sự kiện thay đổi tổng số dư ví:

Loại Sự kiện Mô tả
load Tiền được thêm vào ví (mục tín dụng mới hoặc nạp thêm).
spend Tiền được tiêu thụ từ ví (thanh toán phiên, thanh toán đơn hàng).
refund Tiền được trả lại ví (hoàn tiền đơn hàng, hoàn tiền phiên).
adjustment Thay đổi quản trị đối với số dư (điều chỉnh, xóa sổ).

Giới hạn Thiết bị

Mỗi tín dụng ví có một giới hạn thiết bị kiểm soát loại thiết bị nào có thể tiêu thụ từ nó:

Giới hạn Ý nghĩa
Máy khách Dùng trên PC khách. Cũng dùng trên console trừ khi tín dụng bị giới hạn rõ ràng.
Console Dùng trên console chơi game. Cũng dùng trên PC trừ khi bị giới hạn rõ ràng.
Chỉ PC Chỉ dùng trên PC khách. Phiên console không thể tiêu thụ.
Chỉ Console Chỉ dùng trên console chơi game. Phiên PC không thể tiêu thụ.
Cả hai Dùng trên mọi loại thiết bị không giới hạn. Đây là mặc định.

Khi hệ thống cần trừ tiền từ ví của hội viên, nó lọc các tín dụng khả dụng theo giới hạn thiết bị để chỉ tính vào những tín dụng đủ điều kiện.

Danh mục Ví và Chi tiêu Chéo Danh mục

Tín dụng ví có thể được gắn một danh mục ví (ví dụ "gaming" hoặc "chung"). Điều này cho phép quán tạo các nguồn số dư tách biệt chỉ tiêu được trong một số bối cảnh nhất định.

Tùy chọn chi tiêu chéo danh mục trên mỗi tín dụng quyết định tiền của nó có được dùng ngoài danh mục đã chỉ định hay không:

  • Khi tắt (mặc định), tín dụng chỉ được tiêu thụ trong danh mục của chính nó.
  • Khi bật, tín dụng cũng có thể được tiêu thụ bởi các giao dịch thuộc danh mục khác.

Nếu một tín dụng không được gán danh mục ví nào, nó được coi là tín dụng dùng chung và có thể được tiêu thụ bởi mọi giao dịch, bất kể danh mục.

Cách Nạp Ví

Tiền ví có thể được thêm qua nhiều phương thức:

  1. Mua gói chương trình: Khi hội viên mua gói tiền từ chương trình, hệ thống tự động tạo tín dụng ví dựa trên định nghĩa gói. Một lần mua gói có thể tạo nhiều tín dụng (một cho phần đã trả tiền, một cho phần thưởng).
  2. Nạp thủ công: Thu ngân có thể thêm tiền thủ công vào ví hội viên từ bảng chi tiết hội viên. Việc này tạo một mục tín dụng với loại "Thủ công".
  3. Di cư: Trong thiết lập hệ thống, số dư hiện có từ hệ thống trước có thể được nhập dạng mục tín dụng với loại "Di cư".

Cách Ví Được Tiêu thụ Trong Phiên

Khi hội viên có số dư ví bắt đầu phiên, hệ thống có thể tự động thanh toán từ ví:

  1. Bộ tính giá tính chi phí mỗi phút dựa trên ô giá đang hoạt động và giảm giá cấp bậc áp dụng.
  2. Khi phiên chạy, hệ thống định kỳ trừ chi phí tích lũy từ tín dụng ví đủ điều kiện.
  3. Tín dụng được tiêu thụ theo thứ tự hết hạn (sớm nhất trước) để giảm lãng phí.
  4. Nếu số dư ví cạn trước khi phiên kết thúc, chi phí còn lại được tính là thanh toán tiền mặt khi đóng phiên.
  5. Mỗi lần trừ tạo bản ghi tiêu thụ liên kết với phiên dạng "Sử dụng phiên".

Cách Ví Được Tiêu thụ Cho Đơn hàng

Khi hội viên đặt sản phẩm từ PC khách của mình, ví không bị đụng tới vào lúc đơn hàng được tạo. Đơn hàng được tạo ở trạng thái Đang mở và chờ thu ngân. Số dư đã trả tiền chỉ bị trừ khi thu ngân xác nhận việc bàn giao bằng thao tác Đánh dấu Đã Giao:

  1. Việc đặt hàng không bao giờ làm giảm số dư của hội viên. Đơn bị từ chối hoặc bị hủy không đụng tới ví.
  2. Khi thu ngân đánh dấu đơn là đã giao, hệ thống trừ tổng tiền đơn hàng từ các tín dụng ví đã trả tiền của hội viên. Tín dụng thưởng và khuyến mãi không bị đụng tới. Phần tiền đó vẫn được giữ lại cho việc dùng phiên và dùng thời gian.
  3. Tín dụng đã trả tiền được tiêu thụ theo thứ tự hết hạn (sớm nhất trước), giống như khi dùng phiên.
  4. Việc trừ tiền là cố gắng tối đa. Nếu số dư đã trả tiền của hội viên không đủ cho toàn bộ đơn hàng, hệ thống lấy phần đang có và phần còn lại nằm trên hóa đơn đang mở để thu ngân thu khi đóng phiên.
  5. Việc trừ tiền chỉ được ghi một lần cho mỗi đơn hàng. Nhấn Đánh dấu Đã Giao lần nữa hoặc bỏ dấu rồi đánh dấu lại đều không bao giờ trừ ví hai lần.
  6. Mỗi lần trừ tạo một bản ghi tiêu thụ liên kết với đơn hàng, nên khoản chi này xuất hiện trong nhật ký số dư của hội viên và trong các báo cáo.