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ị

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 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.
Chỉ Console Chỉ dùng trên console chơi game.
Cả hai Dùng trên mọi loại thiết bị. Đây là mặc định.

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.
  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.
  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.

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".