kalcerPOSPanduan
Kasir

QRIS otomatis

Add-on yang membaca notifikasi "pembayaran masuk" dari aplikasi bank di HP toko, lalu mengonfirmasi order QRIS di kasir tanpa perlu ditekan.

Add-on

Tanpa add-on ini, kasir harus melihat HP toko, menunggu notifikasi pembayaran masuk, lalu menekan Confirm payment. Dengan QRIS otomatis, sebuah aplikasi Android kecil di HP toko membaca notifikasi itu dan memberi tahu kalcerPOS. Order yang nominalnya cocok langsung terkonfirmasi dan struknya tercetak.

Paket: QRIS otomatis adalah add-on seharga Rp 50.000 per bulan, untuk paket apa pun. Hubungi tim kalcerPOS untuk mengaktifkannya. Fitur ini memakai QRIS dinamis, jadi QRIS statis toko harus sudah diunggah.

Cara kerjanya

  1. Kasir memilih QRIS di layar pembayaran. Totalnya sudah termasuk kode unik, misalnya Rp 45.017.
  2. Pelanggan scan dan membayar.
  3. Aplikasi bank/e-wallet penerima QRIS di HP toko menampilkan notifikasi pembayaran masuk.
  4. Aplikasi QRIS Auto-Confirm di HP yang sama membaca nominal dari notifikasi itu dan mengirimnya ke kalcerPOS.
  5. kalcerPOS mencari pembayaran QRIS yang sedang menunggu dengan nominal persis sama. Kalau ketemu satu, order di kasir terkonfirmasi sendiri.

Di layar pembayaran kasir tertulis ⏳ Waiting for QRIS notification… selama menunggu. Begitu cocok, tulisannya berubah menjadi ✅ Payment detected — confirming… dan order tersimpan seperti biasa. Layar QR besar dari Show to customer juga tertutup sendiri.

QRIS menunggu notifikasi di kasir
Kasir menunggu notifikasi. Tombol Confirm payment tetap bisa dipakai.

Penting: kode unik itulah yang membuat nominal setiap pembayaran berbeda. Karena itu konfirmasi otomatis hanya bisa bekerja dengan QRIS dinamis dari kalcerPOS, bukan dengan pelanggan yang mengetik nominal sendiri di QRIS statis.

Yang perlu disiapkan

  • HP Android yang menerima notifikasi dari aplikasi bank/e-wallet penerima QRIS toko. HP ini harus tetap menyala dan tersambung internet selama toko buka.
  • Aplikasi QRIS Auto-Confirm. Minta file aplikasinya ke tim kalcerPOS saat add-on diaktifkan, lalu pasang di HP itu.
  • Notifikasi aplikasi bank/e-wallet harus aktif di HP tersebut.

Mengambil kunci listener

  1. Buka Admin → Settings, cari kotak QRIS listener key.
  2. Ketuk Generate API key.
  3. Ketuk Copy untuk menyalin kuncinya. Kirim ke HP toko lewat cara yang aman, misalnya chat ke diri sendiri lalu hapus.

Kalau kunci bocor, ketuk Regenerate key. Kunci lama langsung tidak berlaku, jadi tempel kunci baru di aplikasi.

Catatan: kunci listener berbeda dengan kunci External API. Masing-masing punya kotaknya sendiri di Settings.

Memasang aplikasi di HP toko

Buka aplikasi QRIS Auto-Confirm. Layarnya terbagi menjadi empat bagian bernomor.

1. Izin membaca notifikasi

  1. Di bagian 1. NOTIFICATION ACCESS, ketuk OPEN NOTIFICATION ACCESS SETTINGS.
  2. Cari QRIS Auto-Confirm di daftar, lalu aktifkan.
  3. Kembali ke aplikasi. Statusnya harus ACCESS granted.
  4. Ketuk EXEMPT FROM BATTERY OPTIMIZATION, lalu izinkan. Statusnya harus BATTERY unrestricted.

Penting: banyak HP (Xiaomi, Oppo, Vivo, Samsung) mematikan aplikasi di latar belakang untuk menghemat baterai. Kalau langkah baterai dilewati, notifikasi bisa berhenti terbaca tanpa tanda apa pun.

2. Memilih aplikasi bank

  1. Buka aplikasi bank/e-wallet penerima QRIS sekali, atau tunggu sampai ada notifikasi apa pun darinya.
  2. Kembali ke QRIS Auto-Confirm. Di bagian 2. SOURCE APPS, ketuk REFRESH CAPTURED NOTIFICATIONS.
  3. Di daftar yang muncul, ketuk ADD pada aplikasi bank/e-wallet tersebut.

Kamu bisa memilih lebih dari satu aplikasi kalau toko menerima pembayaran lewat beberapa aplikasi. Ketuk REMOVE untuk membatalkan pilihan.

3. Alamat toko dan kunci

  1. Di bagian 3. BACKEND, isi POS BACKEND URL dengan alamat toko kamu, contoh https://namatoko.kalcerpos.com. Hapus dulu isi bawaannya.
  2. Tempel kunci listener di kolom API KEY.
  3. Pastikan Listening enabled menyala.
  4. Ketuk SAVE.

4. Tes koneksi

Ketuk SEND TEST. Kalau berhasil, muncul pesan yang diawali OK:. Kalau gagal:

PesanArtinya
Failed (401)Kunci salah atau sudah diganti. Salin ulang dari QRIS listener key.
Failed (403)Add-on QRIS otomatis belum aktif untuk toko ini. Hubungi tim kalcerPOS.
Failed (-1) atau Failed (404)HP tidak tersambung internet, atau alamat toko salah ketik.

Di bagian 4. STATUS tertulis LAST EVENT, yaitu nominal terakhir yang dibaca dan apakah sudah terkirim.

Tips: setelah semuanya siap, coba satu transaksi QRIS kecil sungguhan dari awal sampai akhir sebelum dipakai saat ramai. Pastikan order di kasir terkonfirmasi sendiri.

Memantau lewat QRIS Log

Buka Admin → QRIS Log. Halaman ini menampilkan setiap pembayaran QRIS dari kasir:

KolomIsi
CreatedKapan layar QRIS dibuka
AmountNominal yang ditunggu, termasuk kode unik
Statuswaiting (menunggu), matched (notifikasi cocok), confirmed (order tersimpan)
CashierKasir yang membuka pembayaran
CodeKode unik
Matched, ConfirmedWaktu cocok dan waktu order tersimpan
Notification textTeks notifikasi dari HP toko

Di atas tabel ada jumlah entri per status. Tabel bisa diurutkan, difilter dan diekspor ke CSV. Pembayaran yang dibatalkan kasir saat masih menunggu tidak tercatat di sini.

Konfirmasi manual tetap ada

Tombol Confirm payment di layar pembayaran tidak pernah hilang. Kasir boleh menekannya kapan saja setelah memastikan uang masuk, misalnya kalau:

  • HP toko sedang mati atau tidak ada internet.
  • Notifikasi bank terlambat atau tidak muncul.
  • Ada dua pembayaran dengan nominal sama (lihat di bawah).

Batasan

  • Dua pembayaran dengan nominal sama. Kalau dua layar QRIS menunggu nominal yang persis sama, kalcerPOS tidak menebak. Keduanya harus dikonfirmasi manual. Untuk menghindarinya, ketuk ↻ di sebelah Unique code (QRIS) pada salah satu kasir agar nominalnya berbeda.
  • Layar pembayaran harus tetap terbuka. Kalau kasir menutup layar pembayaran sebelum notifikasi masuk, pembayaran itu tidak bisa dikonfirmasi otomatis lagi. Buka ulang dan konfirmasi manual.
  • Batas waktu 15 menit. Notifikasi hanya dicocokkan dengan pembayaran yang dibuka dalam 15 menit terakhir.
  • Teks notifikasi. Aplikasi membaca nominal berformat Rp 45.017. Kalau aplikasi bank kamu memakai format lain, nominal bisa tidak terbaca. Lihat kolom Notification text di QRIS Log, lalu hubungi tim kalcerPOS.

Tanya jawab

Apakah QRIS otomatis juga bekerja di runner, self order dan pre-booking?

Ya. Pembayaran QRIS dari runner, mesin self order dan deposit pre-booking memakai cara pencocokan yang sama.

Apakah HP toko harus HP khusus?

Tidak harus, tetapi HP itu harus menerima notifikasi aplikasi bank/e-wallet penerima QRIS dan tetap menyala selama toko buka. HP cadangan yang selalu dicas di meja kasir biasanya paling aman.

Apakah aplikasi ini bisa melihat saldo atau isi rekening?

Tidak. Aplikasi hanya membaca notifikasi dari aplikasi yang kamu pilih, lalu mengirim nominal dan teks notifikasi itu ke kalcerPOS. Aplikasi tidak bisa membuka aplikasi bank atau melakukan transaksi.