Memasang Konek QR Listener

Konek QR Listener adalah aplikasi Android yang membaca notifikasi "pembayaran diterima" dari aplikasi akun merchant di HP-mu, lalu mengirim nominalnya ke Konek QR untuk dicocokkan dengan tagihan. Tanpa Listener, tagihan hanya bisa ditandai lunas manual.

Yang dibutuhkan:

• HP Android yang sudah login ke aplikasi merchant penerima QRIS-mu, dengan notifikasi pembayarannya aktif. Paling aman HP khusus kasir yang selalu dicas dan tersambung internet.
• Akun Konek QR. Satu akun bisa memasangkan maksimal 2 HP.

1. Unduh APK dari dashboard

Listener tidak ada di Google Play. Unduh hanya dari app.konekqr.web.id/listener (menu Aplikasi). Jangan pasang APK Konek QR yang dikirim lewat chat atau grup.

Halaman itu menampilkan versi, ukuran, SHA-256 file APK, dan sidik jari sertifikat penanda tangan. Sebelum memasang, kamu bisa:

• membuka link VirusTotal di halaman itu (langsung ke hasil pindaian file yang sama),
• mencocokkan SHA-256 file yang kamu unduh dengan yang tertulis,
• untuk yang paham teknis: apksigner verify --print-certs konekqr-listener.apk, lalu bandingkan sidik jari sertifikatnya. Setiap versi ditandatangani sertifikat yang sama; kalau berbeda, jangan dipasang.

2. Pasang APK

1. Buka file yang sudah diunduh (dari notifikasi unduhan atau aplikasi File).
2. Kalau diminta, izinkan browser atau aplikasi File memasang aplikasi dari sumber ini.
3. Play Protect bisa memperingatkan karena aplikasinya bukan dari Google Play. Pastikan SHA-256 cocok, lalu pilih pasang tetap.

3. Izinkan akses notifikasi (dan "Setelan terbatas")

Buka Konek QR Listener, baca layar persetujuan data (apa yang dibaca, ke mana dikirim, berapa lama disimpan), lalu izinkan akses notifikasi.

Di Android 13 ke atas, aplikasi yang dipasang dari luar Play Store bisa terkena Setelan terbatas (Restricted settings): tombol akses notifikasi abu-abu dengan pesan "Untuk keamanan Anda, setelan ini saat ini tidak tersedia". Cara membukanya:

1. Buka Setelan → Aplikasi → Konek QR Listener.
2. Ketuk menu ⋮ di kanan atas, lalu Izinkan setelan terbatas (Allow restricted settings), dan konfirmasi dengan PIN atau sidik jari.
3. Kembali ke Listener dan aktifkan akses notifikasi.

Menu ⋮ baru muncul setelah kamu sekali mencoba mengaktifkan akses notifikasi dan ditolak. Kalau tetap tidak ada, ketik "setelan terbatas" di kolom pencarian Setelan.

4. Jangan biarkan HP mematikan Listener

Android, terutama di Xiaomi, Oppo, Vivo, dan Realme, sering mematikan aplikasi yang berjalan di latar belakang. Listener punya cek kesehatan dengan tombol perbaikan untuk setiap poin di bawah; ikuti sampai semuanya hijau.

Letak menu per merek (namanya bisa sedikit berbeda antarversi):

• Xiaomi / Redmi / POCO (MIUI, HyperOS): Setelan → Aplikasi → Kelola aplikasi → Konek QR Listener → Mulai otomatis aktif, dan Penghemat baterai → Tanpa batasan. Kunci juga Listener di layar aplikasi terbaru (tekan lama kartunya → ikon gembok).
• Oppo / Realme (ColorOS, realme UI): Setelan → Aplikasi → Manajemen aplikasi → Konek QR Listener → Penggunaan baterai: aktifkan Izinkan aktivitas latar belakang dan Izinkan mulai otomatis.
• Vivo (Funtouch OS, OriginOS): Setelan → Baterai → Konsumsi daya latar belakang tinggi → izinkan Listener; lalu i Manager → Manajemen aplikasi → Mulai otomatis → aktifkan Listener.
• Samsung (One UI): Setelan → Aplikasi → Konek QR Listener → Baterai → Tidak dibatasi. Pastikan Listener tidak ada di daftar Aplikasi tidur di Perawatan perangkat → Baterai → Batas penggunaan latar belakang.

Panduan per merek yang lebih lengkap: dontkillmyapp.com.

5. Pasangkan HP ke akun

1. Di komputer, buka app.konekqr.web.id/devices (menu Perangkat) → Pasangkan HP. Masukkan password akunmu: HP yang dipasangkan bisa mengonfirmasi pembayaran, jadi langkah ini butuh verifikasi ulang.
2. Dashboard menampilkan QR pairing. Kode ini berlaku 10 menit dan hanya sekali pakai.
3. Di Listener, pilih pasangkan, scan QR itu, dan beri nama HP (misalnya "HP Kasir").
4. Dalam beberapa detik HP muncul di halaman Perangkat dengan status Online, beserta versi aplikasi, baterai, dan jumlah antrean.

6. Verifikasi QRIS

QRIS baru bisa dipakai untuk tagihan live setelah terverifikasi. Di QRIS, tekan verifikasi pada QRIS-mu, lalu bayar nominal kecil yang diminta (Rp1.001–Rp1.999) ke QRIS itu sendiri dari aplikasi apa saja. Begitu Listener mendeteksi pembayarannya, QRIS menjadi aktif.

Cara Listener bekerja sehari-hari

• Setiap notifikasi pembayaran langsung disimpan di antrean HP sebelum dikirim. Saat internet putus, antrean dikirim ulang otomatis begitu koneksi kembali, setelah HP dinyalakan ulang, dan setiap 15 menit. Antrean disimpan sampai 7 hari.
• Pencocokan memakai waktu notifikasi muncul di HP (dikoreksi selisih jam HP), jadi pembayaran saat HP offline tetap dihitung tepat waktu.
• HP mengirim heartbeat setiap 180 detik. Kalau tidak ada kabar selama 7 menit, HP dianggap offline: dashboard menampilkannya, event device.offline dikirim ke webhook, dan kanal notifikasimu (Telegram, Discord, email) diberi tahu.
• Listener hanya membaca notifikasi dari aplikasi merchant di daftar resmi. Chat, SMS, dan aplikasi lain tidak dikirim. Listener tidak pernah meminta password, PIN, atau OTP akun merchant-mu.

Kalau ada masalah