BisaTopup (PPOB)

Kalau Anda juga berjualan pulsa, token listrik, atau pembayaran tagihan lewat aplikasi BisaTopup, transaksinya bisa masuk otomatis ke Bisakasir. Tidak perlu mencatat ulang satu per satu — omzet dan labanya langsung ikut terhitung di laporan.

Hanya Pemilik

Menu ini cuma muncul untuk akun Pemilik. Manager dan kasir tidak bisa membukanya.

Yang tercatat otomatis

Kejadian di BisaTopup	Yang muncul di Bisakasir
Transaksi PPOB berhasil (pulsa, token listrik, tagihan)	Penjualan berstatus lunas, pembayaran tunai
Topup saldo BisaTopup	Pengeluaran kas kategori Topup Saldo Bisatopup

Laba dihitung otomatis dari selisih harga jual ke pelanggan dan harga modal yang dikirim BisaTopup. Jadi laporan laba-rugi Anda sudah benar tanpa input manual.

Catatan

Produk PPOB tidak masuk ke daftar produk dan tidak memotong stok. Ia dicatat sebagai item penjualan langsung, jadi tidak mengacaukan data persediaan Anda.

Membuka halaman

Tab Lainnya → Pengaturan → BisaTopup (PPOB) (Catat transaksi pulsa & tagihan otomatis).

Di bagian atas ada keterangan: “Transaksi pulsa, token listrik, dan tagihan di aplikasi BisaTopup otomatis tercatat sebagai penjualan di outlet yang dipilih. Topup saldo tercatat sebagai pengeluaran kas.”

Menghubungkan akun dengan kode QR

Cara tercepat, dan Anda tidak perlu mengetik apa pun.

1. Buka Pengaturan → BisaTopup (PPOB).
2. Di kartu Outlet Tujuan, ketuk dan pilih outlet dari daftar Pilih Outlet. Semua transaksi PPOB dan topup saldo dicatat ke outlet ini.
3. Tekan Tampilkan Kode QR.
4. Di ponsel lain (atau ponsel yang sama), buka aplikasi BisaTopup → Hubungkan ke Bisakasir → pindai kode QR yang muncul.
5. Begitu terpindai, layar Bisakasir menutup sendiri dan muncul notifikasi “Akun BisaTopup berhasil dihubungkan”.

Kode berlaku 10 menit — sisa waktunya terlihat di bawah QR (Berlaku 09:58). Kalau habis, tekan Buat Kode Baru.

Di bawah QR ada juga kode 8 karakter (contoh: ABCD 2345). Ketik itu di aplikasi BisaTopup kalau kameranya bermasalah.

Pilih outlet dulu

Tombol Tampilkan Kode QR menolak jalan sebelum outlet dipilih, dengan pesan “Pilih outlet tujuan terlebih dahulu”. Kode QR-nya sendiri sudah membawa informasi outlet, jadi Bisakasir perlu tahu lebih dulu ke mana transaksinya dibukukan.

Aplikasi BisaTopup akan menyebut nama toko Anda

Setelah memindai, aplikasi BisaTopup menampilkan nama toko Bisakasir yang baru terhubung. Pastikan itu memang toko Anda — kalau bukan, Anda salah memindai QR milik orang lain.

Menghubungkan akun secara manual

Pakai cara ini kalau kamera bermasalah dan Anda sudah tahu ID akun BisaTopup Anda.

1. Isi ID Akun BisaTopup — kode akun Anda di aplikasi BisaTopup, contoh formatnya BTU-XXXXXX. Wajib diisi; kalau kosong muncul pesan “ID Akun BisaTopup wajib diisi”.
2. Pastikan Outlet Tujuan sudah dipilih.
3. Nyalakan sakelar Aktifkan Integrasi. Saat nonaktif, transaksi BisaTopup tidak dicatat.
4. Tekan Simpan. Muncul notifikasi “Pengaturan integrasi disimpan”.
5. Salin URL Webhook dan Kunci Rahasia yang muncul, lalu tempel di aplikasi BisaTopup.

Outlet wajib dipilih dulu

Kalau Anda menyalakan sakelar tanpa memilih outlet, penyimpanan ditolak dengan pesan “Pilih outlet tujuan terlebih dahulu”. Bisakasir perlu tahu outlet mana yang membukukan transaksinya.

Kredensial Webhook

Setelah akun terhubung, muncul kartu Kredensial Webhook: “Tempel kedua nilai ini di pengaturan integrasi aplikasi BisaTopup.” Kalau Anda menghubungkan lewat kode QR, kedua nilai ini sudah otomatis terpasang di aplikasi BisaTopup — bagian ini hanya untuk rujukan.

• URL Webhook — alamat tujuan pengiriman data dari BisaTopup.
• Kunci Rahasia — kunci pengaman agar hanya BisaTopup yang bisa mengirim data ke toko Anda.

Ketuk salah satu nilai untuk menyalinnya; muncul notifikasi “URL Webhook disalin” atau “Kunci Rahasia disalin”. Tempelkan keduanya di pengaturan integrasi aplikasi BisaTopup.

Kunci rahasia hanya tampil sekali

Tepat setelah kunci dibuat, muncul peringatan: “Salin kunci ini sekarang. Setelah halaman ditutup, kunci tidak bisa dilihat lagi — hanya bisa diganti dengan yang baru.”

Setelah itu kunci ditampilkan tersamar (contoh ****beef) dengan keterangan “Kunci hanya ditampilkan sekali saat dibuat.” Simpan kunci Anda di tempat aman.

Mengganti kunci rahasia

Kalau kunci hilang atau Anda curiga bocor, tekan Ganti Kunci Rahasia di bagian bawah kartu. Muncul konfirmasi Ganti Kunci Rahasia? dengan keterangan:

“Kunci lama langsung berhenti berlaku. Transaksi BisaTopup tidak akan tercatat sampai kunci baru dipasang di aplikasi BisaTopup.”

Pilih Ganti untuk lanjut atau Batal untuk membatalkan. Setelah diganti, kunci baru tampil sekali — segera salin dan pasang di aplikasi BisaTopup.

Melihat hasilnya

Transaksi PPOB yang masuk diberi label BisaTopup di Riwayat Transaksi, jadi mudah dibedakan dari penjualan kasir biasa.

Di Laporan Transaksi, filter Channel punya pilihan BisaTopup — pakai untuk melihat omzet PPOB saja, terpisah dari penjualan toko.

Pengeluaran topup saldo muncul di Arus Kas dengan kategori Topup Saldo Bisatopup.

Kalau transaksi tidak masuk

Periksa berurutan:

1. Sakelar Aktifkan Integrasi menyala? Saat nonaktif, transaksi BisaTopup tidak dicatat sama sekali.
2. ID Akun BisaTopup benar? Harus persis sama dengan yang ada di aplikasi BisaTopup.
3. Kunci rahasia di BisaTopup masih yang terbaru? Kalau Anda baru menekan Ganti Kunci Rahasia tapi belum memasang kunci barunya di BisaTopup, semua transaksi ditolak. Cara termudah memperbaikinya: hubungkan ulang lewat kode QR.
4. Outlet tujuan sudah dipilih? Tanpa outlet, transaksi tidak punya tempat untuk dibukukan.

Transaksi yang gagal terkirim akan dicoba ulang oleh BisaTopup, dan pengiriman ganda tidak membuat catatan dobel — satu transaksi di BisaTopup selalu jadi satu penjualan di Bisakasir.

Untuk tim teknis

Rincian format webhook, cara menghitung tanda tangan, dan aturan percobaan ulang ada di docs/bisatopup-integration-guide.md di repositori Bisakasir.