Voucher hotspot MikroTik tidak bisa login: 6 penyebab dan cara memeriksanya

Voucher hotspot yang ditolak hampir selalu menimbulkan reaksi yang sama: kode voucher dibuat ulang, lalu tetap gagal. Padahal kode jarang jadi penyebabnya. Yang bermasalah biasanya profil user, batas perangkat, jam router, atau letak hotspot server-nya.

Urutan di bawah ini sengaja dari yang paling cepat diperiksa. Berhenti di langkah pertama yang menemukan masalah — jangan mengubah lima hal sekaligus, karena setelah itu kamu tidak akan tahu mana yang memperbaiki.

1. Cek user-nya dulu, bukan kodenya

/ip hotspot user print detail where name="VCR-1023"

Yang harus terlihat: profile menunjuk profil yang benar, limit-uptime atau limit-bytes masih tersisa, dan disabled bernilai no. Kalau uptime sudah mendekati limit-uptime, voucher itu memang habis — bukan error.

Satu jebakan yang sering: user dibuat di profil yang tidak ada. RouterOS tetap menyimpan user-nya, tetapi saat login, hotspot tidak menemukan profil dan menolak tanpa pesan yang jelas. Periksa daftar profil:

/ip hotspot user profile print

2. Batas perangkat (shared users) tercapai

Voucher yang sama dipakai dua perangkat, sementara profil hanya mengizinkan satu. Perangkat kedua akan ditolak meski kode benar. Lihat siapa yang sedang aktif:

/ip hotspot active print where user="VCR-1023"

Perhatikan kolom mac-address dan address. Kalau ada dua entri dengan user sama, itu penyebabnya. Putuskan yang lama, atau naikkan shared-users di profil kalau memang itu aturan jualnya:

/ip hotspot user profile set [find name="profil-1jam"] shared-users=2

3. Bind ke MAC address perangkat lain

Kalau voucher pernah dibuat dengan mac-address tertentu (misalnya saat uji coba di HP kamu), voucher itu hanya bisa dipakai dari perangkat itu:

/ip hotspot user print detail where name="VCR-1023"

Cari field mac-address. Kalau terisi, hapus:

/ip hotspot user set [find name="VCR-1023"] mac-address=""

4. Jam router melenceng

Masa aktif hotspot dihitung dari jam router. Router tanpa NTP bisa mundur beberapa jam setelah listrik mati, sehingga voucher yang seharusnya masih berlaku dianggap kedaluwarsa — atau sebaliknya, voucher seharian bertahan dua hari.

/system clock print
/system ntp client print
/system ntp client set enabled=yes
/system ntp client servers add address=pool.ntp.org

Setelah jam benar, cek ulang satu voucher. Kalau masalahnya jam, semua voucher lama akan langsung berperilaku normal tanpa perlu dibuat ulang.

5. Hotspot server menempel di interface yang salah

Gejalanya khas: halaman login muncul (jadi server hotspot-nya jalan), tetapi setelah menekan Login, halaman kembali ke form kosong. Ini sering terjadi setelah bridge diubah atau port dipindah.

/ip hotspot print detail
/ip hotspot profile print detail

Pastikan interface pada hotspot adalah interface yang benar-benar dilalui klien (biasanya bridge, bukan ether3). Kalau klien masuk lewat bridge sementara hotspot menempel di salah satu port, autentikasi tidak akan pernah cocok.

Periksa juga host-nya terdaftar:

/ip hotspot host print

Kalau perangkat klien tidak muncul di daftar host, masalahnya ada di lapisan bawah hotspot: IP, DHCP, atau bridge — bukan di voucher.

6. DNS dan walled garden

Voucher benar, profil benar, tapi setelah login klien tidak bisa membuka apa pun karena DNS tidak tersedia. Halaman login memang biasanya lolos karena masuk walled garden, jadi orang menyimpulkan “voucher gagal” padahal autentikasinya sukses.

/ip dns print
/ip hotspot walled-garden print

Pastikan allow-remote-requests=yes dan klien memakai router sebagai DNS. Kalau kamu memakai DNS publik langsung di klien, tambahkan alamat tersebut ke walled-garden agar halaman login tetap bisa diakses sebelum autentikasi.

Membaca log: cara tercepat tahu penyebabnya

Daripada menebak, lihat apa yang dicatat router saat login gagal:

/log print where topics~"hotspot"

Beberapa baris yang bermakna:

• login failed: invalid username or password — kode salah ketik atau user tidak ada.
• login failed: user ... is already active — batas perangkat (poin 2).
• login failed: no more sessions — kuota sesi habis.
• logged in diikuti klien kembali ke halaman login — DNS/walled garden (poin 6).

Kalau log kosong sama sekali saat kamu mencoba login, berarti perangkat klien tidak sampai ke hotspot server. Balik ke poin 5.

Menguji ulang dengan cara yang benar

Setelah satu perbaikan, uji dengan prosedur yang sama setiap kali:

1. Putuskan sesi lama: /ip hotspot active remove [find user="VCR-1023"].
2. Dari perangkat klien, logout dulu (jangan hanya menutup tab browser), lalu buka ulang halaman login.
3. Login, lalu pastikan muncul di /ip hotspot active.
4. Buka satu situs yang tidak masuk walled-garden, dan cek /ip hotspot active print masih menampilkan sesi tersebut setelah 2 menit.

Empat langkah ini memisahkan “autentikasi berhasil” dari “internet benar-benar jalan” — dua hal yang sering dicampur saat melaporkan masalah.

Yang tidak saya sarankan

• Membuat ulang semua voucher sebelum log dibaca. Kalau penyebabnya jam router atau shared-users, voucher baru akan gagal dengan cara yang sama, dan kamu kehilangan kode yang mungkin sudah dijual.
• Menambah shared-users tanpa batas sebagai solusi cepat. Itu menghilangkan fungsi pembatasan yang justru jadi alasan hotspot dipasang.
• Mematikan hotspot lalu menyalakan ulang sebagai rutinitas. Perbaikan yang tidak menjelaskan penyebab akan kembali lagi minggu depan.

Kalau setelah enam pemeriksaan ini voucher masih ditolak, biasanya masalahnya sudah bukan satu pengaturan, melainkan rancangan profil yang tumpang tindih. Saya mengerjakan itu sebagai pekerjaan remote dengan lingkup tertulis: jasa setting hotspot & voucher MikroTik.