Ubah peristiwa penggunaan mentah menjadi kuantitas yang dapat ditagih dengan agregasi dan penyaringan.
Meter mengonversi event mentah menjadi kuantitas yang dapat ditagihkan. Meter memfilter event dan menerapkan fungsi agregasi (Count, Sum, Max, Last) untuk menghitung penggunaan per pelanggan.
Label unit untuk invoice dan laporan. Contoh: calls, tokens, GB, hours.
3
Filtering (Optional)
Tambahkan kondisi untuk menyaring peristiwa mana yang dihitung:
Logika DAN: Semua kondisi harus cocok
Logika ATAU: Kondisi mana pun dapat cocok
Komparator yang tersedia: sama dengan, tidak sama dengan, lebih besar dari, lebih besar dari atau sama dengan, kurang dari, kurang dari atau sama dengan, berisi, tidak berisi.Aktifkan pemfilteran, pilih logika Anda, lalu tambahkan kondisi dengan kunci properti, komparator, dan nilai.
Secara default, meter menagih pelanggan per unit dalam dolar (atau mata uang yang Anda konfigurasi). Anda juga dapat mengonfigurasi meter untuk mengurangi saldo kredit pelanggan, sehingga penggunaan mengonsumsi kredit alih-alih menghasilkan biaya moneter.
Pengurangan berbasis kredit memerlukan Credit Entitlement yang terpasang pada produk yang sama. Buat credit entitlement terlebih dahulu, lalu tautkan ke meter.
Pertama, buat credit entitlement di Products → Credits. Tentukan unit (misalnya, “API Calls”, “Tokens”), presisi, dan pengaturan lifecycle (kedaluwarsa, rollover, overage).Lihat panduan Penagihan Berbasis Kredit untuk petunjuk rinci.
2
Create or Edit a Usage-Based Product
Buka produk berbasis penggunaan Anda dan buka bagian konfigurasi Meter.
3
Add a Meter
Klik tombol + untuk melampirkan meter. Konfigurasikan nama acara, jenis agregasi, dan unit pengukuran seperti biasa.
4
Enable 'Bill Usage in Credits'
Aktifkan Bill usage in Credits pada konfigurasi meter untuk menampilkan pengaturan kredit:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Jumlah unit penggunaan yang diperlukan agar memotong 1 kredit. Misalnya:
1 = setiap peristiwa meter memotong 1 kredit
100 = 100 peristiwa meter memotong 1 kredit
1000 = 1.000 panggilan API mengonsumsi 1 kredit
5
Free Threshold and Credits
Free Threshold berlaku untuk meter yang ditagihkan dalam bentuk uang, bukan meter yang ditagihkan dalam kredit. Saat meter menagih dalam kredit, setiap unit dihitung sebagai pengurangan kredit.Contoh: Dengan meter-units-per-credit sebesar 1, pelanggan yang melakukan 2.500 panggilan API akan dikurangi 2.500 kredit.
Setelah dikonfigurasi, pipeline pengurangan berjalan secara otomatis:
Event tiba — Aplikasi Anda mengirim event penggunaan melalui Event Ingestion API.
Meter melakukan agregasi — Event diagregasikan sesuai konfigurasi meter Anda (Count, Sum, Max, Last).
Worker latar belakang memproses — Setiap menit, worker mengambil event baru sejak checkpoint terakhir.
Kredit dikurangi — Penggunaan yang telah diagregasikan dikonversi menjadi kredit menggunakan rate meter_units_per_credit dan dikurangi menggunakan urutan FIFO (grant yang paling cepat kedaluwarsa digunakan terlebih dahulu).
Overage dilacak — Jika saldo mencapai nol, penggunaan selanjutnya dicatat sebagai overage dan ditangani sesuai perilaku yang dikonfigurasi (dimaafkan saat reset, ditagihkan pada invoice berikutnya, atau dibawa ke depan sebagai defisit). Dodo Payments tidak memblokir penggunaan saat saldo habis. Untuk menghentikan akses saat saldo nol, periksa saldo di aplikasi Anda.
Pengurangan kredit berjalan secara asinkron (sekitar setiap ~1 menit). Mungkin terdapat sedikit jeda antara penerimaan event dan pengurangan saldo. Rancang aplikasi Anda untuk menangani jeda ini dan jangan mengandalkan pemeriksaan saldo real-time untuk kontrol akses pada setiap request.
Anda dapat menautkan beberapa meter pada produk yang sama ke credit entitlement yang sama. Semua meter mengurangi satu saldo bersama.Contoh: Platform AI dengan dua meter:
text.generation — 1 kredit per 1.000 token
image.generation — 10 kredit per gambar
Keduanya memotong dari kumpulan “AI Credits” yang sama. Pelanggan melihat satu saldo terpadu di portal mereka.
Gunakan tarif meter_units_per_credit berbeda antar meter untuk menyatakan biaya relatif. Operasi mahal (generasi gambar) membutuhkan lebih sedikit unit meter per kredit dibanding yang murah (penyelesaian teks).
List Customer Ledger
Lihat riwayat pengurangan kredit lengkap untuk pelanggan.
Get Customer Balance
Periksa saldo kredit saat ini pelanggan melalui API.
