Skip to main content
Penagihan Berbasis Kredit memungkinkan Anda memberikan pelanggan saldo kredit - panggilan API, token, unit komputasi, atau metrik kustom lainnya - dan menguranginya dari saldo seiring mereka menggunakan layanan Anda. Kredit bekerja di semua jenis produk: langganan, pembelian satu kali, dan penagihan berbasis penggunaan.

Apa itu Penagihan Berbasis Kredit?

Penagihan Berbasis Kredit memberi Anda sistem fleksibel untuk memberikan hak kredit kepada pelanggan sebagai bagian dari produk Anda. Alih-alih menagih per penggunaan atau membatasi akses melalui fitur flags, Anda mengalokasikan sejumlah kredit yang dapat digunakan pelanggan saat mereka menggunakan layanan Anda. Kredit ideal untuk:
  • Platform AI dan LLM: Berikan token atau kredit generasi per tingkat rencana
  • Layanan API: Alokasikan kredit panggilan API dengan harga kelebihan
  • Platform Infrastruktur: Berikan kredit jam komputasi atau penyimpanan
  • Layanan Komunikasi: Sediakan kredit pesan atau menit per langganan
  • SaaS dengan tingkat konsumsi: Gabungkan penggunaan yang termasuk dalam kumpulan kredit
Checkout menampilkan kredit yang termasuk dengan pembelian produk

Credits appear as entitlements on your products and show in checkout, customer portal, and subscription details.

Konsep Inti

Jenis Kredit

Saat membuat kredit, Anda memilih antara dua jenis:
Tentukan kredit dalam unit Anda sendiri - token, panggilan API, jam komputasi, atau metrik apa pun yang bermakna untuk produk Anda. Unit kustom menggunakan presisi yang Anda tetapkan (0 hingga 3 angka desimal).Terbaik untuk: Panggilan API, token AI, jam komputasi, unit penyimpanan, pesan

Siklus Hidup Kredit

Kredit mengikuti siklus hidup yang jelas dari penerbitan hingga konsumsi:
1

Credits Issued

Kredit diberikan ketika pelanggan membeli produk (langganan atau satu kali) dengan hak kredit yang terkait. Untuk langganan, kredit diterbitkan kembali setiap siklus penagihan.
2

Credits Consumed

Saat pelanggan menggunakan layanan Anda, kredit dikurangi. Untuk produk berbasis penggunaan, pengukur secara otomatis mengurangi kredit berdasarkan peristiwa waktu nyata. Anda juga dapat mengurangi kredit secara manual melalui dashboard atau API.
3

Credits Expire or Roll Over

Pada akhir siklus penagihan (atau setelah periode kedaluwarsa yang dikonfigurasi), kredit yang tidak terpakai akan kedaluwarsa atau bergulir ke periode berikutnya berdasarkan pengaturan Anda.
4

Overage Handling

Jika kredit habis di tengah siklus, Anda dapat memungkinkan kelebihan (penggunaan yang dilanjutkan melebihi saldo) dan memilih cara menangani kelebihan tersebut - maaf atau data, tagih, atau bawakan defisit ke depan.

Sumber Pemberian

Kredit dapat diberikan dari beberapa sumber:

Membuat Kredit

Buat hak kredit di bagian Produk → Kredit dari dasbor Anda. Setiap kredit mendefinisikan unit, presisi, aturan kedaluwarsa, dan perilaku siklus hidup.
Halaman daftar kredit menampilkan hak kredit yang telah dibuat

The Credits tab under Products shows all your credit entitlements.

1

Navigate to Credits

Buka Produk di dasbor Anda dan pilih tab Kredit. Klik Buat Kredit untuk memulai.
2

Configure Basic Information

Masukkan Nama Kredit - ini adalah pengidentifikasi internal Anda untuk kredit tersebut.
Formulir pembuatan kredit menampilkan info dasar, pengaturan umum, dan pengaturan langganan

The credit creation form with all configuration sections.

3

Set General Settings

Konfigurasikan tipe dan properti tampilan kredit:
string
wajib
Pilih Unit Kustom atau Kredit Fiat.
  • Unit Kustom - Tentukan metrik Anda sendiri (token, panggilan API, jam komputasi). Memerlukan pengaturan Nama Unit (mis., “Platform tokens”) dan Presisi.
  • Kredit Fiat - Kredit mewakili nilai mata uang sebenarnya. Memerlukan pilihan Mata Uang Unit (USD, EUR, GBP, INR, dll.).
string
Hanya untuk kredit Unit Kustom. Label yang dilihat pelanggan untuk kredit ini (mis., “Token AI”, “Panggilan API”). Ditampilkan di checkout dan portal pelanggan.
number
Hanya untuk kredit Unit Kustom. Jumlah tempat desimal yang diperbolehkan:
  • 0 - Bilangan bulat (terbaik untuk item yang dapat dihitung seperti panggilan API)
  • 1 - Satu desimal (0.0)
  • 2 - Dua desimal (0.00) - default
  • 3 - Tiga desimal (0.000)
Presisi tidak dapat diubah setelah kredit dibuat.
string
Berapa lama kredit tetap valid setelah diterbitkan:
  • 7 hari, 30 hari (default), 60 hari, 90 hari, Kustom, atau Tidak Pernah
Pilih Kustom untuk menentukan jumlah hari kustom (minimal 1).
4

Configure Subscription Settings (Optional)

Pengaturan ini mengontrol perilaku kredit dalam langganan berulang:
boolean
Izinkan kredit yang tidak terpakai untuk dibawa ke siklus penagihan berikutnya. Saat diaktifkan, konfigurasikan:
  • Persentase Maks Gulirkan (0–100%) - Batasi berapa banyak yang dibawa ke depan
  • Jangka Waktu Gulirkan - Berapa lama kredit yang digulirkan tetap valid (mis., 1 Bulan)
  • Jumlah Maks Gulirkan - Maksimum guliran berkelanjutan sebelum kredit hangus
Ketika Kredit Habis atau Langganan Kedaluwarsa:
boolean
Beri pelanggan izin untuk terus menggunakan layanan Anda setelah saldo kredit mereka mencapai nol. Saat diaktifkan, konfigurasikan:
  • Batas Kelebihan - Maksimum kredit yang dapat digunakan pelanggan di luar saldo mereka
  • Harga Per Unit - Biaya per kredit tambahan saat kelebihan diaktifkan (dengan pilihan mata uang)
string
wajib
Mengontrol cara menangani kelebihan di akhir siklus penagihan:
  • Maaf atas kelebihan saat reset (default) - Penggunaan yang melebihi batas kredit dicatat tetapi tidak ditagih. Saldo direset setiap siklus.
  • Tagih kelebihan saat penagihan - Penggunaan yang melebihi batas kredit dikenakan pada faktur berikutnya, kemudian saldo direset.
  • Bawa defisit ke depan - Penggunaan di luar batas kredit dibawa ke depan sebagai saldo negatif ke siklus berikutnya.
  • Bawa defisit ke depan (pembayaran otomatis) - Defisit dibawa ke depan dan dibayar otomatis dari kredit baru di siklus berikutnya.
5

Create Credit

Klik Buat Kredit untuk menyimpan. Kredit sekarang tersedia untuk dilampirkan ke produk apa pun.
Hak kredit Anda siap. Lampirkan ke produk untuk mulai menerbitkan kredit kepada pelanggan.
Mulailah dengan pengaturan sederhana - tanpa guliran, tanpa kelebihan - dan tambahkan kerumitan saat Anda belajar cara pelanggan menggunakan kredit. Sebagian besar pengaturan dapat diperbarui kapan saja tanpa memengaruhi pemberian yang ada. Perhatikan bahwa presisi tidak dapat diubah setelah kredit dibuat.

Attaching Credits to Products

Kredit dilampirkan ke produk sebagai hak dalam alur pembuatan atau pengeditan produk. Anda dapat melampirkan hingga 5 kredit per produk. Kredit berfungsi dengan ketiga jenis penetapan harga.

Subscription Products

For subscriptions, credits are issued per billing cycle and can be configured with proration, trial credits, and cycle-specific settings.
1

Create or Edit a Subscription Product

Go to Products → Create Product or edit an existing product. Select Subscription as the pricing type and configure your recurring price.
2

Open Entitlements Section

Expand the Entitlements section and click the Attach button next to Credits.
Bagian hak produk menampilkan tombol lampirkan Kredit

The Entitlements section in the product form with Credits, License Key, and Digital Product Delivery options.

3

Select Credits to Attach

An Add Credits panel opens. You can select an existing credit from the dropdown or click Create new credit to define one on the spot.
Panel Tambah Kredit dengan dropdown pemilihan kredit

The Add Credits panel lets you select existing credits or create new ones.

Anda dapat melampirkan hingga 5 kredit per produk. Setiap kredit dapat memiliki konfigurasinya sendiri.
4

Configure Credit Settings

For each attached credit, configure:
number
wajib
The number of credits granted to the customer each billing period.
number
Notify when credits fall below this amount. Useful for alerting customers before they run out.
number
Set a different credit amount for trial periods. Enable Expire trial credits after trial ends to revoke unused trial credits when the trial converts to a paid subscription.
boolean
Prorate remaining credits when a customer upgrades or downgrades their subscription plan.
boolean
Use the default rollover, overage, and expiry settings from the credit entitlement. Turn this off to customize settings specifically for this product.
Formulir konfigurasi kredit dengan siklus penagihan, uji coba, dan pengaturan proration

Credit configuration showing per-cycle amount, trial credits, proration, and custom settings.

5

Review and Add

Review the attached credit showing name, amount, and expiration. Click Add to Subscription to confirm.
Panel Tambah Kredit menampilkan kredit yang dipilih dengan detail

Review attached credits before adding them to the subscription.

One-Time Payment Products

For one-time payments, credits are issued once at the time of purchase.
1

Create a One-Time Product

Create a product with Single Payment pricing type.
Bagian harga produk dengan Pembayaran Sekali pilih

Single Payment pricing selected for a one-time credit product.

2

Attach Credits

Open the Entitlements section and attach credits. Configure the number of credits issued (total one-time grant) on purchase.
One-time credit products are ideal for credit top-up packs, promotional bundles, or prepaid credit purchases.

Usage-Based Billing Products

For usage-based products, credits are linked to meters and automatically deducted based on real-time consumption events.
1

Create a Usage-Based Product

Select Usage Based Billing as the pricing type. Configure the base price and billing frequency.
Konfigurasi harga Berdasarkan Penggunaan

Usage Based Billing pricing type with meter configuration.

2

Add a Meter

Click the + button in the Select meter section to add a meter. A subscription can have up to 3 meters.
Panel Pilih Meter menampilkan ambang batas gratis dan toggle kredit

The Select Meter panel with meter configuration and credit toggle.

3

Enable Credit Billing on the Meter

Toggle Bill usage in Credits to attach a credit to the meter. Select the credit entitlement from the dropdown.
number
wajib
The number of units that are free before credit deduction begins.
boolean
When enabled, meter usage deducts from the customer’s credit balance instead of charging per-unit.
number
wajib
The number of usage units required to deduct 1 credit. For example, if set to 1000, then 1,000 API calls consume 1 credit.
Konfigurasi meter dengan pemilihan kredit dan unit meter per kredit

Credit attached to a meter with per-unit conversion rate.

4

Configure Credit Issuance

Set the number of credits issued and optionally customize the credit settings for this product.
Konfigurasi kredit untuk produk UBB

Configure how many credits to issue and whether to use default settings.

5

Verify Attachment

Once configured, the meter shows the attached credit name, unit price, and free threshold.
Meter yang dikonfigurasi menampilkan detail lampiran kredit

Meter with credit attached showing price, threshold, and credit name.

When credits are linked to meters, the system automatically deducts credits based on ingested usage events. A background worker processes events every minute, aggregates them according to the meter’s configuration, and applies FIFO (first-in, first-out) deduction from the customer’s oldest non-expired grants.

Credit Settings

Rollover

Rollover lets unused credits carry forward to the next billing cycle instead of expiring. Example: A customer has 200 unused credits at cycle end. With 75% rollover, 150 credits carry forward and 50 are forfeited.

Overage

Overage controls what happens when a customer’s credit balance reaches zero mid-cycle. Overage Behavior options:
When overage is disabled, customers cannot use the service once their credit balance reaches zero. Choose an overage behavior that matches your billing model - Forgive at reset is the default and simplest option.

Expiration

Expired credits create a CreditExpired ledger entry. If rollover is enabled, the rollover percentage is applied before expiration, and only the remainder expires.

Usage Billing with Credits

When credits are linked to usage meters, the system creates a powerful consumption-based billing model. Customers receive a credit allocation, and usage events automatically deduct from their balance.
Dashboard Penagihan Penggunaan menampilkan tabel acara dengan kredit yang dikonsumsi

The Usage Billing dashboard shows meter events with units consumed, credits consumed, and customer details.

How Meter-Based Credit Deduction Works

  1. Aplikasi Anda mengirimkan acara penggunaan - Setiap acara mencakup ID pelanggan, nama acara, dan metadata
  2. Meters menggabungkan acara - Menggunakan agregasi Count, Sum, Max, atau Last
  3. Kredit dipotong secara otomatis - Seorang pekerja latar belakang memproses acara setiap menit, mengonversi satuan meter ke kredit menggunakan tarif yang Anda konfigurasi, dan memotong saldo pelanggan menggunakan urutan FIFO (pemberian tertua terlebih dahulu)
  4. Penggunaan berlebih dilacak - Jika saldo kredit mencapai nol dan penggunaan berlebih diaktifkan, sistem melacak penggunaan berlebih untuk penagihan akhir siklus

Meters Panel

The Usage Billing dashboard includes a Meters panel listing all defined meters with their aggregation type:

Customer Experience

Checkout

When a customer purchases a product with attached credits, the checkout page displays the included credits as part of the product offering.
Halaman pembayaran menampilkan produk dengan kredit panggilan API yang termasuk

Checkout shows included credits with the product, making the value proposition clear.

Credits appear in an Includes section below the product description, showing the credit amount and type (e.g., “$1000 API calls”).

Customer Portal

Customers can view and manage their credit balances in the Customer Portal under the Credits section.
Tampilan portal pelanggan dengan saldo dan riwayat transaksi

The Customer Portal shows available balance and full transaction history.

The portal displays:
  • Available Balance - Current credit balance displayed prominently
  • Credit Tabs - Switch between different credit types (e.g., “OpenAI Credits”, “Usage Tokens”)
  • Recent Transactions - Full history with date, transaction ID, type, amount, and running balance
Transaction types shown to customers include:

Subscription Details

The subscription detail page shows credit entitlements alongside other plan information.
Halaman detail langganan menampilkan hak dan riwayat penggunaan

Subscription details show credit allocation, remaining balance, and renewal date.

Key information displayed:
  • Credit allocation per billing cycle (e.g., “1000 credits each cycle”)
  • Remaining balance (e.g., “7500 credits remaining”)
  • Renewal date for next credit issuance
  • Usage History tab with meter-level breakdown showing units consumed, thresholds, unit prices, and total costs

Transaction Details

Payment transaction pages include an Entitlements section showing all entitlements delivered with the payment, including credits.
Halaman detail transaksi menampilkan hak kredit

Transaction details show credits alongside other entitlements like license keys and digital downloads.


Managing Credits

Dashboard Views

Credit Entitlements List

View all your credit entitlements in Products → Credits. The table shows credit name, expiry settings, and provides quick actions for editing or archiving.
Halaman daftar kredit di bagian Produk

Credits listing with total count, creation button, and management actions.

Customer Credit Details

View a specific customer’s credit balances and transaction history from Customers → [Customer Name] → Credits.
Halaman detail pelanggan dengan tab Kredit menampilkan saldo dan transaksi

Customer detail page showing credit balance and full transaction ledger.

The customer credit view includes:
  • Credit Selector - Switch between different credit entitlements
  • Available Balance - Current balance in large, prominent display
  • Apply Credit/Debit - Button to manually adjust the customer’s balance
  • Recent Transactions - Full ledger with date, transaction ID, type, amount, and running balance

Manual Adjustments

You can manually credit or debit a customer’s balance directly from the dashboard:
1

Navigate to Customer

Go to Customers and select the customer.
2

Open Credits Tab

Click the Credits tab and select the appropriate credit entitlement from the wallet selector.
3

Apply Credit or Debit

Click Apply Credit/Debit to open the adjustment interface.
string
wajib
Select Credit to add credits or Debit to remove credits from the customer’s balance.
number
wajib
The number of credits to add or remove.
string
Optional explanation for the adjustment (e.g., “Service compensation”, “Promotional bonus”).
4

Confirm

Review and apply the adjustment. The change is reflected immediately in the customer’s balance and recorded in the credit ledger.
Manual adjustments create a ManualAdjustment ledger entry with full audit trail.

Credit Ledger

Every credit operation is recorded in the credit ledger, providing a complete audit trail: Each ledger entry records the balance before and after the transaction, overage before and after, a description, and reference to the source (payment, subscription, etc.).

Webhooks

Credit-Based Billing fires webhook events for every credit lifecycle change. Use these to keep your application in sync with credit balances, trigger notifications, or build custom billing workflows. Semua acara buku besar (credit.added hingga credit.manual_adjustment) mencakup payload lengkap CreditLedgerEntry dengan saldo sebelum/sesudah, kelebihan sebelum/sesudah, referensi sumber, dan metadata dari langganan sumber hibah atau pembayaran (kosong untuk hibah yang dibuat langsung melalui API). Acara credit.balance_low mencakup konfigurasi ambang batas dan saldo saat ini.

Credit Webhook Payloads

View full payload schemas, field descriptions, and integration examples for all credit webhook events.

API Management

Use the API to create credit entitlements programmatically with full control over rollover, overage, and expiration settings.

Create Credit Entitlement

Create a new credit entitlement with rollover, overage, and expiry configuration.

List Credit Entitlements

Retrieve all credit entitlements for your business.
Retrieve, update, or delete credit entitlements. Deleted entitlements can be restored.

Get Credit Entitlement

Retrieve a specific credit entitlement by ID.

Update Credit Entitlement

Update rollover, overage, expiry, or other settings.

Delete Credit Entitlement

Soft-delete a credit entitlement.

Undelete Credit Entitlement

Restore a previously deleted credit entitlement.
Grant credits directly to a customer’s balance without requiring a purchase, or create manual debit entries for billing adjustments.

Create Ledger Entry

Credit or debit a customer’s balance with full audit trail and idempotency support.
Retrieve a customer’s current credit balance, grant history, and full ledger of transactions for any credit entitlement.

List Balances

List all customer balances for a credit entitlement.

Get Customer Balance

Get a specific customer’s balance.

List Customer Grants

View all credit grants for a customer.

List Customer Ledger

Full transaction history for a customer.

Integration Example

Inisialisasi klien Dodo Payments:
Lampirkan kredit ke produk langganan saat checkout:
Kirim event penggunaan yang secara otomatis mengurangi kredit:

Contoh Dunia Nyata

Struktur Harga:Konfigurasi:
  • Jenis Kredit: Unit Khusus (“AI Tokens”)
  • Presisi: 0 (token utuh)
  • Rollover: Maks 25%, jangka waktu 1 bulan
  • Overage: Diaktifkan, tagih overage saat penagihan
  • Meter: ai.generation dengan agregasi Sum pada bidang tokens
Struktur Harga:Konfigurasi:
  • Jenis Kredit: Unit Khusus (“API Calls”)
  • Presisi: 0 (panggilan utuh)
  • Rollover: Dinonaktifkan
  • Overage: Paket Developer+ mengizinkan overage (diampuni saat reset), paket Free menonaktifkan overage
  • Meter: api.request dengan agregasi Count
Struktur Harga:Konfigurasi:
  • Jenis Kredit: Unit Khusus (“GB-hours”)
  • Presisi: 2 (dua tempat desimal)
  • Rollover: Maks 50%, digulirkan sekali
  • Overage: Diaktifkan dengan batas 200%
  • Meter: storage.usage dengan agregasi Sum

Praktik Terbaik

  • Mulailah dengan sederhana: Mulailah dengan satu jenis kredit dan tanpa rollover. Tambahkan kompleksitas berdasarkan umpan balik pelanggan dan pola penggunaan.
  • Tetapkan ekspektasi yang jelas: Tampilkan alokasi kredit, sisa saldo, dan harga kelebihan dengan jelas di halaman produk dan portal pelanggan Anda.
  • Gunakan satuan yang bermakna: Namai kredit sesuai dengan apa yang mereka wakili (misalnya, “API Calls”, “AI Tokens”) daripada istilah umum. Ini membantu pelanggan memahami nilai.
  • Konfigurasikan kedaluwarsa dengan hati-hati: Jendela kedaluwarsa pendek (7 hari) mendorong urgensi tetapi dapat membuat pelanggan frustrasi. Jendela yang lebih panjang (30–90 hari) lebih ramah pelanggan untuk sebagian besar produk SaaS.
  • Pantau saldo rendah: Tetapkan ambang batas saldo rendah untuk memperingatkan pelanggan sebelum kehabisan, mengurangi kejutan biaya kelebihan.
  • Uji dalam mode uji: Buat kredit, lampirkan ke produk uji, dan simulasi siklus pembelian → penggunaan → pengurangan → kedaluwarsa sepenuhnya sebelum ditayangkan.
Penagihan Berbasis Kredit berfungsi dengan mulus dengan semua fitur Dodo Payments lainnya - langganan dengan uji coba, perubahan rencana dengan prorata, dan portal pelanggan. Mulailah dengan pengaturan dasar dan kembangkan saat model harga Anda berkembang.
Terakhir diubah pada 26 Juni 2026