Panduan Merchant — StarQRIS

StarQRIS Bridge (Android)

App bridge untuk membaca notifikasi pembayaran QRIS dari app bank merchant di HP kasir.

Android 8.0+ · Mandiri, BCA, DANA, BRI, BNI
Setelah install: API URL = https://starqris.web.id

Download APK starqris.apk · 13 MB

Halaman download khusus: https://starqris.web.id/download/android — bagikan link ini ke HP kasir.

Pengenalan

StarQRIS adalah layanan SaaS bridge pembayaran QRIS — daftarkan QR statis merchant, generate QR dinamis per invoice. Anda tidak perlu install server — cukup daftar akun, install app Android di HP merchant, lalu kelola invoice lewat dashboard web.

Yang Anda butuhkan

1 HP Android (HP merchant / kasir)
App bank merchant (Mandiri, BCA, DANA, BRI, BNI)
App StarQRIS (bridge notifikasi)
Akses internet (WiFi / data)

Dashboard StarQRIS

https://starqris.web.id

URL ini juga diisi di app sebagai API URL.

Daftarkan QRIS statis merchant (template). StarQRIS generate QR dinamis per invoice dengan nominal total_amount sudah terisi (mis. Rp 50.061 = Rp 50.000 + kode 61).

Mulai Cepat (5 menit)

1Daftar akun → login dashboard
2Menu API Keys → generate key → salin qris_...
3Install app StarQRIS di HP → izin notifikasi → isi API URL + key → Register
4Menu QRIS → register QRIS (upload foto QR atau paste string)
5Buat Invoice → customer bayar nominal exact → cek Transactions

Daftar Akun & API Key

Semua dilakukan di browser — tidak perlu install apapun di komputer.

1

Buat akun merchant

Buka https://starqris.web.id/register → isi nama toko, email, password.
2

Login dashboard

Akun baru mendapat trial plan Starter 14 hari (menu Billing).
3

Generate API Key

Sidebar → API Keys → Generate Key → beri nama (mis. "HP Kasir") → salin key sekarang (hanya muncul sekali). Key ini dipakai di app Android.

Install App Android StarQRIS

Persyaratan HP

Android 8.0 (Oreo) atau lebih baru
App bank merchant sudah terinstall & login (yang terima notifikasi QRIS masuk)
Koneksi internet stabil
Disarankan: HP khusus kasir, dicas, tidak mode hemat baterai agresif

StarQRIS Bridge (Android)

App bridge untuk membaca notifikasi pembayaran QRIS dari app bank merchant di HP kasir.

Download APK starqris.apk · 13 MB

Cara install (sideload)

1

Aktifkan "Install dari sumber tidak dikenal"

Saat buka file APK, Android akan minta izin. Atau: Pengaturan → Keamanan → Install app unknown sources (nama menu beda-beda per merek HP).
2

Tap file APK → Install

Tunggu selesai → buka app StarQRIS.
3

Izinkan notifikasi post (Android 13+)

Jika diminta, tap Allow untuk notification permission biasa.

Setup App (langkah demi langkah)

Buka app StarQRIS → tab Home. Ikuti urutan section dari atas ke bawah.

① Notification Access

Tap Grant access → Android buka pengaturan → aktifkan StarQRIS di daftar "Notification access".

Wajib. Tanpa ini app tidak bisa baca notifikasi pembayaran dari app bank.

② Monitoring (QRIS Hook Active)

Nyalakan toggle Monitoring. Status harus: "Listening for QRIS payment notifications."

③ Battery optimization

Tap Allow unrestricted agar Android tidak matikan app di background. Penting supaya device tetap Online di dashboard.

④ SaaS Bridge

Hubungkan HP ke akun StarQRIS Anda:

API URL	`https://starqris.web.id`
Merchant API Key	Paste key `qris_...` dari dashboard
Device name	Nama bebas, mis. HP Kasir Utama

Tap Save → lalu Register. Chip Connected muncul jika sukses.

Untuk SaaS production pakai URL HTTPS di atas. Jangan pakai 127.0.0.1 kecuali testing lokal.

⑤ Merchant parsers

Centang app bank yang menerima notifikasi QRIS di HP ini:

Mandiri Livin Merchant
Merchant BCA
DANA
BRImerchant / BRImo
BNI Merchant

Tab Debug — jangan dipakai saat operasional. Debug Mode hanya untuk uji parser; pembayaran tidak dikirim ke StarQRIS backend.

Tab History

Lihat log event lokal di HP (pending, sent, failed). Untuk status resmi invoice, cek dashboard web → Transactions.

Verifikasi Koneksi

Dashboard → menu Devices
HP Anda muncul dengan nama device yang diisi di app
Status connection: Online (update heartbeat ~2 menit)
Connection Warning: app mungkin di background kill — buka app, cek battery unrestricted

Saat register QRIS, pilih Linked Device = HP ini agar mudah dilacak.

Register QRIS Statis

Dashboard → QRIS → Register QRIS

Opsi A — Upload gambar

Screenshot QRIS dari app bank / foto sticker. Max 5MB. String terisi otomatis.

Opsi B — Paste string

Copy string EMV (diawali 000201) jika punya.

Hapus entri salah: tombol Hapus di kartu QRIS.

Buat Invoice

Dashboard → Invoices → Create Invoice

Contoh: Amount Rp 50.000 + kode 61 → API mengembalikan QR dinamis dengan nominal Rp 50.061 sudah terisi.

Nominal harus exact. Invoice expired (default 24 jam) tidak ikut matching.

Cara Kerja Pembayaran

Buat invoice → catat total_amount
Customer scan QRIS dinamis → nominal sudah terisi (total_amount)
Notifikasi masuk app bank di HP → StarQRIS baca & kirim ke cloud
Invoice otomatis paid jika nominal cocok
Webhook ke sistem Anda (jika dikonfigurasi)

Jika 2+ invoice punya total sama → status ambiguous, resolve manual di Transactions.

Menu Transactions

Paid Match sukses

Failed Tidak ada invoice cocok

Ambiguous Pilih invoice manual di detail

Webhooks (opsional)

Dashboard → Webhooks → tambah URL HTTPS. StarQRIS kirim payment.success saat invoice paid. Detail: API Docs.

Billing & Plan

Menu Billing — plan aktif, limit device/transaksi, upgrade. Trial Starter 14 hari untuk akun baru.

Troubleshooting

App tidak Connected / Register gagal

Cek API URL = https://starqris.web.id, API Key benar, HP online. Tap Save lalu Register ulang.

Device Offline di dashboard

Buka app StarQRIS, aktifkan Monitoring, izinkan battery unrestricted, jangan force-close app.

Pembayaran tidak masuk

Notification Access aktif? Parser bank benar? Debug Mode mati? Nominal transfer exact?

Nominal salah terbaca

Pastikan parser bank sesuai. Cek tab History di app. Laporkan ke support dengan screenshot notifikasi bank.

Checklist Siap Operasional

Akun StarQRIS + API Key disalin
App StarQRIS terinstall di HP merchant
Notification Access + Battery unrestricted
SaaS Bridge Connected (Register sukses)
Monitoring aktif, parser bank dipilih
Device Online di dashboard
QRIS statis terdaftar (template merchant)
Invoice test → QR dinamis muncul → bayar via scan

Untuk Developer (self-host)

Bagian ini hanya jika Anda menjalankan StarQRIS sendiri, bukan pakai layanan cloud.

Tampilkan instalasi backend & build APK

cd backend && composer install && cp .env.example .env
php artisan key:generate && php artisan migrate && php artisan db:seed
php artisan serve --host=0.0.0.0 --port=8000

Testing LAN: API URL di app = http://IP_KOMPUTER:8000

cd android && ./gradlew assembleDebug
# Salin ke public/downloads/starqris.apk untuk enable download di tutorial

API reference: https://starqris.web.id/docs/api