HandyCafe Docs
owner cashier

Member Wallet

Ang member wallet ay isang monetary balance system na nagbibigay-daan sa mga miyembro na mag-prepay para sa cafe services. Sa halip na nagbabayad ng cash para sa bawat indibidwal na session, maaaring mag-load ng funds ang member sa kanilang wallet at mag-ibabaw ng system mula sa balanse na iyon habang gumagamit sila ng PCs, consoles, o nag-o-order ng mga produkto.

Credit-Based Architecture

Gumagamit ang wallet ng credit system sa halip na iisang running balance. Tuwing nagdadagdag ng funds sa wallet ng member, lumilikha ang system ng bagong wallet credit. Ang bawat credit entry ay isang independent na record na may sariling balance, source, expiration, at device restriction.

Ang kabuuang wallet balance ng member ay ang kabuuan ng lahat ng natitirang values sa kanilang mga aktibong credit entries.

Mga Credit Types

Credit Type Paglalarawan
Paid Nagbayad ang member para sa funds na ito (cash, card, o ibang payment method).
Bonus Promotional funds na ibinigay bilang bahagi ng package purchase.
Manual Manu-manong nilo-load ng cashier o admin.
Pagwawasto Isang administrative adjustment para ayusin ang error sa balanse ng member.
Migration Funds na ini-import mula sa legacy system sa panahon ng data migration.
Reversed refund Funds na na-restore kapag na-reverse ang dating inisyu na refund.

Credit Status

  • Active: May natitirang pondo ang credit at hindi pa nag-expire.
  • Expired: Lumipas na ang expiration date ng credit.
  • Consumed: Naabot na ng natitirang balance ang zero.
  • Cancelled: Manu-manong kinansela ng administrator.

Wallet Consumption

Kapag sinisingil ang wallet ng member, lumilikha ang system ng wallet consumption record:

Context Paglalarawan
Paggamit ng session Funds na nagamit para magbayad ng session usage time.
Wallet payment Direktang bayad mula sa wallet.
Order Funds na nagamit para magbayad ng product order.
Refund Negatibong adjustment kapag naproseso ang refund.

Balance Log

Nagpapanatili ng system ng member balance log na nagrererecord ng bawat event na nagbabago sa pangkalahatang wallet balance ng member:

Event Type Paglalarawan
load Naidagdag ang funds sa wallet.
spend Nagamit ang funds mula sa wallet.
refund Naibalik ang funds sa wallet.
adjustment Ginawang administrative change sa balanse.

Device Restriction

Ang bawat wallet credit ay may device restriction na kumokontrol kung aling uri ng devices ang maaaring gumamit nito:

Restriction Kahulugan
Client Magagamit sa client PCs.
Console Magagamit sa gaming consoles.
PCs only Eksklusibong magagamit sa client PCs lamang.
Consoles only Eksklusibong magagamit sa gaming consoles lamang.
Both Magagamit sa anumang uri ng device. Ito ang default.

Paano Gumagana ang Top-Ups

Maaaring idagdag ang wallet funds sa pamamagitan ng ilang paraan:

  1. Campaign package purchase: Kapag bumili ang member ng money-based package mula sa campaign, awtomatikong gumagawa ng wallet credits ang system.
  2. Manual load: Maaaring manu-manong magdagdag ng funds ang cashier sa wallet ng member.
  3. Migration: Sa panahon ng system setup, maaaring i-import ang mga umiiral na balances mula sa dating system.

Paano Ginagamit ang Wallet sa mga Session

Kapag may wallet balance ang member na nag-start ng session:

  1. Kinakalkula ng pricing engine ang gastos kada minuto.
  2. Habang tumatakbo ang session, pana-panahong ibinabawas ng system ang naipon na gastos mula sa mga eligible wallet credits ng member.
  3. Ang mga credits ay ginagamit sa pagkakasunud-sunod ng expiration date (pinakamalapit muna ang expiration).
  4. Kung maubos ang wallet balance bago matapos ang session, ang natitirang gastos ay sinisingil bilang cash payment sa session close.