Masa Aktif & Perpanjangan

Setiap organisasi di Ticksnap punya masa aktif berlangganan yang otomatis diperpanjang setiap kali pembayaran sukses. Halaman ini menjelaskan cara perhitungannya dan apa yang terjadi saat masa aktif habis.

Cara hitung perpanjangan

Begitu pembayaran Anda dikonfirmasi oleh Midtrans (status Lunas), masa aktif organisasi ditambah 1 bulan menggunakan logika berikut:

Kondisi saat pembayaran sukses	Masa aktif baru
Masih dalam masa aktif (belum habis)	Tanggal habis lama + 1 bulan — alias stack/renewal. Tidak ada hari yang hangus.
Sudah lewat masa aktif (mis. di-deactivate)	Tanggal pembayaran + 1 bulan — fresh start dari saat dana masuk.

Contoh:

• Hari ini 14 Mei 2026, masa aktif Anda berakhir 20 Mei 2026 (masih aktif). Anda bayar Professional hari ini. Masa aktif baru = 20 Juni 2026 (20 Mei + 1 bulan).
• Hari ini 14 Mei 2026, masa aktif Anda berakhir 10 Mei 2026 (sudah lewat 4 hari). Anda bayar hari ini. Masa aktif baru = 14 Juni 2026 (hari ini + 1 bulan) — 4 hari yang lewat tidak diakumulasi.

Kenapa pakai 'bulan kalender', bukan 30 hari?

Perhitungan menggunakan relativedelta — yaitu 1 bulan kalender. 31 Januari + 1 bulan = 28 Februari (atau 29 di tahun kabisat); 15 Mei + 1 bulan = 15 Juni; dan seterusnya. Konsisten dengan ekspektasi langganan bulanan.

Apa yang terjadi saat masa aktif habis?

1. Sweep otomatis di login. Setiap kali ada user dari organisasi Anda mencoba login, sistem terlebih dulu memeriksa apakah masa_aktif < sekarang. Jika ya, organisasi langsung dimatikan (is_active = false).
2. User yang login dialihkan ke halaman Masa Aktif Habis. Login tetap berhasil — JWT tetap diterbitkan — tetapi semua route monitoring/admin diblokir oleh frontend dan user otomatis dialihkan ke /expired.
3. Sesi JWT yang masih valid (user yang sudah login sebelumnya, JWT belum expired) tetap bisa bekerja sampai tokennya habis (default 3 jam). Mereka akan terdampar ke /expired setelah refresh halaman atau buka tab baru karena AuthContext re-evaluate setiap navigasi.

Tampilan halaman Masa Aktif Habis

• Untuk admin (role=admin):

  :material-calendar-x: Masa Aktif Berlangganan Habis Masa berlangganan PT Contoh sudah berakhir pada 10 Mei 2026.

  Sebagai admin, Anda dapat memperpanjang langganan langsung dari halaman Tagihan & Paket. Setelah pembayaran terkonfirmasi oleh sistem Midtrans, akses organisasi akan otomatis aktif kembali.

  [ Perpanjang Sekarang ] → ke Tagihan & Paket

• Untuk karyawan (role=employee):

  :material-megaphone: Silakan hubungi admin perusahaan Anda untuk melakukan perpanjangan langganan. Setelah pembayaran selesai, akses Anda akan otomatis aktif kembali tanpa perlu login ulang.

Kedua role mendapat:

• Tombol Periksa Status Akses — call ulang server untuk cek apakah pembayaran sudah masuk; kalau sudah, langsung redirect ke dashboard.
• Tombol Keluar — logout normal.

Recovery flow (admin)

1. Login → masuk otomatis ke /expired (karena org sudah expired)
2. Klik "Perpanjang Sekarang" → /admin/billing
3. Pilih paket (Perpanjang / Tingkatkan / Turunkan) → modal Snap
4. Bayar via metode pilihan Anda
5. Setelah popup Snap menampilkan "Pembayaran berhasil" / "Menunggu",
   tunggu 5–15 detik supaya Midtrans selesai memproses
6. Kembali ke /expired (atau klik link "Masa Aktif Habis" di sidebar)
7. Klik "Periksa Status Akses" → kalau sudah aktif, otomatis ke /admin/dashboard

Recovery flow (karyawan)

Karyawan tidak punya akses ke halaman Tagihan & Paket — hanya admin yang bisa bayar. Begitu admin selesai bayar dan org otomatis aktif kembali, karyawan tinggal:

• Klik "Periksa Status Akses" di halaman Masa Aktif Habis — atau cukup refresh halaman.
• Tidak perlu logout dan login ulang.

Masa aktif awal saat akun baru di-approve

Saat tim IT Ticksnap meng-approve registrasi perusahaan baru lewat tool internal (approve_org.py), masa aktif awal diberikan otomatis berdasarkan paket yang dipilih saat pendaftaran:

Kategori	Masa aktif awal	Catatan
Pilot	1 bulan dari approval	Free trial — tidak perlu pembayaran selama jendela ini.
Starter / Professional / Enterprise	1 hari dari approval	PIC wajib menyelesaikan pembayaran pertama via Tagihan & Paket dalam ≤ 24 jam — kalau lewat, sistem auto-deactivate sampai PIC bayar.

PIC akan menerima email aktivasi setelah approval — buat password, login, lalu (untuk paket non-Pilot) langsung lakukan pembayaran pertama. Pembayaran sukses akan menambah masa aktif sesuai logika Cara hitung perpanjangan di atas (umumnya stack ke 1 bulan ke depan).

Status placeholder pre-payment

Ketika sistem upgrade ke fitur tenant expiry (migrasi 08), semua organisasi yang sudah ada saat itu diberi grace period 30 hari dari saat migrasi dijalankan supaya tidak langsung ke-deactivate. Setelah grace period habis, semua tenant tunduk pada flow yang sama: pembayaran tepat waktu, atau auto-deactivate sampai diperpanjang.

FAQ

Saya admin tapi tidak bisa login sama sekali — gimana?

Login seharusnya tetap berhasil walau masa aktif habis (Anda akan dilempar ke halaman Masa Aktif Habis). Kalau benar-benar tidak bisa login (mis. ditolak dengan pesan Email atau password salah), berarti masalah kredensial, bukan masa aktif. Coba reset password lewat tim Ticksnap.

Saya sudah bayar tapi status masih Menunggu di Riwayat Tagihan

Untuk metode VA / QRIS / minimarket, Midtrans baru mengirim notifikasi setelah dana benar-benar masuk ke rekening mereka — biasanya 5–15 menit untuk transfer bank, instan untuk e-wallet. Refresh halaman atau klik Periksa Status Akses setelah beberapa menit. Kalau lebih dari 30 menit masih Menunggu, hubungi tim Ticksnap dengan menyertakan Order ID.

Berapa lama tampilan kuning '7 hari lagi' muncul?

Indikator masa aktif di header Tagihan & Paket berubah warna jadi kuning ketika tinggal ≤ 7 hari. Gunakan ini sebagai pengingat soft — sistem belum mengirim notifikasi email otomatis. (Email reminder ada di roadmap.)

Bisa beli langsung 3 / 6 / 12 bulan sekaligus?

Saat ini paket UI hanya 1 bulan per transaksi. Untuk pembelian multi-bulan, ulangi pembayaran beberapa kali (akan ter-stack +1 bulan tiap kali) atau hubungi tim Ticksnap untuk arrangement custom.