HandyCafe Docs
owner cashier

Dompet Anggota

Dompet anggota adalah sistem saldo moneter yang memungkinkan anggota membayar di muka untuk layanan kafe. Alih-alih membayar tunai untuk setiap sesi individual, anggota dapat memuat dana ke dompet mereka dan sistem mengurangi dari saldo tersebut secara otomatis saat mereka menggunakan PC, konsol, atau memesan produk.

Arsitektur Berbasis Kredit

Dompet menggunakan sistem kredit alih-alih saldo berjalan tunggal. Setiap kali dana ditambahkan ke dompet anggota, sistem membuat kredit dompet baru. Setiap entri kredit adalah catatan individual dengan saldo, sumber, kedaluwarsa, dan pembatasan perangkatnya sendiri. Desain ini menyediakan:

  • Keterlacakan penuh dari mana setiap unit saldo berasal.
  • Tanggal kedaluwarsa independen per entri kredit.
  • Pembatasan spesifik perangkat (beberapa kredit mungkin hanya dapat digunakan di PC, yang lain hanya di konsol).
  • Pemisahan yang jelas antara dana yang dibayar dan bonus promosi.

Saldo dompet total anggota adalah jumlah semua nilai tersisa di seluruh entri kredit aktif mereka.

Tipe Kredit

Setiap kredit dompet memiliki tipe kredit yang mengidentifikasi bagaimana dana masuk ke sistem:

Tipe Kredit Deskripsi
Dibayar Anggota membayar untuk dana ini (tunai, kartu, atau metode pembayaran lainnya). Dibuat saat membeli paket kampanye berbasis uang.
Bonus Dana promosi yang diberikan sebagai bagian dari pembelian paket. Misalnya, "bayar 100 menit, dapatkan kredit senilai 20 menit bonus."
Manual Dimuat secara manual oleh kasir atau admin. Digunakan untuk kredit niat baik atau pengaturan khusus.
Koreksi Penyesuaian administratif untuk memperbaiki kesalahan dalam saldo anggota.
Migrasi Dana yang diimpor dari sistem lama selama migrasi data.
Pengembalian terbalik Dana yang dipulihkan saat pengembalian yang sebelumnya diterbitkan dibatalkan.

Tipe kredit diatur saat kredit dibuat dan tidak dapat diubah setelahnya. Ini berfungsi sebagai jejak audit permanen.

Status Kredit

Setiap kredit dompet melalui siklus hidup yang dilacak oleh statusnya:

  • Aktif: Kredit memiliki dana tersisa dan belum kedaluwarsa. Dana dapat dikonsumsi dari kredit ini.
  • Kedaluwarsa: Tanggal kedaluwarsa kredit telah lewat. Dana yang tersisa tidak lagi dapat digunakan.
  • Habis: Saldo kredit yang tersisa telah mencapai nol melalui konsumsi normal.
  • Dibatalkan: Kredit dibatalkan secara manual oleh administrator, membatalkan saldo tersisa.

Konsumsi Dompet

Saat dompet anggota dibebankan (untuk waktu sesi, pesanan, atau event yang dapat ditagih lainnya), sistem membuat catatan konsumsi dompet yang menautkan ke entri kredit tertentu dan mencatat berapa banyak yang dikurangi.

Setiap catatan konsumsi menyertakan konteks yang mengidentifikasi apa yang memicu pengurangan:

Konteks Deskripsi
Penggunaan sesi Dana dikonsumsi untuk membayar waktu penggunaan sesi. Sistem mengurangi dari dompet saat sesi berjalan.
Pembayaran dompet Pembayaran langsung dari dompet (misalnya saat anggota membayar pesanan produk menggunakan saldo dompet).
Pesanan Dana dikonsumsi untuk membayar pesanan produk di konter kafe atau dikirim ke PC anggota.
Pengembalian Penyesuaian negatif yang dibuat saat pengembalian diproses, mengurangi konsumsi untuk mengembalikan dana ke entri kredit.

Setiap catatan konsumsi menautkan kembali ke sesi, pesanan, atau transaksi spesifik yang menyebabkannya, memungkinkan pelacakan audit penuh.

Log Saldo

Selain catatan konsumsi tingkat kredit, sistem memelihara log saldo anggota yang mencatat setiap event yang mengubah saldo dompet keseluruhan anggota:

Tipe Event Deskripsi
load Dana ditambahkan ke dompet (entri kredit baru dibuat atau yang sudah ada diisi ulang).
spend Dana dikonsumsi dari dompet (pembayaran sesi, pembayaran pesanan).
refund Dana dikembalikan ke dompet (pengembalian pesanan, pengembalian sesi).
adjustment Perubahan administratif dibuat pada saldo (koreksi, penghapusan).

Setiap entri log saldo mencatat jumlah perubahan dan saldo yang dihasilkan, sehingga Anda dapat merekonstruksi saldo anggota pada titik waktu mana pun dengan membaca log secara kronologis.

Pembatasan Perangkat

Setiap kredit dompet memiliki pembatasan perangkat yang mengontrol tipe perangkat mana yang dapat mengonsumsi darinya:

Pembatasan Arti
Klien Dapat digunakan di PC klien. Juga dapat digunakan di konsol kecuali kredit secara eksplisit dibatasi.
Konsol Dapat digunakan di konsol gaming. Juga dapat digunakan di PC kecuali secara eksplisit dibatasi.
Hanya PC Hanya dapat digunakan di PC klien. Tidak dapat dikonsumsi oleh sesi konsol.
Hanya konsol Hanya dapat digunakan di konsol gaming. Tidak dapat dikonsumsi oleh sesi PC.
Keduanya Dapat digunakan di tipe perangkat apa pun tanpa pembatasan. Ini adalah default.

Saat sistem perlu mengurangi dari dompet anggota, sistem memfilter kredit yang tersedia berdasarkan pembatasan perangkat untuk memastikan hanya kredit yang memenuhi syarat yang dibebankan.

Kategori Dompet dan Pengeluaran Lintas Kategori

Kredit dompet dapat ditandai dengan kategori dompet (misalnya "gaming" atau "umum"). Ini memungkinkan kafe membuat pool saldo terisolasi yang hanya dapat dibelanjakan dalam konteks tertentu.

Opsi pengeluaran lintas kategori pada setiap kredit mengontrol apakah dananya dapat digunakan di luar kategori yang ditentukan:

  • Saat dinonaktifkan (default), kredit hanya dapat dikonsumsi dalam kategorinya sendiri.
  • Saat diaktifkan, kredit juga dapat dikonsumsi oleh transaksi dalam kategori lain.

Jika kredit tidak memiliki kategori dompet yang ditetapkan, kredit tersebut diperlakukan sebagai kredit tujuan umum dan dapat dikonsumsi oleh transaksi apa pun terlepas dari kategori.

Cara Kerja Pengisian

Dana dompet dapat ditambahkan melalui beberapa metode:

  1. Pembelian paket kampanye: Saat anggota membeli paket berbasis uang dari kampanye, sistem secara otomatis membuat kredit dompet berdasarkan definisi paket. Satu pembelian paket dapat membuat beberapa kredit (satu untuk porsi dibayar, satu untuk porsi bonus).

  2. Pengisian manual: Kasir dapat secara manual menambahkan dana ke dompet anggota dari panel detail anggota. Ini membuat entri kredit dengan tipe kredit "Manual".

  3. Migrasi: Selama pengaturan sistem, saldo yang ada dari sistem sebelumnya dapat diimpor sebagai entri kredit dengan tipe kredit "Migrasi".

Cara Dompet Dikonsumsi Selama Sesi

Saat anggota dengan saldo dompet memulai sesi, sistem dapat secara otomatis membayar sesi dari dompet:

  1. Mesin harga sesi menghitung biaya per menit berdasarkan slot harga aktif dan diskon tingkat yang berlaku.
  2. Saat sesi berjalan, sistem secara berkala mengurangi biaya yang terakumulasi dari kredit dompet anggota yang memenuhi syarat.
  3. Kredit dikonsumsi dalam urutan tanggal kedaluwarsa (kredit yang paling cepat kedaluwarsa digunakan terlebih dahulu) untuk meminimalkan pemborosan dari kedaluwarsa.
  4. Jika saldo dompet habis sebelum sesi berakhir, biaya yang tersisa dibebankan sebagai pembayaran tunai saat penutupan sesi.
  5. Setiap pengurangan membuat catatan konsumsi yang ditautkan ke sesi sebagai entri "Penggunaan sesi".