Lewati ke konten utama

Billing Dashboard

Halaman Dashboard Billing adalah pusat informasi keuangan bagi pelanggan. Di sini, pelanggan dapat melihat sisa saldo dompet (Wallet Balance), estimasi biaya bulan berjalan, serta grafik pemakaian resource (Virtual Machine, Snapshot, dsb).

1. Menarik Ringkasan Pemakaian Berjalan (Prepaid)​

API ini memberikan informasi mutlak tentang biaya yang telah dihabiskan pada bulan ini (Current Month Cost), sisa saldo, dan data seri waktu (time-series) untuk merender grafik pengeluaran 30 hari terakhir.

Request
GET /api/billing/summary

Respons (200 OK):

{
  "data": {
    "current_balance": 1500000.00,
    "current_month_cost": 250000.00,
    "projected_cost": 500000.00,
    "chart_data": [
      { "date": "2026-05-01", "cost": 15000.00 },
      { "date": "2026-05-02", "cost": 15500.00 }
    ]
  }
}

2. Grafik Donat Pemakaian per Layanan (Insight)​

Untuk memberikan visibilitas lebih detail, Frontend dapat merender grafik donat (ring chart) yang membedah Current Month Cost berdasarkan jenis layanan (misal: porsi Compute vs Storage).

Request
GET /api/billing/dashboard

Respons (200 OK):

{
  "data": [
    { "service": "Compute (VM)", "percentage": 75, "cost": 187500.00 },
    { "service": "Block Storage", "percentage": 25, "cost": 62500.00 }
  ]
}

3. Riwayat Mutasi Saldo (Credit History)​

Sama seperti buku tabungan bank, setiap pemotongan saldo (oleh Cronjob tagihan per jam) atau penambahan saldo (dari pembayaran tiket Topup) dicatat ke dalam Credit History.

Request
GET /api/billing/credit?page=1&limit=10

Respons (200 OK): Mereturn senarai (list) log mutasi masuk (Credit) dan keluar (Debit) lengkap dengan tanggal dan keterangan referensi.