Cara Bayar di Kiosk
QRIS, voucher, dan tunai. Termasuk cara baca total, masa berlaku QR, dan apa yang terjadi saat reload.
6 menit · 4 bagian · 11 langkah
Perlu disiapkan
- Paket sudah dipilih dan order summary tampil.
Ringkasan
Kiosk mendukung QRIS via gateway merchant owner: Pakasir, Midtrans, atau Tripay. Dana masuk langsung ke rekening owner, bukan ke perantara. Kiosk menampilkan metode dari credential direct aktif: QRIS, VA, dan metode redirect yang didukung adapter.
Bila booth belum mengaktifkan credential gateway, kiosk hanya menawarkan voucher dan tunai. Ini normal dan bukan error. Semua nominal Rupiah integer. Backend menghitung ulang total, frontend tidak pernah dipercaya untuk harga.
Bayar dengan QRIS
Setelah tekan Bayar dengan QRIS, backend membuat transaksi provider lalu menampilkan QR beserta total yang harus dibayar. Untuk Pakasir v2: POST create transaction dengan header X Api Key, response berisi order id, txn id, amount, total payment (amount plus fee), qr string, dan expired at. Tampilkan total payment ke pembeli, bukan nominal dasar.
Verifikasi memakai webhook plus polling. Webhook Pakasir memakai header X Secret lalu status server to server sebelum paid. Kiosk polling tiap 3 detik. Satu booth hanya punya satu QR hidup: checkout baru menghanguskan checkout open plus payment creating atau pending sebelumnya. Payment pending yang masih hidup dicek dulu ke provider: bila ternyata sudah dibayar maka transisi paid, bukan di void. QR yang sudah di void tapi tetap dibayar tetap diakui paid bila amount valid.
- 1
Tekan Bayar dengan QRIS.
- 2
Scan kode dan bayar sebesar total yang tampil termasuk kode unik.
- 3
Perhatikan timer kedaluwarsa di bawah QR. Default 3 menit, rentang setting 1 sampai 60 menit. Efektif memakai yang tercepat antara setting booth dan provider.
- 4
Tunggu status paid. Jangan tutup halaman.
- 5
Jika reload atau putus: status dipulihkan dari server via payment reference.
| Provider | Metode kiosk | Verifikasi webhook |
|---|---|---|
| Pakasir | QRIS dinamis plus kode unik | Header X Secret plus status server to server |
| Midtrans | QRIS, GoPay, ShopeePay, VA | SHA512 order id plus status code plus gross amount plus server key |
| Tripay | QRIS, VA, gerai retail | HMAC SHA256 raw body via private key |
Pakai voucher
Masukkan kode huruf besar lalu Apply. Valid menampilkan voucher applied plus diskon. Invalid menampilkan invalid atau expired.
Validasi server: voucher ada, business cocok, active true, tanggal berlaku, usage limit total, usage per customer, min transaction, max discount, package eligibility, outlet eligibility. Voucher 100 persen membuat payment paid sintetik tanpa gateway. Voucher parsial kembali ke method picker untuk sisa.
- 1
Masukkan kode voucher, tekan Apply.
- 2
Periksa diskon dan total akhir.
- 3
Lunasi sisa bila voucher parsial.
Bayar tunai
Pilih Tunai dan serahkan uang ke operator. Kiosk membuat payment pending yang menunggu konfirmasi operator terautentikasi. Customer tidak bisa self confirm. Hanya operator dengan sesi login plus membership payment confirm yang bisa mengonfirmasi.
Transaksi tunai tercatat untuk reporting tetapi tidak mengkredit saldo owner. Saldo hanya dari QRIS. Nominal final dihitung server (gross minus diskon) dan tidak bisa dimanipulasi dari browser.
- 1
Pilih Tunai.
- 2
Serahkan uang ke operator.
- 3
Tunggu operator konfirmasi sampai status paid.
Troubleshooting
| Gejala | Penyebab | Solusi |
|---|---|---|
| QRIS tidak tampil | Koneksi putus atau tanpa credential aktif | Cek internet kiosk, reload (status dipulihkan otomatis), atau pakai tunai lalu catat manual. |
| Sudah bayar tapi pending | Webhook tertunda | Tunggu polling dan webhook. Jangan buat QR baru bila QR masih hidup. |
| QR expired | Melewati expiry provider atau setting | Buat payment baru. Jangan reuse transaksi lama bila provider mensyaratkan baru. |
| RATE_LIMITED 429 | Tombol bayar ditekan berulang | Ikuti retry after di response, kunci tombol sampai waktu habis. |
Langkah berikutnya
- Owner: Atur QRIS dan Credential: Aktifkan gateway merchant.
- Alur Foto Customer: Lanjut setelah paid.
- Hasil Foto Online: Unduh setelah finalize.