Panduan Pengguna & Dokumentasi Fitur EBayar
EBayar adalah aplikasi Android revolusioner yang dirancang khusus untuk para pelaku usaha (Merchant) guna mempermudah pengelolaan pembayaran QRIS. Aplikasi ini berfungsi sebagai Payment Gateway Pribadi secara real-time.
1. Fitur Utama Aplikasi EBayar
A. Deteksi Pembayaran Otomatis (Auto-Detection)
Aplikasi EBayar secara pintar membaca notifikasi pembayaran yang masuk ke HP Anda dari lebih dari 30+ aplikasi perbankan dan e-wallet.
- E-Wallet & Merchant: GoPay Merchant, Shopee Partner, OVO Merchant, DANA Bisnis, LinkAja Mitra.
- Mobile Banking: BCA Mobile, myBCA, Livin' by Mandiri, BRImo, BNI Mobile, BSI Mobile, Octo Mobile, dll.
- Bank Digital & BPD: Jago, SeaBank, blu, Bank Jateng, Bank DKI, BJB, dll.
B. Generator QRIS Dinamis & Kode Unik
EBayar dapat mengubah QRIS Statis menjadi QRIS Dinamis (QRIS dengan nominal yang sudah ditentukan).
- Nominal Unik Anti-Tabrakan: Sistem akan menambahkan angka unik (misal: +Rp 142) pada setiap transaksi agar Anda tahu persis pelanggan mana yang sudah membayar.
- Otomatis Terisi: Pembeli yang memindai QRIS tersebut tidak perlu lagi mengetikkan nominal secara manual, mengurangi risiko kurang bayar.
C. Integrasi Webhook (Penerus Data)
Webhook berfungsi sebagai jembatan antara aplikasi EBayar di HP Anda dengan Database atau Website kasir Anda.
- Keamanan Berlapis (MD5 Hash): Dilengkapi dengan rahasia (Secret Code) untuk memastikan keaslian transaksi.
- Auto-Retry: Jika server Anda sedang mati, aplikasi akan menyimpannya sebagai log gagal dan Anda bisa melakukan "Kirim Ulang".
D. Notifikasi Suara (Text-to-Speech)
Tidak perlu bolak-balik mengecek layar HP! Setiap kali ada pembayaran berhasil, HP Anda akan bersuara, "Pembayaran sebesar sepuluh ribu rupiah berhasil diterima".
2. Pengaturan Awal (Wajib Dilakukan)
Saat pertama kali membuka aplikasi, ada beberapa langkah yang harus dilakukan agar aplikasi bisa berjalan normal:
- Izinkan Akses Notifikasi: Di halaman Pengaturan, jika muncul kotak merah peringatan, klik Buka Pengaturan. Cari aplikasi EBayar di menu Android, lalu aktifkan Allow Notification Access.
- Atur Aplikasi Pantau: Masuk ke menu Pengaturan > Aplikasi Pantau. Centang bank atau e-wallet apa saja yang biasa Anda gunakan.
- Konfigurasi Webhook (Opsional): Di menu Pengaturan, masuk ke bagian Webhook Aktif dan klik tombol (+). Masukkan URL server Anda dan Secret Code.
Agar sistem Android tidak mematikan EBayar saat layar HP mati, masuk ke
Pengaturan HP > Aplikasi > EBayar > Baterai dan pilih opsi Tidak Dibatasi (Unrestricted).3. Cara Membuat QRIS Dinamis
Jika pelanggan ingin membayar tanpa perlu repot mengetik nominal secara manual:
- Masuk ke tab QRIS (Ikon QR Code di tengah bawah).
- Scan kode QRIS Statis toko Anda (atau impor dari Galeri). Langkah ini hanya perlu dilakukan sekali.
- Masukkan Nominal Dasar belanja (misal: 10.000).
- Klik tombol Generate / Buat QRIS Dinamis.
- Sistem akan menambahkan angka unik dan menampilkan QR Code baru (misal: 10.123) untuk di-scan oleh pelanggan.
4. Cara Mengecek Laporan dan Mencetak Ekspor
Aplikasi menyediakan menu Dashboard (History) untuk melihat seluruh riwayat uang masuk dan mengekspornya.
- Masuk ke tab Dashboard (Ikon grafik di pojok kiri bawah).
- Di bagian atas, klik tombol Filter Tanggal untuk memilih rentang waktu spesifik.
- Gunakan kolom pencarian untuk mencari nama spesifik pelanggan (contoh: "Budi").
- Untuk mengekspor, klik tombol Unduh/Export (Ikon Panah ke Bawah) di pojok kanan atas.
- Pilih format PDF, CSV (Excel), HTML, atau TXT. Sistem akan membuatkan laporan berlogo EBayar.
5. Panduan & Pengaturan EBayar Speaker (Companion App)
EBayar Speaker adalah aplikasi pendamping nirkabel (Companion App yang terdapat pada folder ebayar_speaker) yang memungkinkan Anda mengubah HP Android bekas, tablet toko, atau Android TV Box menjadi Pengeras Suara Pintar (Hardware-Free Soundbox) tanpa perlu membeli hardware fisik seharga jutaan rupiah.
A. Cara Pairing EBayar Speaker (QR Code Base64)
- Buka aplikasi EBayar Utama di HP Kasir Anda.
- Masuk ke menu Pengaturan > Kelola Speaker. Aplikasi akan menampilkan kode QR Pairing ter-encode Base64 yang aman.
- Buka aplikasi EBayar Speaker di HP bekas / Android TV Box toko Anda.
- Tekan tombol pindaian kamera pada EBayar Speaker, lalu arahkan ke QR Code di layar HP Kasir Utama.
- Setelah berhasil, kartu speaker di HP Kasir Utama akan menampilkan indikator status real-time 🟢 Online atau 🟢 Online (Cloud).
B. Pengaturan Suara Pria & Wanita (Hybrid Dual-Engine TTS)
EBayar Speaker dilengkapi dengan teknologi Hybrid Dual-Engine TTS yang dapat menyesuaikan diri dengan spesifikasi perangkat Android Anda:
- Pilihan Gender Suara: Pilih varian suara Wanita (nada tinggi feminin) atau Pria (nada ngebas mantap).
- Offline & Online Fallback: Pada HP fisik, aplikasi menggunakan mesin offline Google TTS. Pada Android TV Box / Emulator yang tidak memiliki mesin TTS, aplikasi secara otomatis beralih ke Online Voice Stream MP3 dengan modulasi nada (pitch modulation).
- Indikator Tombol OFF & Safety Guard: Saat menekan tombol suara Pria/Wanita, tes suara langsung berbunyi dan tombol secara otomatis dikunci (OFF/redup) dengan status
🔊 Wanita.../🔊 Pria.... Tombol dipastikan 100% kembali aktif (ON) setelah pengumuman selesai via pengaman batas waktu (Timeout Safety Guard).
C. Manfaat Operasional Toko
- Bebas Biaya Hardware: Memanfaatkan HP Android lama atau Android Box toko Anda sendiri.
- Pengumuman Lintas Ruangan: Tempatkan EBayar Speaker di area dapur resto, kasir luar, atau area penyiapan pesanan agar koki & karyawan langsung mendengar konfirmasi pembayaran tanpa harus melihat HP kasir.
6. Mengatasi Kendala (Troubleshooting)
| Gejala / Masalah | Penyebab & Solusi |
|---|---|
| Mutasi tidak muncul di EBayar | Izin integrasi lokal mati. Buka Pengaturan Android > Notification Access, matikan EBayar lalu nyalakan kembali. Pastikan juga notifikasi aplikasi bank aslinya muncul di bar HP. |
| HP / EBayar Speaker tidak bersuara saat ada yang bayar | Pastikan volume Media HP / Speaker tidak di-mute. Cek menu Pengaturan EBayar dan pastikan fitur TTS menyala hijau/oranye. Jika menggunakan EBayar Speaker, pastikan indikator berstatus 🟢 Online. |
| EBayar Speaker Berstatus Offline (Grey Badge) | Pastikan kedua perangkat terhubung ke Wi-Fi yang sama atau jaringan internet aktif, lalu lakukan pairing ulang via QR Code Base64 di menu Kelola Speaker. |
| Webhook gagal terkirim (Status 500 / 400) | URL Endpoint salah atau terdapat error pada kode (script) PHP Anda. Masuk ke menu Webhook Aktif > Lihat Log untuk detail penyebabnya. |
| EBayar Mati Sendiri | Ubah pengaturan baterai EBayar menjadi Unrestricted (Tidak Dibatasi) di pengaturan HP, lalu kunci (lock/pin) aplikasi EBayar di layar "Recent Apps". |