Dokumentasi
DocsVoucher Hotspot

Voucher Hotspot

Panduan lengkap sistem voucher hotspot LancarTech — dari pembuatan batch voucher, template cetak kustom, distribusi multi-channel, integrasi otomatis dengan MikroTik, hingga laporan penjualan dan cleanup voucher expired. Cocok untuk RT/RW Net, cafe, hotel, coworking space, event WiFi, dan layanan internet prepaid lainnya.

Overview

Sistem voucher hotspot LancarTech dirancang khusus untuk ISP dan

Model voucher sangat populer di Indonesia untuk berbagai skenario:

Generate Batch Voucher

Buat ratusan hingga ribuan voucher sekaligus dengan satu klik. Kode unik di-generate otomatis.

Template Cetak Kustom

Desain template voucher sesuai branding ISP Anda — lengkap dengan QR code, logo, dan instruksi koneksi.

Distribusi Multi-Channel

Cetak fisik, kirim via WhatsApp, atau jual langsung melalui halaman kasir terintegrasi.

Integrasi MikroTik Otomatis

Saat voucher diaktifkan, user hotspot otomatis dibuat di MikroTik — tanpa intervensi manual.

Membuat Voucher Batch

Fitur batch generation memungkinkan Anda membuat puluhan hingga

1
Buka Menu Voucher

Navigasi ke menu Hotspot > Voucher di dashboard admin. Klik tombol Generate Voucher untuk membuka form pembuatan batch baru.

2
Pilih Profil Hotspot

Pilih profil hotspot MikroTik yang akan digunakan untuk voucher ini. Profil menentukan bandwidth (upload/download speed), rate limit, dan konfigurasi lainnya. Pastikan profil sudah dibuat terlebih dahulu di halaman Hotspot > Profil.

3
Tentukan Jumlah Voucher

Masukkan jumlah voucher yang ingin di-generate (1 hingga 10.000 per batch). Sistem akan membuat kode unik alfanumerik untuk setiap voucher. Format kode dapat dikonfigurasi: panjang karakter (6-16), huruf kapital/kecil, dengan atau tanpa angka.

4
Atur Durasi Akses

Tentukan berapa lama voucher aktif setelah digunakan. Opsi durasi: jam (1, 2, 3, 6, 12, 24 jam), hari (1, 3, 7, 14, 30 hari), atau kustom. Durasi dihitung sejak voucher pertama kali diaktifkan oleh subscriber, bukan sejak voucher dibuat.

5
Konfigurasi Limit (Opsional)

Atur batasan tambahan jika diperlukan: kuota data (MB/GB), jumlah perangkat yang bisa konek bersamaan (shared users), dan idle timeout. Jika tidak diisi, voucher akan unlimited hingga durasi habis.

6
Tentukan Harga & Masa Berlaku

Masukkan harga jual voucher dan masa berlaku voucher (expired date). Masa berlaku adalah batas waktu voucher bisa digunakan — berbeda dengan durasi akses. Contoh: voucher berlaku 30 hari sejak dicetak, dengan durasi akses 24 jam.

7
Generate & Review

Klik Generate untuk membuat voucher. Sistem akan menampilkan preview batch yang berisi daftar semua kode voucher beserta konfigurasinya. Anda bisa langsung mencetak atau menyimpan untuk distribusi nanti.

Nama Batch:: Cafe-Merdeka-Jan-2026

Template Voucher

LancarTech menyediakan sistem template cetak voucher yang dapat

Elemen Template

Logo & Nama ISP

Upload logo perusahaan dan nama ISP yang akan ditampilkan di setiap voucher. Mendukung format PNG, JPG, dan SVG dengan resolusi optimal untuk cetak.

Kode Voucher & QR Code

Kode voucher ditampilkan dalam font besar yang mudah dibaca. QR code otomatis di-generate dari kode voucher — subscriber cukup scan QR untuk auto-fill kode di halaman login hotspot.

Informasi Paket

Nama paket, kecepatan bandwidth (download/upload), durasi akses, kuota data (jika ada), dan jumlah device yang diizinkan ditampilkan secara jelas.

Instruksi Koneksi

Panduan singkat cara menggunakan voucher: nama SSID WiFi yang harus dikoneksikan, cara membuka halaman login, dan tempat memasukkan kode voucher.

Harga & Masa Berlaku

Harga jual voucher dan tanggal kedaluwarsa ditampilkan agar subscriber mengetahui batas waktu penggunaan.

Informasi Kontak

Nomor telepon, WhatsApp, atau media sosial ISP untuk bantuan teknis jika subscriber mengalami kendala.

Ukuran Template

UkuranDimensiPer Halaman A4Cocok Untuk
Voucher Status5.5 x 3 cmAksi yang TersediaRevoke Voucher:
SedangVoucher Reports10 voucherDashboard Ringkasan:
BesarIntegrasi MikroTik6 voucherProses Otomatis
Konfigurasi Profil Hotspot8.5 x 5.5 cmMulti-Router:Profesional — ukuran standar business card
Expired Voucher CleanupBebasManual Cleanup:Kebutuhan spesifik — atur dimensi sendiri

Tips Cetak:: printer disetel ke mode

Distribusi Voucher

Setelah voucher di-generate, ada beberapa cara untuk

Cetak Fisik

Cetak voucher langsung dari dashboard menggunakan template yang sudah dikonfigurasi. Cocok untuk cafe, hotel, atau warnet yang menyerahkan voucher fisik ke pelanggan. Pilih batch yang ingin dicetak, pilih template, lalu klik Cetak. Sistem akan men-generate file PDF siap cetak dengan layout otomatis sesuai ukuran kertas A4.

Kirim via WhatsApp

Kirim kode voucher langsung ke nomor WhatsApp pelanggan. Fitur ini terintegrasi dengan sistem WhatsApp Gateway LancarTech. Anda bisa mengirim satu per satu atau broadcast ke beberapa nomor sekaligus. Pesan otomatis berisi kode voucher, instruksi koneksi, nama SSID, durasi akses, dan masa berlaku.

Penjualan via Kasir

Gunakan halaman Kasir (POS) di LancarTech untuk menjual voucher secara langsung. Petugas kasir memilih paket voucher, menerima pembayaran (cash/QRIS/transfer), lalu sistem otomatis mencetak atau menampilkan kode voucher. Riwayat penjualan tercatat lengkap untuk rekonsiliasi.

Reseller / Agen

Alokasikan batch voucher ke reseller atau agen penjualan. Setiap reseller mendapat batch terpisah sehingga penjualan bisa dilacak per agen. Sistem mencatat voucher mana yang terjual oleh reseller mana untuk perhitungan komisi.

Stok Voucher:: stok voucher menipis (threshold dapat dikonfigurasi) agar Anda

Aktivasi & Pemakaian

Berikut adalah alur lengkap cara subscriber menggunakan voucher

1

Koneksi ke SSID WiFi

Subscriber menghubungkan perangkat (HP, laptop, tablet) ke jaringan WiFi hotspot Anda. SSID yang digunakan sesuai konfigurasi MikroTik — misalnya WiFi-CafeMerdeka atau Hotspot-RT05.

2

Redirect ke Halaman Login

Setelah terkoneksi, browser subscriber otomatis diarahkan ke halaman login hotspot (captive portal). Halaman ini dapat dikustomisasi dengan branding ISP Anda — logo, warna, dan informasi kontak.

3

Input Kode Voucher

Subscriber memasukkan kode voucher yang didapat (dari cetakan fisik, WhatsApp, atau kasir). Alternatif: subscriber bisa scan QR code pada voucher fisik untuk auto-fill kode di form login.

4

Validasi & Aktivasi

Sistem memvalidasi kode voucher — memeriksa apakah kode valid, belum pernah digunakan, dan belum expired. Jika valid, sistem otomatis membuat user hotspot di MikroTik dengan profil yang sesuai dan timer durasi mulai berjalan.

5

Akses Internet Aktif

Subscriber langsung mendapat akses internet sesuai konfigurasi voucher (bandwidth, durasi, kuota). Status voucher berubah menjadi Active. Subscriber bisa memonitor sisa waktu dan kuota melalui halaman status hotspot.

6

Durasi Habis / Kuota Habis

Saat durasi atau kuota habis, akses internet otomatis diputus. User hotspot di-remove dari MikroTik. Subscriber perlu membeli voucher baru untuk melanjutkan akses. Status voucher berubah menjadi Used.

Multi-Device:: bisa menggunakan kode yang sama di beberapa device secara

Voucher Status

Setiap voucher memiliki status lifecycle yang menunjukkan kondisi

StatusWarnaDeskripsiAksi yang Tersedia
QR Code:Hijauhttps://lancartech.com/portal/voucher?slug=slug-isp-andaCetak, Kirim WhatsApp, Jual di Kasir, Revoke
Kustomisasi Tema Voucher LoginBiruTema yang TersediaCara Preview Tema
Untuk melihat preview tema sebelum memilih, tambahkan parameter?theme=Voucher sudah selesai digunakan — durasi habis atau kuota habis. Tidak bisa digunakan lagi.Memilih Tema di Settings
Branding Otomatis:KuningPengaturan > PerusahaanLihat detail, Cleanup otomatis
https://lancartech.com/portal/voucher?slug=isp-slug&theme=oceanSelanjutnya: Billing & InvoiceVoucher dicabut secara manual oleh admin. Jika sedang aktif, koneksi subscriber langsung diputus.Lihat alasan revoke

Revoke Voucher:: refund. Voucher yang di-revoke saat sedang aktif akan langsung

Voucher Reports

LancarTech menyediakan laporan komprehensif untuk memantau performa

LaporanDeskripsiKegunaan
Penjualan per BatchJumlah voucher terjual vs total di setiap batch, beserta revenue yang dihasilkanMengukur performa penjualan per lokasi atau event
Redemption RatePersentase voucher yang sudah diaktifkan dari total yang diterbitkan per periodeMengetahui efektivitas distribusi — rate rendah berarti banyak voucher tidak sampai ke subscriber
Revenue VoucherTotal pendapatan dari penjualan voucher per hari, minggu, dan bulan dengan tren grafikMemantau pertumbuhan revenue hotspot dan forecasting pendapatan
Revenue per ProfilPendapatan dikelompokkan berdasarkan profil hotspot (paket voucher)Analisis paket mana yang paling laris dan paling menguntungkan
Voucher ExpiredDaftar voucher yang expired tanpa pernah digunakan per batchMengidentifikasi batch dengan tingkat expired tinggi untuk evaluasi distribusi
Penjualan per KasirVolume dan revenue penjualan dikelompokkan per petugas kasir atau resellerEvaluasi performa penjualan per staff dan perhitungan komisi reseller
Penggunaan HarianJumlah voucher yang diaktifkan per jam dan per hari dalam bentuk heatmapMengetahui jam dan hari puncak penggunaan untuk optimasi kapasitas bandwidth

Dashboard Ringkasan:: terjual hari ini, revenue hari ini, dan redemption rate bulan

Integrasi MikroTik

Integrasi antara sistem voucher LancarTech dengan MikroTik berjalan

Proses Otomatis

1
Voucher Diaktifkan

Saat subscriber memasukkan kode voucher di captive portal, LancarTech menerima request aktivasi dan memvalidasi voucher.

2
Create Hotspot User

Sistem otomatis membuat hotspot user di MikroTik melalui REST API. User dibuat dengan profil yang sesuai konfigurasi voucher — termasuk bandwidth limit, uptime limit, dan bytes quota.

3
Assign IP & MAC Binding

MikroTik memberikan IP address ke perangkat subscriber. Jika dikonfigurasi, MAC address binding dilakukan untuk mencegah pemakaian di perangkat lain.

4
Monitor Penggunaan

LancarTech secara berkala mem-poll data penggunaan dari MikroTik — bytes in/out, uptime, dan status koneksi. Data ini ditampilkan di dashboard admin secara real-time.

5
Auto-Remove saat Habis

Saat durasi atau kuota habis, MikroTik otomatis memutus koneksi. LancarTech mendeteksi perubahan status ini dan mengupdate status voucher menjadi Used.

Konfigurasi Profil Hotspot

Sebelum membuat voucher, pastikan profil hotspot sudah dikonfigurasi

ProfilBandwidthDurasiKuotaHarga
1 Jam Basic2M/2M1 JamUnlimitedRp 3.000
3 Jam Standard5M/5M3 JamUnlimitedRp 5.000
1 Hari Regular10M/10M24 JamUnlimitedRp 10.000
3 Hari Plus15M/15M3 HariUnlimitedRp 25.000
7 Hari Premium20M/20M7 HariUnlimitedRp 50.000
30 Hari Ultra30M/30M30 HariUnlimitedRp 150.000
VIP Unlimited50M/50M30 HariUnlimitedRp 250.000

Multi-Router:: mendukung manajemen multi-router. Setiap batch voucher bisa

Expired Voucher Cleanup

Voucher yang sudah expired atau telah digunakan akan menumpuk

Background Job Otomatis

Cleanup berjalan otomatis sebagai background task setiap hari pada dini hari (default: 02:00 WIB). Job ini memeriksa semua voucher yang sudah melewati masa berlaku dan menandainya sebagai Expired jika belum pernah diaktifkan.

Soft Delete

Voucher yang di-cleanup tidak dihapus secara permanen dari database — hanya ditandai dengan deleted_at (soft delete). Data tetap tersedia untuk laporan historis dan audit. Ini sesuai dengan kebijakan LancarTech untuk tidak pernah hard-delete data billing.

Cleanup User Hotspot MikroTik

Bersamaan dengan cleanup voucher, sistem juga membersihkan user hotspot yang sudah expired di MikroTik melalui REST API. Ini mencegah penumpukan user tidak aktif di router yang bisa mempengaruhi performa.

Konfigurasi Retention

Admin dapat mengatur berapa lama data voucher expired disimpan sebelum di-soft-delete: 30 hari, 90 hari, 180 hari, atau 1 tahun. Default retention period adalah 90 hari setelah tanggal expired.

Notifikasi Cleanup

Setelah cleanup selesai, admin menerima ringkasan di dashboard: jumlah voucher yang di-cleanup, jumlah user MikroTik yang dibersihkan, dan space database yang dihemat.

Manual Cleanup:: yang ingin di-cleanup, lalu klik

Tips & Best Practices

Berikut adalah tips dan praktik terbaik untuk mengoptimalkan bisnis

Strategi harga bertingkat (tiered pricing)

Buat beberapa tier paket voucher dengan variasi bandwidth, durasi, dan harga. Misalnya: Basic (2M, 1 jam, Rp 3.000), Standard (5M, 3 jam, Rp 7.000), Premium (10M, 24 jam, Rp 15.000). Pelanggan cenderung memilih paket tengah (decoy effect), yang biasanya memiliki margin terbaik.

Masa berlaku voucher yang tepat

Untuk cafe dan warung: masa berlaku 7-14 hari cukup. Untuk hotel: masa berlaku sesuai durasi menginap. Untuk reseller: 30-60 hari agar ada waktu menjual. Jangan terlalu panjang karena meningkatkan risiko penyalahgunaan, tapi juga jangan terlalu pendek karena pelanggan bisa merasa dirugikan.

Optimalkan distribusi channel

Cafe dan hotel: cetak fisik + QR code di setiap meja. RT/RW Net: distribusi via WhatsApp + kasir keliling. Event: cetak batch khusus dengan branding event. Reseller: alokasi batch terpisah per agen. Pantau channel mana yang memiliki redemption rate tertinggi dan fokuskan distribusi di sana.

Buat paket bundle

Tawarkan diskon untuk pembelian bundle voucher — misalnya beli 5 voucher harian seharga 4 voucher (hemat 20%). Ini meningkatkan volume penjualan dan mendorong pelanggan untuk membeli lebih banyak sekaligus. Konfigurasi bundle tersedia di halaman Hotspot > Profil.

Monitor jam puncak dan sesuaikan bandwidth

Gunakan laporan Penggunaan Harian untuk mengidentifikasi jam puncak. Jika bandwidth terlalu padat di jam tertentu, pertimbangkan membuat profil voucher terpisah untuk jam sibuk dan jam sepi — misalnya harga lebih murah untuk jam 00:00-08:00 (off-peak).

Gunakan QR code secara maksimal

QR code mempercepat proses aktivasi dan mengurangi kesalahan input kode. Pastikan QR code pada voucher cetak berukuran minimal 2x2 cm agar mudah di-scan. Uji scan dengan beberapa jenis HP sebelum cetak batch besar.

Rekonsiliasi penjualan harian

Lakukan pencocokan antara penjualan voucher di kasir dengan stok voucher di sistem setiap akhir shift. Ini mencegah kehilangan pendapatan akibat voucher yang terjual tapi tidak tercatat, atau sebaliknya. Gunakan laporan Penjualan per Kasir sebagai referensi.

Siapkan stok buffer

Selalu siapkan stok voucher 20-30% lebih banyak dari perkiraan penjualan. Kehabisan stok di jam ramai sangat merugikan — pelanggan akan pergi dan mungkin tidak kembali. Atur notifikasi stok menipis di Pengaturan > Voucher agar selalu terpantau.

Evaluasi Bulanan:: redemption rate (target > 85%), revenue growth, paket

Setup Captive Portal MikroTik

Agar subscriber yang connect ke WiFi hotspot otomatis diarahkan ke

Persyaratan:: dapat diakses dari jaringan hotspot.

Langkah 1: Konfigurasi Hotspot Server

Buka Winbox atau Terminal MikroTik, lalu jalankan perintah berikut:

# 1. Buat Hotspot Server Profile dengan login page LancarTech
/ip hotspot profile
add name=lancartech-profile \
    login-by=http-chap \
    html-directory=hotspot \
    http-cookie-lifetime=1d \
    rate-limit=1M/1M

# 2. Set login URL ke halaman voucher LancarTech
# Ganti "slug-isp-anda" dengan slug tenant Anda
/ip hotspot profile set lancartech-profile \
    login-url="https://lancartech.com/portal/voucher?slug=slug-isp-anda"

# 3. Buat Hotspot Server pada interface WiFi
/ip hotspot
add name=hotspot-lt \
    interface=wlan1 \
    profile=lancartech-profile \
    address-pool=hotspot-pool \
    disabled=no

Langkah 2: Walled Garden (Whitelist Domain)

Izinkan akses ke domain LancarTech tanpa login agar halaman voucher

# Whitelist domain LancarTech
/ip hotspot walled-garden
add dst-host="lancartech.com" action=allow
add dst-host="*.lancartech.com" action=allow

# Whitelist IP walled-garden (untuk HTTPS)
/ip hotspot walled-garden ip
add dst-address=0.0.0.0/0 dst-port=443 protocol=tcp action=allow \
    comment="HTTPS for captive portal"
add dst-address=0.0.0.0/0 dst-port=80 protocol=tcp action=allow \
    comment="HTTP redirect"

Langkah 3: DNS & DHCP

# Pastikan DHCP server memberikan DNS yang benar
/ip dhcp-server network
set [find] dns-server=8.8.8.8,8.8.4.4

# Pastikan router bisa resolve domain
/ip dns
set servers=8.8.8.8,1.1.1.1 allow-remote-requests=yes

Alur Captive Portal

LangkahProses
1User connect ke WiFi hotspot (SSID: ISP-Hotspot)
2MikroTik intercept → redirect ke halaman voucher LancarTech
3User input kode voucher di halaman LancarTech
4LancarTech validasi kode → auto-create subscriber
5LancarTech auto-provision hotspot user ke MikroTik via REST API
6MikroTik authorize user → internet aktif

QR Code:: Untuk mempermudah, cetak QR code berisi

Kustomisasi Tema Voucher Login

LancarTech menyediakan 5 tema visual bawaan untuk halaman login

Tema yang Tersedia

TemaDeskripsi
cleanMinimalist — latar putih bersih dengan tipografi modern, cocok untuk ISP profesional
gradientPurple Glass — efek glassmorphism dengan gradien ungu elegan, kesan premium
neonDark Tech — latar gelap dengan aksen neon, cocok untuk ISP yang menargetkan segmen gaming/tech
sunsetWarm Orange — gradien oranye-kuning hangat, kesan ramah dan approachable
oceanDeep Teal — nuansa biru-hijau laut dalam, kesan tenang dan terpercaya

Cara Preview Tema

Untuk melihat preview tema sebelum memilih, tambahkan parameter

https://lancartech.com/portal/voucher?slug=isp-slug&theme=gradient
https://lancartech.com/portal/voucher?slug=isp-slug&theme=ocean
https://lancartech.com/portal/voucher?slug=isp-slug&theme=neon

Memilih Tema di Settings

1
Buka Pengaturan

Navigasi ke menu Pengaturan > Portal & Voucher dari sidebar dashboard.

2
Pilih Tema

Pada bagian 'Tema Halaman Voucher', pilih salah satu dari 5 tema yang tersedia. Preview langsung ditampilkan di sebelah kanan.

3
Simpan Perubahan

Klik Simpan. Tema langsung aktif untuk semua halaman voucher login tenant Anda.

Branding Otomatis:: sudah di-upload agar tampilan halaman voucher lebih profesional.