Token & Manajemen Kuota Fitur
Informasi saldo token tenant, riwayat pemakaian kuota fitur premium, dan prosedur pembelian atau upgrade via sistem invoice.
Gambaran Umum
Temuya POS dirancang untuk menjadi platform yang sangat skalabel, mampu melayani warung kopi kecil di sudut jalan hingga waralaba ritel nasional dengan ratusan cabang. Untuk mengakomodasi keberagaman skala bisnis ini tanpa membebani usaha kecil dengan biaya yang tidak masuk akal, kami mengadopsi model ekonomi berbasis konsumsi, yang berpusat pada konsep “Token”. Token dan Manajemen Kuota Fitur adalah jantung dari sistem penagihan (billing) kami, memastikan bahwa setiap tenant hanya membayar nilai untuk apa yang benar-benar mereka gunakan secara proporsional.
Token bertindak layaknya mata uang digital internal di dalam ekosistem Temuya. Saat seorang pelanggan (tenant) mendaftar dan berlangganan sebuah paket tertentu (misalnya Paket Dasar atau Paket Pro), mereka secara otomatis diberikan alokasi Token setiap bulannya sebagai bagian dari langganan tersebut. Token ini kemudian secara perlahan dikonsumsi saat tenant menggunakan fitur-fitur yang membutuhkan komputasi berat, penyimpanan skala besar, atau layanan pihak ketiga yang berbayar (seperti pengiriman pesan notifikasi WhatsApp atau sinkronisasi ekstensif dengan e-commerce).
Halaman Manajemen Token di dalam aplikasi menyajikan transparansi penuh kepada pemilik bisnis. Di sana, mereka dapat memantau dengan presisi sisa saldo token aktif, memeriksa catatan rinci seperti buku tabungan yang memperlihatkan kapan dan untuk apa setiap keping token tersebut dihabiskan, serta memprediksi kapan mereka perlu melakukan pengisian ulang (top-up). Dengan sistem ini, pengembang dan pemilik bisnis dapat merencanakan anggaran operasional IT mereka dengan akurasi yang lebih baik, menghindari kejutan tagihan di akhir bulan yang sering terjadi pada model penetapan harga tradisional.
Skenario Bisnis Nyata
Kisah “Boutique Larasati” memberikan contoh sempurna tentang bagaimana sistem Token ini bekerja dalam praktik. Boutique Larasati adalah toko pakaian kelas menengah yang biasanya mencatatkan sekitar 50 transaksi per hari. Mereka menggunakan Paket Dasar Temuya POS, yang memberikan mereka jatah 5.000 Token per bulan, yang mana sangat lebih dari cukup untuk operasional rutin mereka.
Namun, mendekati bulan Ramadan, Boutique Larasati mengadakan acara cuci gudang besar-besaran (Mega Sale) selama dua minggu penuh. Mereka tidak hanya melipatgandakan jumlah kasir yang bertugas, tetapi juga mengaktifkan fitur premium Temuya POS: Notifikasi WhatsApp Otomatis yang mengirimkan e-struk langsung ke nomor ponsel pelanggan untuk menghemat kertas. Fitur premium notifikasi WhatsApp ini mengkonsumsi 5 Token untuk setiap pesan yang berhasil terkirim.
Pada hari ketiga cuci gudang, lonjakan pelanggan yang luar biasa membuat volume transaksi harian mereka meroket hingga 500 transaksi. Sistem notifikasi WhatsApp bekerja keras, dan konsumsi Token meningkat tajam. Melalui dasbor Manajemen Token, pemilik butik, Ibu Laras, melihat bahwa saldo token mereka menyusut jauh lebih cepat dari biasanya dan diperkirakan akan habis sebelum minggu pertama Mega Sale berakhir.
Tanpa perlu panik, Ibu Laras langsung menekan tombol “Top-Up Token” di aplikasi. Sistem mengarahkan beliau untuk meminta invoice add-on secara otomatis. Beliau membeli paket tambahan 10.000 Token. Invoice langsung terbit, Ibu Laras melakukan pembayaran via transfer bank virtual account, dan dalam waktu kurang dari lima menit, saldo token bertambah secara otomatis. Operasional kasir terus berjalan mulus, pelanggan tetap menerima e-struk WhatsApp mereka, dan acara Mega Sale berjalan sukses tanpa ada satupun layanan yang terputus akibat kendala sistem pembayaran.
Alur Kerja Konsumsi Token
Bagan alir di bawah ini memvisualisasikan bagaimana sebuah fitur premium diperiksa, bagaimana Token dipotong dari saldo tenant secara real-time, dan tindakan apa yang diambil sistem jika saldo Token terdeteksi tidak mencukupi untuk membiayai operasi tersebut.
flowchart TD
Mulai([Mulai: Fitur Premium Dipanggil]) --> CekFitur{Berapa Harga Token\nFitur Ini?}
CekFitur -->|Misal: 5 Token| CekSaldo[Sistem Memeriksa Saldo Tenant di D1 Database]
CekSaldo --> KondisiSaldo{Apakah Saldo >= 5?}
KondisiSaldo -- Ya, Cukup --> PotongSaldo[Update D1: Kurangi Saldo Token Sebanyak 5]
PotongSaldo --> CatatRiwayat[Tambahkan Entri ke Tabel Riwayat Pemakaian]
CatatRiwayat --> EksekusiFitur[Izinkan Eksekusi Logika Utama Fitur Premium]
EksekusiFitur --> Selesai([Selesai: Sukses])
KondisiSaldo -- Tidak, Kurang --> TolakFitur[Hentikan Eksekusi Fitur Sementara]
TolakFitur --> KirimAlert[Kirim Notifikasi Alert ke Dashboard Pemilik]
KirimAlert --> ResponseError[Kembalikan Error: 'Insufficient Tokens' ke Frontend]
ResponseError --> SelesaiGagal([Selesai: Gagal])Teknologi & Infrastruktur
Manajemen Token menuntut presisi mutlak dan penanganan transaksi yang tangguh untuk memastikan bahwa saldo selalu akurat meskipun di tengah badai permintaan operasional kasir (Concurrency).
| Komponen Sistem | Teknologi yang Digunakan | Penjelasan Fungsional |
|---|---|---|
| Buku Besar Token | Cloudflare D1 (Tabel tenant_tokens) | Menyimpan angka absolut saldo ketersediaan token saat ini untuk setiap tenant. Membutuhkan penguncian transaksi (transaction locks) yang baik untuk mencegah kondisi balapan (race condition). |
| Pencatatan Historis | Cloudflare D1 (Tabel token_usages) | Sebuah tabel append-only (hanya tambah) yang mencatat setiap insiden pengurangan atau penambahan token, berfungsi sebagai catatan audit keuangan (ledger). |
| Penentuan Harga Fitur | File Konfigurasi (Environment / D1) | Mendefinisikan aturan statis berapa banyak token yang dikonsumsi oleh tindakan tertentu (misal: Notifikasi WA = 5, Export Excel Laporan Besar = 2). |
| Pembuatan Tagihan (Invoice) | Integrasi Payment Gateway (Xendit/Midtrans) | Mengotomatisasi pembuatan nomor rekening virtual (VA) dan mendengarkan status pembayaran (webhook) saat tenant membeli paket Top-Up. |
| Alert Saldo Kritis | Sistem Notifikasi Internal | Memicu peringatan otomatis di antarmuka aplikasi atau via email ketika saldo token menyentuh ambang batas tertentu (misalnya tersisa 10%). |
Keterkaitan dengan Fitur Lain
Sistem Token bertindak sebagai polisi lalu lintas yang mengatur jalannya berbagai fitur tingkat lanjut di dalam platform Temuya POS:
- Panel Kontrol Super Admin: Super Admin memiliki wewenang dewa untuk masuk ke dalam manajemen tenant dan secara sepihak mengubah saldo token. Mereka dapat memberikan token bonus (secara gratis) sebagai kompensasi atas gangguan sistem (downtime), atau menetapkan ulang harga fitur secara global.
- Webhooks & API Eksternal: Penggunaan Webhooks dan integrasi Kunci API secara ekstensif seringkali merupakan fitur premium yang memakan kuota Token. Semakin banyak panggilan API yang dilakukan oleh sistem middleware pelanggan ke server kami, semakin banyak pula token yang akan terkuras secara perlahan.
- Sistem Notifikasi & Alert: Fitur notifikasi bertanggung jawab penuh untuk memberitahu pemilik bisnis saat “bahan bakar” token mereka hampir habis, memberi mereka waktu yang cukup untuk mengisi ulang tanpa mengganggu alur kerja kasir yang sibuk melayani pembeli.
Hal Penting yang Perlu Diketahui
Untuk menjaga stabilitas operasional bisnis tanpa terganggu oleh masalah administratif kuota, pengguna tingkat manajerial dan administrator harus memperhatikan pedoman berikut terkait manajemen token:
- Pantau Secara Berkala: Jangan biarkan saldo token kosong sepenuhnya. Jadikan pemantauan saldo token di halaman dasbor sebagai rutinitas manajemen mingguan, sama pentingnya dengan memeriksa sisa stok barang dagangan fisik Anda.
- Pahami Harga Fitur: Kenali dengan pasti fitur-fitur mana di dalam sistem POS yang mengonsumsi token dan berapa biayanya. Mengedukasi karyawan kasir untuk tidak menekan tombol ekspor laporan berat berulang kali dapat membantu mencegah kebocoran token yang tidak disengaja.
- Risiko Kegagalan Transaksi (Graceful Degradation): Sangat penting untuk dipahami bahwa jika saldo token habis, operasional penjualan dasar (seperti mencatat pesanan tunai) tidak akan pernah dihentikan. Namun, fitur periferal canggih (seperti notifikasi SMS/WA atau sinkronisasi dengan aplikasi akuntansi eksternal) akan ditangguhkan secara otomatis hingga saldo mencukupi kembali. Sistem kami dirancang untuk memprioritaskan kelangsungan transaksi di toko fisik Anda di atas segalanya.
- Proses Kliring Invoice: Saat Anda melakukan Top-Up Token melalui transfer bank atau pembayaran dompet digital (e-wallet), mungkin diperlukan waktu beberapa menit (antara 2 hingga 15 menit) sebelum gerbang pembayaran berhasil mengkonfirmasi transaksi ke server kami dan saldo token Anda diperbarui. Lakukan top-up lebih awal, jangan menunggu sampai saldo benar-benar menjadi nol.
- Token Tidak Hangus: Berbeda dengan sistem paket kuota data seluler konvensional yang me-reset sisa kuota setiap akhir bulan, saldo token Top-Up yang Anda beli terpisah dari kuota langganan tidak akan pernah hangus (rollover). Mereka akan tetap tersimpan di dalam brankas akun Anda tanpa ada batas waktu kadaluarsa, siap digunakan kapan saja bisnis Anda membutuhkannya.