Lewati ke isi dokumentasi
Top up dan saldo

Top up dan saldo

Pembayaran, saldo prabayar, dan bagaimana saldo terpakai.

Panduan produk9 bagianAPI v1
Di halaman ini9 bagian

Ringkasan#

Saldo MenvoraRouter 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, masukkan nominal, pilih kanal pembayaran, lalu selesaikan pembayarannya.

Kanal yang muncul adalah yang sedang aktif di penyedia: bisa QRIS, bisa nomor virtual account, dan bisa kanal lain yang penyedia sediakan. Daftarnya dibaca langsung dari penyedia, jadi kanal yang dimatikan 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.

Kalau pembayaran otomatis sedang dimatikan, halaman itu berganti ke mode manual: tidak ada kanal untuk dipilih, melainkan QR statis milik admin, nomor WhatsApp untuk konfirmasi, dan referensi pembayaran yang harus kamu sebutkan. Saldo tetap baru masuk setelah admin mencocokkan transfernya.

Nominal minimum#

Ada dua batas bawah, dan yang lebih tinggi yang berlaku.

  • Minimum platform: ditetapkan MenvoraRouter, ditampilkan di halaman Top up, dan dibaca dari server, bukan ditulis di dokumentasi ini. Kalau MenvoraRouter 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. Baris kanal hanya menyebut batas minimum dan maksimumnya; biaya baru terlihat di panel pembayaran, sebagai dua angka yang berdampingan.

Yang harus kamu bayar adalah angka yang didebit penyedia: nominal, ditambah biaya kalau kanal membebankannya ke kamu. Masuk ke saldomu tetap sebesar nominalnya. Selisih kedua angka itu adalah biayanya, bukan saldo yang hilang.

Biaya kanal bukan pendapatan MenvoraRouter dan tidak menambah saldomu.

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.

Status yang mungkin kamu lihat di riwayat pembayaran:

  • pending: sudah dibuat, belum dibayar. QR dan nomor virtual account hanya bisa dibuka selama status ini.
  • paid: sudah dikonfirmasi, saldo sudah masuk.
  • failed dan expired: tidak jadi, saldo tidak bergerak. Buat pembayaran baru kalau masih ingin menambah saldo.
  • cancelled: kamu sendiri yang membatalkannya.
  • refunded: dananya sudah dikembalikan, jadi pembayaran itu tidak menambah saldomu.

Hanya boleh ada satu top up yang belum selesai pada satu waktu. Kalau kamu membuat yang kedua, permintaannya ditolak 409 conflict dengan menyebut referensi yang masih terbuka — selesaikan atau batalkan yang itu dulu.

Bagaimana saldo terpakai#

Setiap request menempuh urutan yang sama, dan urutannya itu yang membuat saldo tidak pernah minus.

  1. Batas laju dan tingkat akses diperiksa.
  2. Estimasi biaya maksimum ditahan dari saldomu.
  3. Request baru dikirim ke model.
  4. 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, MenvoraRouter 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 MenvoraRouter. Yang dibandingkan dengan ambang itu adalah saldo yang bisa kamu belanjakan, bukan total termasuk yang sedang ditahan. Saat turun di bawahnya, konsol menandai akunmu: dasbor menampilkan peringatan beserta angkanya, dan angka saldo di navigasi ikut berubah warna. Ambangnya ditampilkan di konsol, bukan di halaman ini. Sama seperti minimum top up, angkanya konfigurasi yang bisa berubah.

Peringatan itu juga dikirim sebagai email transaksional ke alamat akunmu saat saldo melewati ambang ke bawah. Tidak ada sakelar untuk mematikannya di Pengaturan: halaman itu mengatur profil, kata sandi, dan tingkat akses, bukan preferensi notifikasi.

Troubleshooting#

GejalaPenyebabSolusi
402 insufficient_balanceSaldo dompet tidak cukup untuk menanggung request.top up dulu, lalu ulangi; cek juga tidak ada penahanan lain yang menyita saldo
402 spending_limit_exceededSaldo 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 membayarKonfirmasi dari penyedia belum diterima server.tunggu sebentar, muat ulang riwayat pembayaran di halaman Top up; kalau tetap kosong, hubungi kami dengan referensinya
QR tidak munculKanal pembayaran tidak tersedia, penyedia sedang bermasalah, atau mode manual sedang aktif.muat ulang halaman Top up; kalau mode manual, ikuti instruksi WhatsApp di panel pembayaran
409 conflictMasih ada top up yang belum selesai; pesannya menyebut referensinya.selesaikan atau batalkan top up itu dulu, baru buat yang baru