FQrisDocs
SitusStatus
Panduan

FQris Listener

Aplikasi Android yang membaca notifikasi uang masuk DANA Bisnis dan meneruskannya ke FQris, supaya payment terkonfirmasi otomatis.

6 menit bacaDiperbarui 29 Okt 2026

Apa yang dilakukan Listener

Listener dipasang di HP yang sama dengan aplikasi DANA Bisnis. Ia membaca notifikasi dari aplikasi sumber, menyimpannya di antrean lokal, lalu mengirimnya ke FQris. Pencocokan ke payment dan penentuan status dikerjakan server. Notifikasi dari aplikasi lain diabaikan dan tidak pernah dikirim.

Sumber yang didukung
Saat ini hanya DANA Bisnis (paket id.dana). Parsernya sudah terbukti dengan pembayaran uang nyata di produksi. Aplikasi sumber lain belum didukung.

Hanya sisi penerima yang harus DANA Bisnis. Pembeli boleh membayar dari e-wallet atau m-banking apa pun yang bisa memindai QRIS.

Pasang APK

  1. 1
    Siapkan HP khusus Android 8.0 atau lebih baru. Pasang DANA Bisnis dan login, sambungkan ke charger, dan biarkan menyala 24 jam.
  2. 2
    Unduh APK dari dashboard Buka Perangkat, lalu Unduh APK. Dashboard menampilkan versi dan SHA-256 file itu. Listener dibagikan sebagai APK, bukan lewat Play Store, jadi Android akan meminta izin memasang dari sumber ini.

Pairing dengan dashboard

  1. 1
    Tambah perangkat Di dashboard buka Perangkat, lalu Tambah perangkat. Isi nama, pilih QRIS yang dipantau (satu QRIS per aplikasi sumber), lalu Buat kode QR. Belum punya QRIS? Tambahkan dulu sebelum memasang Listener.
  2. 2
    Pindai atau ketik kode Aplikasi menampilkan "Pindai QR pairing" dan petunjuk "Dashboard → Perangkat → Tambah perangkat. Atau ketik kode 8 karakter." Arahkan kamera ke QR di dashboard, atau ketik kode 8 karakternya.
  3. 3
    Terhubung Layar berubah menjadi "Terhubung ke" disusul namamu, dengan tombol "Lanjut ke wizard kesiapan".
Kode berlaku 10 menit
Kode hanya bisa dipakai sekali dan kedaluwarsa dalam 10 menit. Kalau aplikasi menjawab "Kode salah atau kedaluwarsa", pilih Buat kode baru di dashboard lalu coba lagi.

Wizard kesiapan

Wizard memeriksa lima pengaturan. Item yang belum siap punya tombol Perbaiki yang membuka pengaturan Android terkait. Subjudulnya berubah dari "N pengaturan perlu diperbaiki" menjadi "Siap mendengarkan DANA Bisnis" saat kelimanya selesai.

  1. 1
    Akses notifikasi Wajib untuk membaca notifikasi DANA Bisnis
  2. 2
    Notifikasi FQris Untuk notifikasi permanen foreground service
  3. 3
    Abaikan optimasi baterai Supaya Listener tidak dimatikan sistem
  4. 4
    Autostart Mulai otomatis setelah HP restart
  5. 5
    DANA Bisnis terpasang & login Notifikasi aplikasi sumber aktif

Android tidak memberi tahu apakah Autostart aktif atau DANA Bisnis sudah login, jadi dua item itu kamu konfirmasi sendiri dengan tombol Sudah setelah membuka pengaturannya.

Autostart per merek HP
Panduan di aplikasi saat ini untuk Xiaomi: "Panduan autostart Xiaomi: Pengaturan → Aplikasi → FQris Listener → Mulai otomatis." Di merek lain, cari sendiri pengaturan mulai otomatis untuk FQris Listener.

Kirim notifikasi uji

Di layar status, ketuk tombol besarnya ("ketuk: simulasi notifikasi"). Aplikasi memunculkan notifikasi lokal, memastikan service menangkapnya, lalu mengirim event selftest ke server. Kalau berhasil, tombol menampilkan "✓ Diterima server" disusul lama responsnya, dan dashboard menandai perangkat "Perangkat siap ✓".

Status dan kesehatan

Listener mengirim heartbeat tiap 60 detik. Layar status menampilkan tiga keadaan, dan dashboard menghitung yang setara dari heartbeat itu.

  1. 1
    Aktif (di dashboard: Online) Heartbeat terakhir paling lama 3 menit lalu, listener tersambung, dan akses notifikasi aktif.
  2. 2
    Bermasalah (di dashboard: Terganggu) Heartbeat masuk tetapi ada masalah: akses notifikasi dicabut, listener terputus, DANA Bisnis tidak terpasang atau notifikasinya dimatikan, antrean lebih dari 10 item atau item tertua lebih dari 2 menit, atau baterai di bawah 15% dan tidak mengisi.
  3. 3
    Terputus (di dashboard: Offline) Heartbeat terakhir lebih dari 3 menit lalu. Pembayaran yang masuk belum terdeteksi otomatis sampai Listener tersambung lagi.

Saat perangkat berubah ke offline atau terganggu, Owner mendapat notifikasi. Di HP, notifikasi permanen "FQris aktif — mendengarkan DANA Bisnis" menandakan service berjalan; jangan dimatikan.

Agar tetap hidup di latar

  1. 1
    Pakai HP khusus Tanpa aplikasi lain selain DANA Bisnis dan FQris Listener. Jangan dimatikan, biarkan dicolok ke charger.
  2. 2
    Kecualikan dari hemat baterai Set FQris ke "Tanpa batasan" dan kunci di recent apps, sesuai merek HP.
  3. 3
    Biarkan akses notifikasi aktif Kalau akses notifikasi dicabut, Listener tidak bisa membaca apa pun dan statusnya menjadi Bermasalah.
  4. 4
    Aman saat jaringan putus Notifikasi disimpan di antrean lokal dan dikirim ulang dengan jeda 2, 5, 15, 30, lalu tiap 60 detik, sampai 72 jam.
Batas yang diketahui
Android tidak punya API untuk membaca notifikasi yang sudah hilang. Notifikasi DANA yang dihapus sebelum Listener hidup tidak bisa dibaca. Pembayaran yang terlewat dicocokkan manual di Rekonsiliasi.

Cabut dan ganti perangkat

Di dashboard, menu aksi perangkat punya Cabut. HP itu berhenti mengirim notifikasi dan harus di-pair ulang untuk dipakai lagi; aplikasinya kembali ke layar pairing.

Kalau HP mati total, pasang aplikasi di HP cadangan lalu pasangkan. Satu merchant bisa punya lebih dari satu perangkat.

Apakah halaman ini membantu?