Lompat ke konten utama
StableTerakhir diperbarui: 17 Nov 2026, 19.03

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.

Stable

1. 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.
Hak Akses Pengelolaan Finansial

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):

Dasbor utama penagihan dan langganan paket DagangBot menampilkan status langganan, kuota pesan, dan riwayat invoice
Dasbor ringkasan penagihan DagangBot dengan informasi paket aktif, masa berlaku, dan histori pembayaran invoice.
Tampilan manajemen dompet token dan distribusi kuota cabang operasional
Antarmuka alokasi dompet token per cabang toko dengan rincian saldo mandiri dan batas penggunaan.

3. Panduan Langkah-demi-Langkah

Berikut adalah pedoman operasional dasar dalam mengelola saldo pusat serta pendistribusian kuota menuju cabang toko:

  1. 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. 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:

    bash
    curl -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. 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. 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. 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. 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.

    bash
    curl -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. 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).

    bash
    curl "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):

  1. Komputasi pengiriman (outbound) mengevaluasi akumulasi biaya awal.
  2. 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.
  3. 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:

Entitas / Parameter Nilai Acuan Dinamis (Seed Default) Kondisi / Efek Sistem
Paket Starter Ambang lifetime bawaan Rp 100.000 atau siklus berbayar Maksimal 1 Instance WA; 1 Cabang; 20 Dokumen KB. Nilai & fitur diset dinamis via /super/plans.
Paket Growth Pro Ambang lifetime bawaan Rp 500.000 atau siklus berbayar Maksimal 3 Instance WA; 3 Cabang; 100 Dokumen KB. Mencakup akses ASPRI Full dan Broadcast.
Paket Agency Ambang lifetime bawaan Rp 1.500.000 atau siklus berbayar Maksimal 10 Instance WA; 10 Cabang; 500 Dokumen KB. Termasuk Sub Akun terisolasi dan White Label.
Floor Minimum Bill Rp 1,00 Sistem menetapkan potongan tagihan terendah untuk mencegah pengikisan saldo kurang dari nol pada setiap sesi API tunggal.
Idempotency Key Wajib untuk POST mutasi Semua metode transfer atau recall menginspeksi header ini; bila key ganda terdeteksi dalam 24 jam, pemrosesan ulang dibatalkan.
Batas Kedaluwarsa Kurs 24 Jam (Stale Tolerance) Platform memblokir pembentukan billing bila layanan kurs penukaran gagal sinkronisasi lebih dari ambang batas 72 jam (Hard Block).

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, dan GET /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)

Gejala Penyebab Solusi
Interaksi AI tidak merespons dan mencatat error kode 402 INSUFFICIENT_POOL_BALANCE. Token di dalam saldo pool perusahaan sepenuhnya habis, tidak cukup untuk satu operasi interaksi. Akses menu dompet pusat dan lakukan pengisian (top-up) segera. Tagihan pending otomatis dilunasi setelah deposit baru diverifikasi sistem.
Bot WhatsApp di suatu cabang terhenti dengan error INSUFFICIENT_BRANCH_BALANCE. Mode dompet diatur ke Dedicated sementara alokasi sisa di dalam cabang itu telah menyentuh Rp 0, meskipun pool pusat memiliki dana. Alihkan transfer distribusi secara manual menuju cabang spesifik, atau paksa proses eksekusi distribusi split-even.
Transfer token dari pool menuju cabang gagal dan menampilkan error HTTP 400 NO_ACTIVE_BRANCHES. Sistem diminta melaksanakan fungsi split-even atau distribusi alokasi padahal tidak ada satupun entitas cabang yang aktif pada tenant tersebut. Aktifkan minimal satu instansi profil cabang dalam menu Pengaturan Toko sebelum menjadwalkan ulang split-even.
Permintaan Recall token gagal ditarik padahal log menunjukkan indikator saldo positif. Saldo yang tercatat di dalam dompet cabang tersebut telah termakan (reserved) untuk transaksi berjalan yang belum final (race condition). Lakukan perulangan recall sesudah 5-10 detik ketika proses komputasi respon tertunda (pending operation) sukses terselesaikan.
Menerima status error HTTP 403 BRANCH_ACCESS_DENIED ketika mengintip saldo dompet. Pengguna yang melakukan login merupakan administrator cabang B, tetapi bermaksud membuka halaman laporan keuangan cabang A yang berada di luar lingkup yurisdiksinya. Lakukan autentikasi menggunakan akses Owner, atau modifikasi kembali penetapan otorisasi wilayah kerja staf dalam pengaturan pengguna RBAC.

7. Referensi Terkait

content/docs/features/plans-billing.mdx
Terakhir diperbarui: 17 Nov 2026, 19.03

Dokumentasi teknis DagangBot