Top up dan saldo
QRIS, saldo prabayar, dan bagaimana saldo terpakai.
Ringkasan
Saldo NusaRouter itu saldo prabayar dalam Rupiah. Setiap request dipotong dari saldo itu, dan request yang tidak bisa ditanggung saldo ditolak sebelum dikirim ke model.
Karena prabayar, tidak ada tagihan di akhir bulan dan tidak ada kejutan setelah pemakaian. Batas belanja kamu saldo yang sudah ada di akun.
Cara top up
Buka halaman Top up, pilih nominal, lalu bayar QRIS-nya dengan aplikasi bank atau e-wallet-mu.
Daftar metode pembayaran yang muncul di halaman itu dibaca langsung dari penyedia. Kanal yang dimatikan NusaRouter di sisi penyedia berhenti ditawarkan tanpa perlu ada perubahan di sini.
Nominal dan kode kanal dikirim oleh halaman itu sebagai string, bukan angka JSON. Angka JSON itu float, dan float tidak boleh menyentuh nilai uang: nominal yang berbentuk angka ditolak, bukan dibulatkan diam-diam. Kamu tidak perlu menyusun request ini sendiri: cukup pilih nominal dan kanal di halaman Top up.
Nominal minimum
Ada dua batas bawah, dan yang lebih tinggi yang berlaku.
- Minimum platform: ditetapkan NusaRouter, ditampilkan di halaman Top up, dan dibaca dari server, bukan ditulis di dokumentasi ini. Kalau NusaRouter mengubahnya, halaman itu ikut berubah.
- Minimum kanal: ditetapkan penyedia pembayaran, berbeda per kanal, dan dibaca langsung dari penyedia.
Biaya kanal
Sebagian kanal membebankan biaya administrasi, dan siapa yang menanggungnya berbeda per kanal. Informasinya ikut di respons daftar kanal, jadi halaman Top up bisa memberi tahu kamu total yang akan dibayar sebelum QR muncul.
Biaya kanal bukan pendapatan NusaRouter dan tidak menambah saldomu. Kalau kanal membebankan biaya ke pelanggan, yang kamu bayar nominal ditambah biaya itu, sementara saldo yang masuk tetap sebesar nominalnya.
Kapan saldo bertambah
Saldo bertambah hanya setelah penyedia pembayaran mengonfirmasi pembayarannya.
Membuat pembayaran tidak mengkreditkan apa pun. Pembayaran yang baru dibuat berstatus pending, dan hanya konfirmasi terverifikasi dari penyedia yang menyelesaikannya.
Konsekuensi praktisnya: kalau kamu menutup halaman setelah QR muncul, tidak ada yang hilang. Pembayarannya tetap ada dan bisa dibuka lagi. Dan pembayaran yang tidak pernah kamu selesaikan tidak pernah menggerakkan saldo.
Bagaimana saldo terpakai
Setiap request menempuh urutan yang sama, dan urutannya itu yang membuat saldo tidak pernah minus.
- Batas laju dan tingkat akses diperiksa.
- Estimasi biaya maksimum ditahan dari saldomu.
- Request baru dikirim ke model.
- Biaya pemakaian sebenarnya dihitung, dan sisa yang ditahan dikembalikan. Kalau pemakaian melebihi estimasi, tagihan menyesuaikan naik — sampai maksimum 3× estimasi, dan tidak pernah melebihi saldomu.
Dua hal yang penting dari urutan itu. Pertama, request yang tidak bisa ditanggung saldo ditolak dengan 402 sebelum dikirim ke model, jadi tidak ada request yang jalan lalu gagal ditagih. Kedua, request yang gagal tidak selalu gratis: kalau ada pemakaian yang tercatat, NusaRouter tetap menagihkan token yang sudah diproses, dan kalau tidak ada pemakaian yang tercatat, seluruh penahananmu dilepas. Lihat Chat completions.
Tarifnya diambil saat request dimulai. Perubahan harga di tengah request tidak bisa mengubah biaya request yang sedang jalan.
Catatan transaksi
Halaman Transaksi menampilkan riwayat pergerakan saldomu. Catatan ini tidak pernah diubah atau dihapus, jadi barisnya tetap sama setelah dicatat.
Setiap baris punya tiga kolom uang. Ketiganya mengukur hal yang berbeda, dan satu baris biasanya hanya menggerakkan sebagian dari ketiganya:
- Total berubah: yang bergerak di keseluruhan saldomu, tersedia ditambah yang ditahan. Saat uang hanya berpindah dari tersedia ke ditahan, kolom ini nol: jumlahnya tidak berubah, hanya tempatnya.
- Ditahan berubah: yang bergerak di bagian saldo yang sedang ditahan untuk request yang masih berjalan. Uangnya masih milikmu, hanya belum bisa dibelanjakan.
- Saldo berubah: yang bergerak di saldo yang bisa kamu belanjakan. Ini kolom yang menjawab berapa uang yang benar-benar bisa kamu pakai, dan biaya request muncul di sini sebagai angka negatif.
Contohnya begini. Saat request dimulai, biaya maksimumnya ditahan: Saldo berubah negatif, Ditahan berubah positif, dan Total berubah nol. Saat request selesai, biaya sebenarnya dipotong dan sisanya dilepas: Ditahan berubah negatif, dan Saldo berubah naik sebesar sisa itu.
Saldo rendah
Ada ambang batas saldo rendah yang ditetapkan NusaRouter. Di bawah ambang itu konsol menandai akunmu, dan kamu bisa mengaktifkan notifikasi saldo rendah dari halaman Pengaturan. Ambangnya ditampilkan di konsol, bukan di halaman ini. Sama seperti minimum top up, angkanya konfigurasi yang bisa berubah.
Troubleshooting
| Gejala | Penyebab | Solusi |
|---|---|---|
402 insufficient_balance | Saldo dompet tidak cukup untuk menanggung request. | top up QRIS, lalu ulangi; cek juga tidak ada penahanan lain yang menyita saldo |
402 spending_limit_exceeded | Saldo dompet cukup, tapi batas belanja key ini sudah terpakai habis. | naikkan atau kosongkan batas key di halaman API key; lihat Batas pengeluaran key |
| Saldo belum bertambah setelah membayar | Konfirmasi dari penyedia belum diterima server. | tunggu sebentar, muat ulang halaman Transaksi; kalau tetap kosong, hubungi kami dengan referensinya |
| QR tidak muncul | Metode pembayaran tidak tersedia, atau penyedia sedang bermasalah. | muat ulang halaman Top up; kalau tetap gagal, coba kanal lain |