Troubleshooting

Masalah yang sering dialami beserta langkah penyelesaian.

Email & Akun

Email verifikasi tidak datang

  1. Cek folder Promosi/Spam. Filter Gmail kadang masuk ke tab "Updates" atau "Promotions".
  2. Tunggu 5 menit — server email kadang delay.
  3. Salah ketik email saat daftar? Daftar ulang dengan email yang benar (akun lama tidak akan aktif tanpa verifikasi).
  4. Kirim ulang: login dengan email + password → muncul tombol Kirim Ulang Email.
  5. Masih tidak datang? Hubungi support, sertakan email dan timestamp pendaftaran.

Lupa password

  1. Halaman login → Lupa Password.
  2. Masukkan email, klik Kirim Link Reset.
  3. Buka email (subject: "Reset password OtoSwitch"), klik link.
  4. Masukkan password baru (min. 8 karakter).
  5. Login dengan password baru.

Link berlaku 1 jam.

Tidak bisa login walaupun password benar

  • Email belum diverifikasi. Cek folder spam, klik link verifikasi dulu.
  • Akun di-suspend. Hubungi support.
  • Browser cache. Coba incognito mode atau clear cookies untuk domain OtoSwitch.

Sesi Digiflazz

Saldo "−" / status Auth merah

Sesi Digiflazz expired atau cookie invalid.

  1. Buka /setup.html.
  2. Login ulang ke member.digiflazz.com dengan Remember me tercentang.
  3. Paste cURL baru atau manual input.
  4. Klik Hubungkan.

Banner kuning "Auto-refresh sesi tidak aktif"

Cookie remember_web_* tidak ditemukan. Tanpa ini, sesi expire ~2 hari.

  1. Logout dari Digiflazz.
  2. Login ulang dengan Remember me tercentang.
  3. Rebind sesi di /setup.html.

Detail: Onboarding → Rebind sesi.

Setup berhasil tapi langsung balik ke setup lagi

Cookie kemungkinan dijaga oleh Cloudflare anti-bot. Coba:

  1. Bersihkan cookie Digiflazz di browser (DevTools → Application → Cookies → delete all).
  2. Login ulang ke Digiflazz, selesaikan semua challenge Cloudflare kalau muncul.
  3. Setelah dashboard Digiflazz ke-load penuh, baru ambil cURL.

"Max re-login attempts exceeded"

Sesi expired dan re-login auto gagal 2x. Stop monitor, rebind manual via /setup.html, lalu start lagi.

Monitor & Scan

Monitor selalu mati setelah refresh halaman

Monitor adalah background task — refresh halaman tidak menghentikannya. Kalau benar mati:

  1. Cek banner subscription — kalau expired, perpanjang.
  2. Cek kartu Auth — kalau merah, rebind sesi.
  3. Cek log sistem — cari ERROR sebelum monitor stop.
  4. Klik Mulai Monitor untuk start ulang.

Scan tidak menemukan produk gangguan padahal di Digiflazz ada

  • Cache produk OtoSwitch outdated. Tunggu siklus berikutnya atau klik Scan Closed di Ringkasan untuk force scan.

Scan timeout

  • Cek koneksi server ke member.digiflazz.com.
  • Increase requestTimeoutMs di Pengaturan → API (default 30000 = 30s).

Auto-switch tidak jalan padahal ada produk gangguan

  1. Cek Pengaturan → Behavior → autoSwitch ON dan dryRun OFF.
  2. Cek plan — Trial tidak support auto-switch.
  3. Cek log — mungkin tidak ada supplier yang lolos filter (semua di-block atau di luar batas harga).

Pembayaran & Langganan

Sudah bayar tapi status order masih pending

  1. Tunggu 5-10 menit. Webhook gateway kadang delay.
  2. Cek email — gateway biasanya kirim konfirmasi pembayaran.
  3. Klik order di tab Riwayat untuk lihat detail. Kalau ada tombol Cek Status Manual, klik.
  4. Masih pending setelah 30 menit? Hubungi support, sertakan ID order.

QRIS expired

QRIS berlaku 30 menit (default). Buat order baru.

Sudah bayar QRIS tapi status tetap pending

Sistem matching QRIS pakai nominal persis (termasuk digit unik). Pastikan:

  • Bayar persis sesuai nominal yang ditampilkan (mis. Rp 99.123, bukan Rp 99.000).
  • Sumber dana sama dengan QR scanner (DANA/OVO/etc).
  • Tunggu 1-3 menit untuk relay notifikasi DANA Bisnis.

Kalau masih tidak update, hubungi support dengan bukti transfer.

Banner "Langganan expired" tapi sudah bayar

Cache subscription belum reload. Logout-login ulang, atau tunggu 5 menit untuk auto-refresh.

Telegram

Notifikasi tidak masuk walaupun status Terhubung

  1. Plan masih aktif? Trial tidak support Telegram.
  2. Bot tidak di-block di Telegram (cek Telegram → bot info).
  3. Tunggu 5 menit — webhook delay normal.
  4. Coba unbind dan link ulang.

Bot tidak respons saat klik /start

Token expired (>15 menit). Klik Hubungkan Telegram lagi di dashboard untuk dapat link baru.

Bot kirim "Akun tidak ditemukan"

Token expired atau salah link. Klik Hubungkan Telegram baru.

Dashboard

Halaman blank / loading terus

  1. Hard refresh: Ctrl+Shift+R (Windows/Linux) atau Cmd+Shift+R (Mac).
  2. Clear cache untuk domain OtoSwitch.
  3. Coba incognito mode untuk eliminate extension interference.
  4. Cek console browser (F12 → Console) — kalau ada error, screenshot dan kirim ke support.

Tab Produk lambat scroll / tidak responsive

Browser lama atau jumlah produk banyak. Workaround:

  • Pakai filter & pagination — jangan load semua.
  • Update browser ke versi terbaru.

Theme toggle tidak jalan

Reset theme:

  1. F12 → Application → Local Storage.
  2. Hapus key theme.
  3. Refresh halaman.

API

Request return 401 walaupun API key benar

  • Header X-Api-Key salah ketik.
  • Kunci sudah di-revoke.
  • Generate kunci baru, update.

Request return 403

  • Subscription expired → perpanjang.
  • Plan tidak support API → upgrade ke Basic/Pro.

Request return 409

  • Sesi Digiflazz user expired di OtoSwitch. User harus rebind di /setup.html. Kalau ini API user lain, hubungi mereka.

Request return 429 berulang

Rate limit terlampaui. Kurangi frekuensi sync atau pakai If-None-Match.

Header Retry-After kasih tahu berapa detik harus tunggu.

ETag selalu beda walaupun data sama

Server cache TTL 10 menit. ETag refresh tiap window. Pakai If-None-Match di setiap request untuk maksimalkan 304 hit.

Performance

Server lambat respons

Kemungkinan:

  • Banyak user simultaneous (production).
  • Background task heavy (proactive scan).
  • Database lambat.

Operator/admin: cek /api/health dan /api/metrics.

File data/changes.db membengkak

Aman dihapus saat monitor mati:

# stop monitor dulu via dashboard
rm data/changes.db
# start monitor lagi

Snapshot baseline dibikin ulang di siklus pertama.

Reporting Bug

Kalau masalah belum tercover di sini, lapor lewat halaman dukungan / support email. Sertakan:

  1. Langkah reproduksi — apa yang dilakukan sebelum masalah.
  2. Error message dari banner atau dialog.
  3. Console log browser (F12 → Console → screenshot).
  4. Server log sekitar waktu masalah (kalau punya akses).
  5. Screenshot halaman yang bermasalah.
  6. Browser & OS versi.