> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Penagihan Berdasarkan Penggunaan
> Kenakan biaya kepada pelanggan berdasarkan apa yang mereka gunakan dengan pengukuran fleksibel dan penagihan otomatis.
Penagihan berdasarkan penggunaan memungkinkan Anda mengenakan biaya kepada pelanggan untuk apa yang mereka gunakan—panggilan API, penyimpanan, token AI, atau metrik apa pun yang Anda definisikan. Pelanggan membayar berdasarkan konsumsi, bukan biaya tetap.
**Sangat cocok untuk**: API, layanan AI, platform infrastruktur, dan produk apa pun di mana nilai meningkat seiring penggunaan.
## Cara Kerjanya
Aplikasi Anda mengirimkan event ketika tindakan yang dapat ditagih terjadi.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
Meter menggabungkan event menjadi jumlah yang dapat ditagih menggunakan agregasi Count, Sum, Max, atau Last.
Tetapkan harga per unit dan ambang bebas biaya. Pelanggan ditagih secara otomatis setiap siklus.
## Konsep Inti
### Peristiwa
Event merepresentasikan aksi penggunaan dalam aplikasi Anda. Setiap event meliputi:
* **Nama Event**: Jenis penggunaan (misalnya `api.call`)
* **ID Pelanggan**: Siapa yang menggunakannya
* **Metadata**: Properti tambahan untuk agregasi
### Pengukur
Pengukur mengagregasi peristiwa menjadi kuantitas yang dapat dikenakan biaya:
* **Hitung**: Total peristiwa (panggilan API)
* **Jumlah**: Tambahkan nilai (total byte)
* **Maks**: Nilai tertinggi (pengguna puncak)
* **Terakhir**: Nilai terbaru
### Produk dengan Penetapan Harga Berdasarkan Penggunaan
Tetapkan harga per unit dan ambang batas gratis opsional:
**Contoh**: 2.500 panggilan - 1.000 gratis = 1.500 × $0,02 = $30,00
### Pengurangan Berbasis Kredit
Alih-alih mengenakan biaya per unit dalam dolar, Anda dapat mengonfigurasi meter untuk mengurangi dari [saldo kredit](/features/credit-based-billing) pelanggan. Kredit diperbarui setiap siklus penagihan dan diterapkan sebelum biaya kelebihan.
## Memulai dengan Cepat
Di dasbor Anda: **Meters** → **Create Meter**
1. Tetapkan nama event (misalnya `api.call`)
2. Pilih agregasi (Count, Sum, Max, Last)
3. Tambahkan filter opsional
Hubungkan meter ke produk dengan penetapan harga:
1. Pilih **Usage-Based Billing**
2. Pilih meter Anda
3. Tetapkan harga per unit dan ambang bebas biaya
```javascript theme={null}
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
```
Periksa dasbor meter Anda untuk melihat event dan agregasi penggunaan. Pelanggan ditagih secara otomatis setiap siklus.
## Kasus Penggunaan
Lacak panggilan API, jam komputasi, bandwidth, penyimpanan. Contoh: \$0.001 per panggilan setelah 10.000 gratis.
Lacak token, generasi, waktu pemrosesan. Contoh: \$0.04 per gambar standar, \$0.08 per HD.
Tagih berdasarkan data yang diproses, kueri yang dijalankan, rekaman yang dianalisis. Contoh: \$5 per GB setelah 10 GB gratis.
Hitung pesan, menit, data yang ditransfer. Contoh: \$0.01 per SMS yang dikirim.
## Langkah Selanjutnya
Pelajari cara menyusun dan mengirim event penggunaan dari aplikasi Anda.
Kuasi konfigurasi meter, jenis agregasi, dan penyaringan event.
Bangun generator gambar AI lengkap dengan penagihan berbasis penggunaan dari awal.
Panduan komprehensif untuk menerapkan penagihan berbasis penggunaan dalam aplikasi Anda.