Credit-Based Billing

​

Apa itu Penagihan Berbasis Kredit?

• 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

​

Konsep Inti

​

Jenis Kredit

​

Siklus Hidup Kredit

​

Sumber Pemberian

​

Membuat Kredit

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.

3

Set General Settings

Konfigurasikan tipe dan properti tampilan kredit:

​

Credit Type

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

​

Unit Name

string

Hanya untuk kredit Unit Kustom. Label yang dilihat pelanggan untuk kredit ini (mis., “Token AI”, “Panggilan API”). Ditampilkan di checkout dan portal pelanggan.

​

Precision

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.

​

Credit Expiry

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:

​

Rollover

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:

​

Allow Overage

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)

​

Overage Behavior

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.

​

Attaching Credits to Products

​

Subscription Products

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.

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.

You can attach up to 3 credits per product. Each credit can have its own configuration.

4

Configure Credit Settings

For each attached credit, configure:

​

Credits issued per billing cycle

number

wajib

The number of credits granted to the customer each billing period.

​

Low Balance Threshold

number

Notify when credits fall below this amount. Useful for alerting customers before they run out.

​

Credits During Free Trial

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.

​

Allow Proration

boolean

Prorate remaining credits when a customer upgrades or downgrades their subscription plan.

​

Import Default Credit Settings

boolean

Use the default rollover, overage, and expiry settings from the credit entitlement. Turn this off to customize settings specifically for this product.

5

Review and Add

Review the attached credit showing name, amount, and expiration. Click Add to Subscription to confirm.

​

One-Time Payment Products

1

Create a One-Time Product

Create a product with Single Payment pricing type.

2

Attach Credits

Open the Entitlements section and attach credits. Configure the number of credits issued (total one-time grant) on purchase.

​

Usage-Based Billing Products

1

Create a Usage-Based Product

Select Usage Based Billing as the pricing type. Configure the base price and billing frequency.

2

Add a Meter

Click the + button in the Select meter section to add a meter. A subscription can have up to 3 meters.

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.

​

Free Threshold

number

wajib

The number of units that are free before credit deduction begins.

​

Bill usage in Credits

boolean

When enabled, meter usage deducts from the customer’s credit balance instead of charging per-unit.

​

Meter units per credit

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.

4

Configure Credit Issuance

Set the number of credits issued and optionally customize the credit settings for this product.

5

Verify Attachment

Once configured, the meter shows the attached credit name, unit price, and free threshold.

​

Credit Settings

​

Rollover

​

Overage

​

Expiration

​

Usage Billing with Credits

​

How Meter-Based Credit Deduction Works

1. Your application sends usage events - Each event includes a customer ID, event name, and metadata
2. Meters aggregate events - Using Count, Sum, Max, Last, or Unique Count aggregation
3. Credits are deducted automatically - A background worker processes events every minute, converts meter units to credits using your configured rate, and deducts from the customer’s balance using FIFO ordering (oldest grants first)
4. Overage is tracked - If the credit balance reaches zero and overage is enabled, the system tracks overage usage for end-of-cycle billing

​

Meters Panel

​

Customer Experience

​

Checkout

​

Customer Portal

• 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

​

Subscription Details

• 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

​

Managing Credits

​

Dashboard Views

​

Credit Entitlements List

​

Customer Credit Details

• 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

​

Credit Ledger

​

Webhooks

​

API Management

​

Integration Example

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Contoh Dunia Nyata

​

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.