StarQRIS
Dashboard API Docs

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.1 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, pilih metode deteksi bayar saat register QRIS, lalu kelola invoice lewat dashboard web.

QRIS sendiri + App Android (ready)

Upload QRIS merchant Anda. HP baca notifikasi bank / DANA → auto-match. Dana langsung ke rekening QRIS Anda.

QRIS Platform Kiris (ready)

Tanpa upload QRIS & tanpa HP kasir. Pakai QRIS pool StarQRIS → saldo masuk Wallet, withdraw ke rekening Anda (biaya 0,2% per transaksi).

Metode API Gateway (segera hadir)

GoPay Merchant / ShopeePay — deteksi otomatis dari dashboard merchant, tanpa HP. Integrasi tidak resmi.

Yang Anda butuhkan (App Android)
  • 1 HP Android (HP merchant / kasir)
  • App bank merchant atau DANA
  • 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)

  1. 1Daftar akun → login dashboard
  2. 2Menu API Keys → generate key (scope write untuk app) → salin qris_...
  3. 3Menu QRIS → pilih QRIS sendiri (upload + link device) atau QRIS Platform (tanpa upload — lihat QRIS Platform & Wallet)
  4. 4QRIS sendiri: install app StarQRIS di HP → izin notifikasi → Register device. QRIS Platform: lewati langkah HP — langsung ke Wallet setelah aktif.
  5. 5Buat Link Bayar / Invoice → customer bayar nominal exact → cek Transactions (platform: saldo masuk Wallet)

Daftar Akun & API Key

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

  1. 1

    Buat akun merchant

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

  2. 2

    Login dashboard

    Akun baru langsung paket Free. Upgrade dari menu Billing jika butuh limit lebih besar.

  3. 3

    Generate API Key

    Sidebar → API Keys → Generate Key → pilih scope write (wajib untuk app Android & buat invoice) → beri nama (mis. "HP Kasir") → salin key sekarang (hanya muncul sekali).

    Scope read hanya untuk query — tidak bisa register device atau buat invoice. Buat key terpisah per website jika perlu.

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.1 MB

Cara install (sideload)

  1. 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. 2

    Tap file APK → Install

    Tunggu selesai → buka app StarQRIS.

  3. 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 URLhttps://starqris.web.id
Merchant API KeyPaste key qris_... dari dashboard
Device nameNama 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
  • BCA MSB / myBCA / BCA Android (semua varian)
  • DANA
  • BRImerchant / BRImo
  • BNI Merchant

Jika app mati overnight: buka StarQRIS → tap Sync ulang. App auto-reconnect saat HP dinyalakan / layar dibuka.

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.

Tab Request

Daftar invoice pending dari cloud — sama seperti notifikasi Telegram. Berguna jika transfer sudah masuk tapi auto-match belum jalan.

  • Buka tab Request → list invoice pending dimuat otomatis
  • Tap Tandai Bayar setelah konfirmasi transfer benar-benar masuk
  • Webhook ke website tetap terkirim seperti match otomatis

Verifikasi Koneksi

  1. Dashboard → menu Devices
  2. HP Anda muncul dengan nama device yang diisi di app
  3. Status connection: Online (update heartbeat ~2 menit)
  4. 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

1 QRIS per akun StarQRIS (mode QRIS sendiri). Butuh QRIS merchant/rekening lain? Daftar akun baru di starqris.web.id/register. Atau pilih QRIS Platform — tidak perlu upload QRIS sendiri (lihat Wallet).

0. Pilih mode QRIS

QRIS sendiri

Upload QR statis merchant Anda. Wajib HP + app StarQRIS untuk deteksi bayar. Dana masuk rekening QRIS Anda langsung.

QRIS Platform Kiris

Satu klik aktif — tanpa upload. QR menampilkan nama platform. Saldo masuk wallet StarQRIS → withdraw ke rekening Anda.

1. Pilih metode deteksi pembayaran (QRIS sendiri)

App Android StarQRIS

Ready

HP kasir baca notifikasi app bank / DANA. Wajib pilih Linked Device.

API Gateway (unofficial)

Segera hadir

GoPay Merchant / ShopeePay — tanpa HP, polling dari server. Belum bisa disubmit saat ini.

2. Pilih provider (metode App Android)

Bank

BCA (semua varian), Mandiri Livin, BRI, BNI. Centang parser bank yang sesuai di app Android.

DANA

QRIS DANA merchant. Centang parser DANA di app Android → tab Home → Merchant parsers.

3. Upload QRIS statis

Opsi A — Upload gambar

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

Opsi B — Paste string

Copy string EMV (diawali 000201) jika punya.

4. Kode unik per invoice

Pakai kode unik — tambah 1–999 ke nominal agar order dengan harga sama tidak bentrok saat auto-match.

Tanpa kode unik — customer bayar nominal exact (+ biaya QRIS jika ada). Cocok jika nominal produk sudah unik atau hanya satu pending.

Pengaturan per akun QRIS. Plugin/API mengikuti use_unique_code dari GET /qris-accounts.

5. Rekening transfer manual (opsional)

Tambahkan rekening BCA, Mandiri, BRI, BNI, atau bank lain jika ingin menawarkan transfer manual selain QRIS di checkout (WooCommerce, Sejoli, dll.).

Kosongkan jika hanya QRIS — plugin otomatis hanya menampilkan metode QRIS.

Rekening tersedia via API GET /qris-accounts → transfer_accounts. Invoice transfer: payment_method: transfer + transfer_account_index.

6. Biaya QRIS ke customer (opsional)

Gratis — customer bayar nominal + kode unik saja (merchant menyerap biaya QRIS).

Biaya tetap (Rp) — contoh Rp 500 ditambahkan ke setiap invoice.

Biaya persen (%) — contoh 1% dari nominal invoice (sebelum kode unik).

Total di QR dinamis = amount + unique_code + qris_fee. Bisa diubah kapan saja lewat Edit QRIS.

7. Linked Device

Pilih HP StarQRIS yang monitor notifikasi untuk QRIS ini. Wajib untuk metode App Android.

Kartu QRIS di dashboard menampilkan badge metode (mis. App Android · DANA). Hapus entri salah: tombol Hapus.

QRIS Platform & Wallet

Cocok jika Anda belum punya QRIS merchant sendiri atau tidak ingin setup HP kasir. StarQRIS menyediakan QRIS pool (nama Kiris / StarQRIS di QR) — transaksi QRIS gratis untuk customer; merchant menerima saldo di wallet dan bisa withdraw ke rekening bank.

Ringkasan biaya

  • Biaya platform 0,2% dari nominal invoice (amount) — bukan dari kode unik, bukan qris_fee ke customer
  • Tidak ada biaya withdraw flat (mis. Rp 7.500) — hanya potongan 0,2% saat pembayaran masuk
  • Withdraw maksimal 1× per 24 jam — minimum saldo sesuai pengaturan admin (default Rp 50.000)

Aktivasi (merchant)

  1. Dashboard → QRIS → Register QRIS
  2. Pilih QRIS Platform → Aktifkan QRIS Platform
  3. Menu Wallet muncul di sidebar → isi rekening tujuan withdraw
  4. Buat Link Bayar / invoice seperti biasa — QR dinamis tetap di-generate otomatis

Wallet & withdraw

Saldo masuk

Saat customer bayar, wallet dikredit nominal total_amount lalu dipotong biaya platform 0,2% dari amount. Riwayat ada di tab saldo Wallet.

Request withdraw

Isi rekening BCA/Mandiri/BRI/BNI → masukkan nominal → submit. Admin StarQRIS transfer manual → status completed. Jika ditolak, saldo dikembalikan.

Tanpa HP kasir?

Benar — merchant platform tidak perlu install app Android atau link device. Deteksi pembayaran dilakukan di HP collector merchant (dikonfigurasi admin StarQRIS). Invoice Anda tetap auto-match berdasarkan nominal total_amount.

Catatan: Nama merchant di QRIS dinamis mengikuti QR pool (bukan nama toko Anda di EMV). merchant_display_name di dashboard hanya untuk identifikasi internal / notifikasi.

Plugin & API

POST /api/v1/invoices tetap sama — tidak perlu qris_account_id jika mode platform. GET /qris-accounts bisa kosong untuk merchant platform; integrasi cukup buat invoice langsung. Detail: API Docs — QRIS Platform.

Buat Invoice (API / plugin)

Dashboard → Link Bayar → Buat Link Bayar atau via API POST /api/v1/invoices

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.

Bot Telegram Merchant

Dashboard → Telegram Bot — bot milik Anda (bukan bot support admin).

  1. Buat bot di @BotFather → salin token
  2. Cek chat ID via @userinfobot → isi di dashboard
  3. Simpan → klik Daftarkan Webhook → Kirim Test

Notifikasi otomatis

  • Invoice baru → bot kirim total + rincian (nominal / kode unik / biaya QRIS)
  • Pembayaran masuk (app Android sync) → konfirmasi di Telegram

Fallback manual (app macet)

  • Tab Request di app Android → Tandai Bayar
  • Tombol Tandai Dibayar pada notif Telegram
  • Atau ketik /pay INV-XXXX
  • Webhook payment.success tetap terkirim

Perintah: /pending daftar invoice pending · /help bantuan

Cara Kerja Pembayaran

  1. Buat invoice → catat total_amount
  2. Customer scan QRIS dinamis → nominal sudah terisi (total_amount)
  3. StarQRIS deteksi pembayaran masuk (metode sesuai pilihan saat register QRIS)
  4. Invoice otomatis paid jika nominal cocok → notif Telegram (jika aktif)
  5. Webhook ke sistem Anda (jika dikonfigurasi)

Metode App Android (bank / DANA)

Notifikasi masuk di HP → app StarQRIS baca → kirim ke cloud → match nominal.

Metode API Gateway (segera)

Server polling transaksi GoPay / Shopee Merchant → match nominal — tanpa HP kasir.

App Android macet? Tab Request → Tandai Bayar, atau Bot Telegram (/pay INV-XXX). Jangan tandai dibayar jika transfer belum benar-benar masuk.

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 & Multi Website

Dashboard → Webhooks → tambah URL HTTPS publik. StarQRIS kirim event payment.success dengan tanda tangan HMAC-SHA256 saat invoice paid (otomatis dari app Android atau konfirmasi Telegram manual).

Satu akun, banyak website

  • Tambah webhook URL berbeda per toko/website
  • Buat API key terpisah (scope read/write) per integrasi
  • Semua transaksi tetap satu dashboard merchant

Detail payload & verifikasi signature: API Docs

Support Ticket

Dashboard → Support → buat tiket untuk kendala teknis, billing, atau integrasi.

  • Tim admin balas via dashboard — Anda dapat notif email
  • Balasan merchant → admin dapat email & Telegram
  • Butuh bantuan cepat? Widget WhatsApp di halaman publik

Billing & Plan

Menu Billing — plan aktif, limit device/transaksi/bulan, upgrade ke Starter/Pro. Akun baru langsung paket Free.

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 / app macet overnight

Buka app → tap Sync ulang. Cek Notification Access, parser bank, Debug Mode mati. Jika transfer sudah masuk tapi belum sync → konfirmasi via Bot Telegram (/pay INV-XXX).

Nominal salah terbaca (BCA / Financial Diary)

Update app ke versi terbaru dari menu Download App. Pastikan parser BCA sesuai app yang dipakai. Cek tab History. Buat tiket Support jika masih salah.

Webhook tidak terpanggil

URL harus HTTPS publik. Verifikasi signature HMAC di plugin. Cek menu Webhooks — status delivery. Konfirmasi manual via Telegram juga memicu webhook yang sama.

Checklist Siap Operasional

  • Akun StarQRIS + API Key write disalin
  • QRIS aktif: sendiri (upload + device) ATAU Platform (Wallet + rekening withdraw)
  • QRIS sendiri: app StarQRIS + Notification Access + device Online
  • QRIS Platform: Wallet → rekening tujuan withdraw terisi
  • Webhook URL ditambah (jika pakai plugin/website)
  • Bot Telegram di-setup (opsional, disarankan)
  • Invoice test → bayar → cek Transactions (+ saldo Wallet jika platform)

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