QRIS Dinamis

QRIS Dinamis memungkinkan toko Anda menerima pembayaran QRIS memakai QRIS statis milik toko sendiri (dari bank atau e-wallet Anda) — tanpa mendaftar ke payment gateway dan tanpa biaya per transaksi. Alusio mengubah QRIS statis Anda menjadi QRIS dinamis di setiap pesanan: nominal terisi otomatis, ditambah kode unik kecil supaya tiap pembayaran bisa dicocokkan ke pesanan yang tepat.

Pembayaran dikonfirmasi dengan dua cara: otomatis lewat aplikasi Android Alusio QRIS yang membaca notifikasi pembayaran masuk di HP Anda, atau manual lewat upload bukti bayar oleh customer. Konfirmasi manual selalu tersedia sebagai jaring pengaman.

Penting sebelum mulai

• Bersifat eksklusif. Saat QRIS Dinamis aktif, halaman checkout hanya menampilkan QRIS — metode lain (Manual, Midtrans, Xendit, Duitku, Stripe, PayPal) disembunyikan sementara. Konfigurasi metode lain tidak dihapus dan otomatis aktif lagi begitu QRIS Dinamis dimatikan.

• Deteksi otomatis bersifat best-effort (~95–98%), bukan settlement resmi. Deteksi bergantung pada notifikasi HP, jadi selalu biarkan konfirmasi manual sebagai cadangan.

• Tanpa biaya gateway. Uang masuk langsung ke akun QRIS toko Anda; Alusio tidak memotong biaya transaksi.

Prasyarat

• QRIS statis toko — gambar atau string QRIS dari bank/e-wallet Anda (mis. GoPay Merchant, DANA, ShopeePay, OVO, atau QRIS bank). String payload diawali 00020101....

• Satu HP Android (Android 8 / Oreo ke atas) untuk memasang aplikasi Alusio QRIS — idealnya HP khusus yang selalu online dan terhubung charger.

• Aplikasi e-wallet / m-banking penerima terpasang di HP tersebut, dan notifikasi pembayarannya aktif (tidak di-mute).

Cara kerja secara singkat

1. Customer checkout lalu memilih QRIS. Halaman pesanan menampilkan QRIS dinamis — nominal dan kode unik sudah menyatu di dalam QR.

2. Customer scan & bayar memakai aplikasi apa pun yang mendukung QRIS.

3. Notifikasi “dana masuk” muncul di HP Anda. Aplikasi Alusio QRIS membaca notifikasi itu dan mengirim teksnya ke server Alusio.

4. Server mem-parsing nominal, mencocokkannya dengan pesanan yang sedang menunggu (berdasarkan nominal + kode unik), lalu menandai pesanan Paid otomatis.

Kode unik (0–999) membuat dua pesanan berharga sama tetap punya nominal akhir yang berbeda, sehingga pencocokan tidak tertukar. Anda tidak perlu menyisipkan nomor pesanan ke mana pun — pencocokan murni lewat nominal.

Langkah 1 — Siapkan QRIS statis toko

1. Ambil QRIS statis toko Anda dari aplikasi bank atau e-wallet (menu QRIS / Terima Pembayaran / Kode QR Saya).

2. Simpan sebagai gambar (screenshot/unduhan) atau salin string-nya bila tersedia. Keduanya bisa dipakai.

Catatan: QRIS toko biasanya bertipe statis (nominal diisi manual oleh pembeli). QRIS personal seperti ShopeePay/GoPay/DANA pun bisa dipakai — Alusio yang akan membuat versi dinamisnya per pesanan.

Langkah 2 — Aktifkan QRIS Dinamis di Alusio

1. Buka dashboard Alusio → Settings → Payments → tab QRIS Dinamis.

2. Pada QRIS Statis, klik Upload Gambar QR lalu pilih gambar QRIS toko — atau tempel string-nya ke kolom teks. Alusio langsung memverifikasi: badge hijau “QRIS valid” beserta nama merchant berarti payload terbaca benar. Jika muncul “Checksum (CRC) tidak cocok”, berarti gambar kurang jelas atau string terpotong — ulangi.

3. Aktifkan toggle Aktifkan QRIS Dinamis.

4. Opsional: aktifkan Tampilkan “via QRIS” agar label tersebut muncul sebagai subtitle metode di checkout.

5. Klik Simpan Pengaturan QRIS.

Setelah tersimpan, gunakan tombol Tes QRIS Dinamis (di kotak “Cara Kerja & Deteksi Pembayaran”): masukkan sebuah nominal, lalu scan QR yang muncul dengan aplikasi e-wallet Anda untuk memastikan QRIS toko benar-benar bisa dibayar — tanpa perlu membuat produk atau pesanan. (Jangan lupa selesaikan/hentikan transaksi tes bila Anda benar-benar membayarnya.)

Langkah 3 — Install aplikasi Alusio QRIS (APK)

Aplikasi Alusio QRIS adalah listener Android yang membaca notifikasi pembayaran dan meneruskannya ke Alusio untuk deteksi otomatis. Saat ini didistribusikan sebagai APK internal (belum di Play Store) — mintalah file .apk-nya ke tim/support Alusio.

1. Salin file APK ke HP Android yang akan dipakai menerima pembayaran.

2. Buka file APK. Android akan meminta izin “Install unknown apps” untuk aplikasi sumber (mis. File Manager / Chrome) — aktifkan, lalu lanjutkan instalasi.

3. Setelah terpasang, buka aplikasi Alusio QRIS.

Kenapa sideload? Aplikasi ini butuh akses baca notifikasi — izin sensitif yang memang ditujukan untuk penggunaan internal merchant, bukan aplikasi publik konsumen.

Langkah 4 — Beri izin & pasangkan perangkat (pairing)

1. Di aplikasi, tekan Scan QR Pairing. Kembali ke dashboard Alusio (tab QRIS Dinamis, kotak biru “Hubungkan aplikasi Alusio QRIS”), lalu arahkan kamera HP ke QR pairing di sana. QR ini berisi alamat webhook + token rahasia toko Anda — jangan dibagikan. Muncul notifikasi “Perangkat berhasil dipasangkan” bila sukses.

2. Tekan Berikan Akses Notifikasi → di layar sistem Android, aktifkan Alusio QRIS pada daftar aplikasi yang boleh membaca notifikasi. Ini izin terpenting; tanpa ini deteksi otomatis tidak jalan.

3. Tekan Kecualikan dari Penghematan Baterai dan setujui. Langkah ini wajib di HP Xiaomi/Redmi/POCO, Oppo, Vivo, Realme, dan Samsung agar sistem tidak mematikan listener.

4. Izinkan permintaan notifikasi aplikasi (Android 13+) supaya notifikasi status listener bisa tampil.

Kartu “Izin & Status” harus menampilkan “✓ Akses notifikasi: AKTIF” dan perangkat sudah terhubung ke nama situs Anda.

Langkah 5 — Uji coba end-to-end

1. Buat pesanan uji di toko Anda dan pilih QRIS di checkout.

2. Di halaman pesanan, scan QRIS dinamis dan bayar nominal kecil (mis. Rp1.000-an + kode unik) dari e-wallet lain.

3. Dalam beberapa detik setelah notifikasi masuk, status pesanan di Orders harus berubah menjadi Paid. Aktivitas juga terlihat di layar utama aplikasi (bagian Aktivitas Terakhir).

Apakah aplikasi boleh ditutup?

Jangan tutup/geser aplikasi dari daftar Recent Apps. Aplikasi tidak perlu selalu terlihat di layar — ia berjalan sebagai foreground service dengan notifikasi tetap “Listener aktif — memantau pembayaran QRIS”. Selama notifikasi itu ada, listener bekerja di latar belakang meski layar mati.

Yang penting: proses aplikasi tidak boleh dibunuh sistem. Seberapa “galak” sistem mematikan aplikasi latar belakang berbeda-beda per merek HP:

Setelah HP restart, aplikasi otomatis menyalakan kembali listener-nya (lewat BootReceiver) — tidak perlu dibuka manual, walau membukanya sekali setelah reboot tidak ada salahnya untuk memastikan.

Rekomendasi: gunakan satu HP khusus yang selalu tercolok charger dan terhubung internet (Wi-Fi/data). HP itu tidak harus selalu menyala layarnya — cukup hidup dan online.

Bagaimana aplikasi bekerja (untuk yang ingin tahu)

Alusio QRIS adalah thin client — ia hanya menangkap teks notifikasi mentah dan mengirimnya ke server; server yang memutuskan nominalnya. Alurnya:

1. Notifikasi dari aplikasi e-wallet yang didukung tertangkap oleh NotificationListenerService.

2. Teksnya masuk ke antrean lokal (tahan kondisi offline, dengan pencegahan duplikat).

3. Sebuah worker mengirimnya ke webhook Alusio; bila gagal/offline, otomatis dicoba ulang dengan jeda bertambah.

4. Server mem-parsing nominal, mencocokkan ke pesanan, dan menandai Paid.

Konsekuensi desain ini: bila format notifikasi e-wallet berubah, cukup Alusio memperbarui parser di server — Anda tidak perlu meng-install ulang APK. Data pairing (token) tersimpan aman di perangkat, dan riwayat notifikasi lama dibersihkan otomatis setelah beberapa hari.

Aplikasi pembayaran yang didukung (deteksi otomatis)

Saat ini deteksi otomatis mengenali notifikasi dari:

• GoPay, DANA, ShopeePay, dan OVO.

Aplikasi lain menyusul. Untuk metode di luar daftar ini — atau bila deteksi terlewat — pembayaran tetap bisa diselesaikan lewat konfirmasi manual. Yang menerima uang tetap boleh aplikasi apa pun yang mendukung QRIS; deteksi otomatis-nyalah yang terbatas pada aplikasi di atas.

Konfirmasi manual (jaring pengaman)

Karena deteksi berbasis notifikasi tidak pernah 100%, setiap pesanan QRIS juga menyediakan jalur manual:

• Customer dapat upload bukti bayar di halaman pesanan.

• Anda meninjau dan menandai pesanan Paid dari dashboard Orders.

Jadi meski HP listener mati, sinyal lambat, atau notifikasi tidak masuk, pesanan tetap bisa diselesaikan.

Troubleshooting

Keamanan

• QR pairing berisi token rahasia toko Anda. Jangan screenshot lalu sebarkan; siapa pun yang memilikinya bisa mengirim notifikasi palsu ke webhook Anda.

• Bila token bocor atau HP hilang, simpan ulang pengaturan QRIS untuk menghasilkan pairing baru, lalu pasangkan ulang perangkat.

• Deteksi otomatis adalah indikator, bukan pengganti rekonsiliasi. Untuk nominal besar, cocokkan juga mutasi masuk di akun QRIS Anda.