Paket, Langganan & Billing
Platform DagangBot menggabungkan pengelolaan paket langganan fitur dengan sistem manajemen kuota token AI berbasis arsitektur dompet dua tingkat (pool pusat dan dompet per cabang) untuk kontrol anggaran operasional yang terukur secara presisi. Sistem ini dirancang untuk mencegah satu cabang yang sangat sibuk menghabiskan seluruh anggaran operasional perusahaan secara sepihak.
Stable1. Ikhtisar & Nilai Bisnis
- Arsitektur Wallet Dua Tingkat: Menyediakan satu pool saldo terpusat untuk perusahaan (tenant), dengan kemampuan mendistribusikan alokasi kuota ke masing-masing cabang secara independen.
- Limitasi Budget per Cabang: Mencegah kebocoran anggaran dengan menerapkan batas maksimum pemakaian per lokasi, yang secara otomatis menghentikan respons AI bila batas terlewati, tanpa memengaruhi cabang lain.
- Distribusi Otomatis & Manual: Mendukung metode transfer saldo secara manual ke cabang spesifik, maupun split-even (pembagian merata) ke seluruh cabang aktif dengan satu klik.
- Mutasi Ledger Transparan: Mencatat setiap transaksi pengisian saldo (top-up), distribusi cabang, penarikan kembali (recall), hingga pemotongan per interaksi AI dalam riwayat mutasi yang dapat diaudit secara mendetail.
- Pemeringkatan Fitur (Feature Gating): Memastikan akses pengguna pada modul tingkat lanjut disesuaikan dengan paket langganan aktif, mengamankan infrastruktur platform tanpa mengganggu fitur dasar yang sudah berjalan.
Hanya pengguna dengan peran Owner (grants_all_resources) yang memiliki otoritas untuk melihat saldo pool pusat, melakukan pengisian ulang (top-up) saldo, mengubah mode dompet, serta mengeksekusi operasi penarikan token (recall). Manajer cabang terbatas pada melihat saldo sisa dari dompet cabang yang menjadi tanggung jawabnya.
Platform mendukung model hibrida dinamis: Akumulasi Top-Up Lifetime (cumulative_paid_topup) yang membuka akses fitur secara permanen berdasarkan pokok top-up berbayar (principal_amount) tanpa hangus bulanan, maupun Langganan Berulang (Bulanan/Tahunan) yang dapat diaktifkan/dialihkan secara zero-downtime oleh administrator platform. Seluruh cabang di bawah satu akun bisnis berbagi tingkat paket yang sama, sementara Sub-Account Agensi terisolasi per masing-masing merchant_id. Token berfungsi sebagai bahan bakar operasional interaksi AI sehingga biaya pemakaian tetap proporsional dengan pertumbuhan transaksi Anda.
2. Alur Visual & Antarmuka
Platform menyajikan dua metrik utama pada dasbor penagihan: ringkasan paket langganan dan alokasi saldo dompet token per cabang. Data ini tersinkronisasi secara seketika (real-time):


3. Panduan Langkah-demi-Langkah
Berikut adalah pedoman operasional dasar dalam mengelola saldo pusat serta pendistribusian kuota menuju cabang toko:
- 1
Langkah 1: Memeriksa Saldo Pool Pusat
Buka dasbor utama, arahkan ke menu Billing & Tagihan pada navigasi utama, lalu pilih tab Dompet Token. Dasbor akan menampilkan saldo aktif perusahaan beserta indikator ketersediaan token gratis yang diberikan saat paket perpanjangan aktif.
- 2
Langkah 2: Mengisi Ulang Saldo (Top-Up)
Pilih opsi Top-Up Saldo. Anda akan dialihkan ke antarmuka pembuatan faktur penagihan. Sistem menghasilkan tautan pembayaran virtual (payment link). Setelah pembayaran lunas terverifikasi, saldo token perusahaan secara otomatis bertambah berdasarkan perhitungan unit standar tanpa proses intervensi manual.
Secara programatik, interaksi ini memanggil endpoint penagihan untuk menghasilkan faktur secara seketika:
bashcurl -X POST "https://dagangbot.web.id/api/v1/billing/topup" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "amount_idr": 500000, "payment_method": "qris" }' - 3
Langkah 3: Menentukan Mode Dompet
Buka pengaturan Konfigurasi Wallet, lalu pilih mode operasional:
- Pool Bersama (Shared Pool): Seluruh percakapan memotong dari satu dompet terpusat. Paling sesuai untuk entitas bisnis satu cabang (Starter).
- Distribusi Terpisah (Dedicated): Mewajibkan pemilik memecah dan mentransfer saldo secara eksplisit ke masing-masing dompet cabang. Sistem percakapan gagal bila cabang kehabisan saldo meskipun pool pusat terisi penuh.
- 4
Langkah 4: Mendistribusikan Saldo ke Cabang
Bila mode Dedicated aktif, klik Distribusikan ke Cabang. Masukkan nominal kuota (contoh: 50.000 token) ke masing-masing input untuk Cabang A, B, atau C. Pastikan total angka tersebut tidak melampaui sisa saldo pusat yang tercantum.
Untuk entitas berskala nasional yang menghendaki pembagian kuota merata kepada seluruh cabang dalam satu instruksi tunggal tanpa pengisian manual, eksekusi pemanggilan split-even:
bash# Pembagian merata ke seluruh cabang aktif tanpa intervensi manual curl -X POST "https://dagangbot.web.id/api/v1/billing/wallets/split-even" \ -H "Authorization: Bearer $TOKEN" \ -H "Idempotency-Key: split-20261008-01" \ -H "Content-Type: application/json" \ -d '{}' - 5
Langkah 5: Penarikan Sisa Saldo (Recall)
Pada periode evaluasi, Anda dapat menarik saldo yang tertahan di cabang yang tidak aktif dengan memilih opsi Tarik Saldo Cabang (Recall). Token cabang kembali digabungkan dengan saldo pusat dalam satu operasi yang terjamin dengan proteksi
Idempotency-Key.Permintaan recall mengumpulkan sisa koin dan mentransfernya kembali ke kolam dana sentral, yang amat berguna ketika pergantian bulan penagihan atau penutupan permanen sebuah fasilitas wilayah.
bash# Penarikan keseluruhan token dari semua fasilitas wilayah kembali ke pool pusat curl -X POST "https://dagangbot.web.id/api/v1/billing/wallets/recall" \ -H "Authorization: Bearer $TOKEN" \ -H "Idempotency-Key: recall-20261008-01" \ -H "Content-Type: application/json" \ -d '{"recall_all": true}' - 6
Langkah 6: Penerapan Batas Anggaran (Budget Cap)
Sebagai langkah preventif lanjutan, Anda diizinkan memberlakukan batasan absolut pemakaian di suatu cabang tertentu. Begitu pembelanjaan model melampaui plafon anggaran, mesin percakapan merespons dengan statis tanpa menguras cadangan tambahan dari pool utama.
bashcurl -X PUT "https://dagangbot.web.id/api/v1/billing/wallets/budget" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "branch_id": "8f8c44b0-a548-472d", "monthly_cap": 50000, "alert_threshold": 0.8 }'Berdasarkan konfigurasi di atas, pada ambang penggunaan 80% (40.000 token), sistem otomatis meluncurkan pemberitahuan (alert) via platform komunikasi ke akun pemilik (owner).
- 7
Langkah 7: Pemantauan Riwayat Transaksi (Ledger)
Seluruh mutasi tercatat abadi pada pembukuan buku besar (ledger). Laporan membedakan tipe operasi
topup,distribution,recall, pemotongan biaya inferensi rutin (usage), serta tindakan khusus perbaikan admin (adjustment).bashcurl "https://dagangbot.web.id/api/v1/billing/wallets/ledger?page=1&per_page=20" \ -H "Authorization: Bearer $TOKEN"
Mekanisme Komputasi Saldo & Limitasi Gateway
Setiap kali AI menghasilkan balasan, sistem menghitung konsumsi token dan pesan secara transparan berdasarkan volume interaksi. Tarif pemotongan disesuaikan dengan tingkatan paket aktif toko, memberikan efisiensi biaya yang semakin tinggi seiring bertumbuhnya skala bisnis Anda.
Teruntuk beban gateway pengiriman lintas platform WhatsApp (Jalur A):
- Komputasi pengiriman (outbound) mengevaluasi akumulasi biaya awal.
- Ambang tertinggi (gateway cap) ditetapkan baku pada Rp 5; sistem tidak pernah mengamputasi saldo lebih besar dari batas Rp 5 bagi komponen beban gerbang pada interaksi satuan.
- Keseluruhan nilai desimal dirangkum serta diamankan (floor) pada limit paling minimal yakni Rp 1, menghindari kerentanan pengurangan saldo tak terhingga (infinity drain) oleh perhitungan pecahan.
Semua ketetapan rasio persentase serta biaya tetap ini diacu secara absolut dari dokumen pusat arsitektur harga DagangBot, sehingga intervensi administrasi tersistemasi secara kohesif ke setiap aspek tagihan tanpa kejanggalan perbedaan nilai.
4. Parameter & Spesifikasi Teknis
Platform menyediakan lima opsi paket (Plans), mencakup batas penggunaan dan fitur komputasi terkait:
Sistem secara otomatis menetapkan label fungsional khusus (feature keys), seperti multi_branch (berupa integer), otp_gateway (berupa boolean), dan storage_quota_mb. Pemisahan kapabilitas ini mengunci navigasi di aplikasi frontend sekaligus memvalidasi akses di middleware API backend sehingga tenant yang berupaya mengakses fungsi yang tidak termasuk dalam paket berlangganannya ditolak seketika (403 Forbidden).
5. Relasi & Integrasi
Sistem berlangganan dan dompet berinteraksi secara mendalam dengan berbagai komponen arsitektur platform:
- Manajemen Cabang: Fitur operasional dompet sangat berkaitan erat dengan struktur Multi-Cabang. Limitasi kuota di sini menjadi prasyarat untuk mencegah interupsi komunikasi harian di cabang terkait.
- REST API Eksternal: Seluruh mutasi transaksi (mulai dari pemotongan token hingga rekap tagihan) dapat diamati melalui All-in-One API pada endpoint
GET /all-in-one/billing/balance,GET /all-in-one/billing/transactions, danGET /all-in-one/billing/invoices. Pengguna enterprise atau software house bisa menautkan indikator metrik ini langsung ke ERP internal tanpa melalui antarmuka dashboard manual. - Siklus Hidup Pemotongan Token: Biaya layanan (termasuk proteksi cap gateway maksimum Rp 5) dihitung dan dikurangi (deducted) dari dompet bersangkutan seusai merujuk pada logika penetapan komputasi di dokumen Prinsip Penagihan & Estimasi Komputasi AI maupun parameter harga di Paket & Harga.
6. Pemecahan Masalah (Troubleshooting)
7. Referensi Terkait
Paket Langganan & Harga
Daftar struktur tagihan bulanan beserta batasan kuota sumber daya terpadu.
Model Perhitungan Token
Rincian matematis pemotongan tarif layanan gateway maupun model kecerdasan buatan.
Top-up Saldo Koin & Faktur
Panduan rinci mengenai opsi pelunasan pembayaran lewat jalur QRIS serta Virtual Account.
Kalkulator Biaya AI
Alat perantara komputasi biaya percakapan berdasar profil aktivitas perusahaan secara interaktif.
