Model Penagihan Hibrida - Dodo Payments Documentation

Penagihan hibrida menggabungkan dua atau lebih model penagihan menjadi satu strategi harga. Dengan demikian, Anda dapat menangkap nilai dari berbagai dimensi—biaya berulang, penggunaan, kursi, dan fitur—sekaligus memberikan fleksibilitas dan prediktabilitas kepada pelanggan.

Usage-Based Billing

Dasar untuk harga berbasis konsumsi.

Subscriptions

Dasar untuk penagihan berulang.

Add-ons

Perluas langganan dengan upgrade opsional.

Seat-Based Billing

Model harga per pengguna.

Apa itu Penagihan Hibrida?

Penagihan hibrida menggabungkan beberapa dimensi harga ke dalam satu penawaran produk. Alih-alih memilih antara langganan tarif tetap ATAU harga berbasis penggunaan, Anda menggunakan keduanya secara bersamaan.

Mengapa Menggunakan Penagihan Hibrida?

Tujuan Bisnis	Solusi Hibrida
Pendapatan yang dapat diprediksi + peluang pertumbuhan	Langganan dasar + kelebihan penggunaan
Harga tim yang dapat diskalakan	Per kursi + add-on fitur
Mendapatkan pelanggan, memperluas layanan kemudian	Biaya dasar rendah + biaya konsumsi
Fleksibilitas perusahaan	Pengeluaran berkomitmen + biaya sesuai permintaan
Harga yang adil untuk penggunaan variabel	Kuota yang disertakan + bayar sesuai penggunaan

Pola Hibrida Umum

Model	Deskripsi	Contoh	Dukungan Native
1. Langganan + Penggunaan	Biaya dasar + biaya konsumsi	$49/bln + $0.01/panggilan API setelah 10K gratis	✅ Penuh
2. Langganan + Kursi	Biaya platform + biaya per pengguna	$99/bln + $15/kursi	✅ Penuh
3. Langganan + Add-on Fitur	Paket inti + upgrade opsional	$29/bln + $19/bln analitik + $9/bln akses API	✅ Penuh
4. Kursi + Penggunaan	Biaya per pengguna + kelebihan konsumsi	$10/pengguna/bln + $0.05/GB setelah 5GB/pengguna	⚠️ Solusi alternatif
5. Langganan + Kursi + Penggunaan	Platform + pengguna + konsumsi (hibrida tiga komponen)	$199/bln + $20/kursi + kelebihan penggunaan	⚠️ Solusi alternatif
6. Dasar Bertingkat + Kelebihan Penggunaan	Tingkatan berbeda dengan kuota berbeda	Starter (5K panggilan) vs Pro (50K panggilan) + kelebihan penggunaan	✅ Penuh
7. Langganan + Biaya Sesuai Permintaan	Biaya berulang + biaya manual variabel	Retainer $99/bln + penagihan per jam untuk pekerjaan	✅ Penuh

Model Hibrida 1: Langganan + Penggunaan

Model hibrida yang paling umum. Pelanggan membayar biaya langganan dasar ditambah biaya untuk konsumsi yang melebihi kuota yang disertakan.

Cara Kerjanya

Paket Pro: $49/bulan

Termasuk: 10.000 panggilan API/bulan
Kelebihan penggunaan: $0.005 per panggilan setelah 10.000

Contoh perhitungan (pelanggan menggunakan 25.000 panggilan bulan ini):

Langganan dasar: $49.00
Kelebihan penggunaan: (25.000 - 10.000) × $0.005 =$ 75.00
Total: $124.00

Kasus Penggunaan

Platform API: Akses dasar + biaya per permintaan
Layanan AI/ML: Langganan + penggunaan token/generasi
Layanan penyimpanan: Paket dasar + kelebihan penggunaan per GB
Platform komunikasi: Biaya dasar + biaya per pesan/menit

Implementasi

Create Usage Meter

Siapkan meter untuk melacak dimensi penggunaan yang dapat ditagihkan.

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count
This tracks API calls per customer

Create Subscription Product with Usage Pricing

Buat produk langganan dan lampirkan meter penggunaan beserta harganya.

Dashboard: Create Product → Subscription
Name: "Pro Plan"
Base Price: $49/month

Then attach usage pricing:
- Meter: api.call
- Price per unit: $0.005
- Free threshold: 10,000 (included in subscription)

Meter penggunaan dilampirkan langsung ke produk langganan. Biaya penggunaan dihitung dan ditambahkan ke invoice langganan secara otomatis.

Create Checkout Session

Buat sesi checkout dengan produk langganan Anda.

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

Send Usage Events

Lacak penggunaan selama periode penagihan.

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `call_${Date.now()}`,
      customer_id: 'cus_123',
      event_name: 'api.call',
      timestamp: new Date().toISOString(),
      metadata: { endpoint: '/v1/generate' }
    }]
  })
});

Variasi Harga

Included Allowance
Zero Base + Pure Usage
Tiered Allowances

Ambang batas gratis mencakup penggunaan yang disertakan dalam langganan dasar.Paket Pro: $49/bulan

Termasuk: 10.000 panggilan API
Kelebihan penggunaan: $0.005/panggilan setelah 10.000
Pelanggan menggunakan 8.000 → Membayar $49 (tanpa kelebihan penggunaan)

Model Hibrida 2: Langganan + Kursi

Biaya platform ditambah biaya per pengguna. Ideal untuk alat kolaborasi tim dan SaaS B2B.

Cara Kerjanya

Paket Tim: $99/bulan +$ 15/kursi

Biaya platform dasar: $99/bulan (termasuk 3 kursi)
Kursi tambahan: $15/kursi/bulan

Contoh perhitungan (tim yang terdiri dari 12 pengguna):

Biaya platform: $99.00
Kursi tambahan: (12 - 3) × $15 =$ 135.00
Total: $234.00/bulan

Kasus Penggunaan

Alat kolaborasi: Biaya ruang kerja + per anggota
Sistem CRM: Lisensi platform + per perwakilan penjualan
Manajemen proyek: Paket tim + per kontributor
Alat developer: Biaya organisasi + per developer

Implementasi

Create Seat Add-on

Buat add-on untuk kursi tambahan.

Dashboard: Products → Add-ons → Create Add-on
Name: "Additional Seat"
Price: $15/month
Description: "Add another team member"

Create Base Subscription

Buat produk langganan dengan biaya platform dan lampirkan add-on.

Dashboard: Create Product → Subscription
Name: "Team Plan"
Price: $99/month
Description: "Includes 3 team members"

Then in Add-ons section:
- Attach: "Additional Seat" add-on

Create Checkout with Seats

Tentukan jumlah kursi selama checkout.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'pdt_team_plan',
    quantity: 1,
    addons: [{
      addon_id: 'addon_seat',
      quantity: 9  // 9 extra seats (12 total with 3 included)
    }]
  }],
  customer: { email: 'admin@company.com' },
  return_url: 'https://yourapp.com/success'
});

Adjust Seats as Needed

Tambahkan atau hapus kursi pada langganan yang sudah ada.

// Add 5 more seats
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_team_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [{
    addon_id: 'addon_seat',
    quantity: 14  // New total: 14 extra seats
  }]
});

Variasi Harga

Included Seats
Pure Per-Seat
Tiered Per-Seat

Paket dasar mencakup beberapa kursi; kenakan biaya untuk kursi tambahan.Paket Tim: $99/bulan

Termasuk: 5 kursi
Kursi tambahan: $15/kursi/bulan
20 pengguna = $99 + (15 × $15) = $324/bulan

Model Hibrida 3: Langganan + Add-on Fitur

Langganan inti dengan upgrade fitur opsional yang dapat ditambahkan oleh pelanggan.

Cara Kerjanya

Paket Inti: $29/bulan Add-on Opsional:

Analitik Lanjutan: +$19/bulan
Akses API: +$9/bulan
Dukungan Prioritas: +$29/bulan
White-label: +$49/bulan

Contoh perhitungan (pelanggan memilih Inti + Analitik + Akses API):

Paket inti: $29.00
Analitik: $19.00
Akses API: $9.00
Total: $57.00/bulan

Kasus Penggunaan

Platform SaaS: Fitur inti + modul premium
Alat pemasaran: Alat dasar + integrasi
Produk analitik: Dasbor + laporan lanjutan
Perangkat lunak keamanan: Perlindungan dasar + fitur lanjutan

Implementasi

Create Feature Add-ons

Buat add-on untuk setiap fitur opsional.

# Add-on 1: Advanced Analytics
Dashboard: Products → Add-ons → Create Add-on
Name: "Advanced Analytics"
Price: $19/month

# Add-on 2: API Access
Name: "API Access"
Price: $9/month

# Add-on 3: Priority Support
Name: "Priority Support"
Price: $29/month

# Add-on 4: White-label
Name: "White-label"
Price: $49/month

Create Core Subscription

Tentukan langganan dasar Anda dan lampirkan semua add-on fitur.

Dashboard: Create Product → Subscription
Name: "Core Plan"
Price: $29/month

Then in Add-ons section:
- Attach all feature add-ons

Let Customers Choose

Lakukan checkout dengan fitur yang dipilih.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'pdt_core_plan',
    quantity: 1,
    addons: [
      { addon_id: 'addon_analytics', quantity: 1 },
      { addon_id: 'addon_api_access', quantity: 1 }
      // Customer didn't select support or white-label
    ]
  }],
  return_url: 'https://yourapp.com/success'
});

Add Features Later

Pelanggan dapat menambahkan fitur ke langganan yang sudah ada.

// Customer wants to add Priority Support
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_core_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [
    { addon_id: 'addon_analytics', quantity: 1 },
    { addon_id: 'addon_api_access', quantity: 1 },
    { addon_id: 'addon_priority_support', quantity: 1 }  // New!
  ]
});

Model Hibrida 4: Kursi + Penggunaan

Biaya per pengguna yang digabungkan dengan biaya berbasis konsumsi. Setiap pengguna mendapatkan kuota.

Batasan: Dodo Payments saat ini tidak mendukung pelampiran meter penggunaan dan add-on secara bersamaan ke produk langganan yang sama. Model ini memerlukan solusi alternatif menggunakan logika tingkat aplikasi.

Cara Kerjanya

Team Analytics: $20/user/month Setiap pengguna mencakup:

Pemrosesan data 5 GB/bulan
Kelebihan penggunaan: $2/GB setelah kuota

Contoh perhitungan (tim dengan 10 pengguna menggunakan total 80 GB):

Biaya seat: 10 × $20 =$ 200.00
Data yang disertakan: 10 × 5 GB = 50 GB
Kelebihan penggunaan: (80 - 50) × $2 =$ 60.00
Total: $260.00/bulan

Kasus Penggunaan

Platform analytics: Per-analyst + pemrosesan data
Alat desain: Per-designer + penyimpanan/ekspor
Lingkungan pengembangan: Per-developer + jam komputasi
Alat komunikasi: Per-user + volume pesan/panggilan

Opsi Implementasi

Karena Anda tidak dapat melampirkan usage meters dan add-ons sekaligus ke subscription yang sama, pilih salah satu pendekatan berikut:

Option A: Usage Product + App-Managed Seats
Option B: Seat Add-on + On-Demand Usage Charges

Gunakan subscription berbasis penggunaan dan kelola penagihan seat di aplikasi Anda.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "data.processed"
Aggregation: Sum
Property: "bytes"

Create Usage-Based Subscription

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach usage pricing:
- Meter: data.processed
- Price per unit: $2/GB
- Free threshold: 0 (managed by your app)

Manage Seats in Your Application

Lacak jumlah seat dan hitung biaya seat secara terpisah.

// Your application tracks seats and calculates total cost
async function calculateMonthlyBill(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const seatFee = seatCount * 20; // $20/seat

  // Usage is billed by Dodo automatically
  // You invoice/charge seat fees separately or include in base price

  // Alternatively, adjust base subscription price when seats change
  const totalBasePrice = seatCount * 2000; // $20/seat in cents
  await client.subscriptions.update('sub_123', {
    // Update subscription to reflect seat-based pricing
  });
}

Calculate Dynamic Free Threshold

Sesuaikan penggunaan yang disertakan berdasarkan jumlah seat.

// When checking usage, apply per-seat allowance
async function checkUsageOverage(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const includedGB = seatCount * 5; // 5 GB per user

  const currentUsage = await getUsageFromDodo(customerId);
  const overage = Math.max(0, currentUsage - includedGB);

  // Overage is billed by Dodo at $2/GB
  return { included: includedGB, used: currentUsage, overage };
}

Gunakan add-ons untuk seat dan kenakan biaya penggunaan secara manual melalui on-demand charges.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "Team Member"
Price: $20/month

Create Subscription with Add-on

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach add-on:
- "Team Member" add-on

Enable on-demand charging

Track Usage in Your Application

// Track usage events in your system
async function trackDataProcessed(customerId: string, bytes: number) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'data.processed',
    bytes: bytes,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

Hitung dan kenakan biaya kelebihan penggunaan secara manual.

async function billUsageOverage(subscriptionId: string) {
  const subscription = await getSubscription(subscriptionId);
  const seatCount = subscription.addons.find(a => a.id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer_id);
  const overageGB = Math.max(0, usedGB - includedGB);

  if (overageGB > 0) {
    const overageCharge = overageGB * 200; // $2/GB in cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `Data overage: ${overageGB} GB × $2/GB`
    });
  }
}

Rekomendasi: Opsi B (Seat Add-on + On-Demand Usage) sering kali lebih mudah diimplementasikan karena Dodo menangani penagihan seat secara otomatis. Anda hanya perlu melacak dan mengenakan biaya atas kelebihan penggunaan.

Model Hybrid 5: Subscription + Seats + Usage (Triple Hybrid)

Model paling komprehensif: biaya platform + per-user + konsumsi.

Batasan: Dodo Payments saat ini tidak mendukung pelampiran usage meters dan add-ons sekaligus ke subscription product yang sama. Model ini memerlukan pendekatan workaround.

Cara Kerjanya

Enterprise Platform

Platform Fee: $199/bulan
Per Seat: $25/user/bulan
Usage: $0.10/1000 API calls (50K disertakan)

Contoh perhitungan (perusahaan dengan 20 pengguna, 150.000 API calls):

Platform: $199.00
Seat: 20 × $25 =$ 500.00
Usage: (150K - 50K) × $0.10/1K = $10.00
Total: $709.00/bulan

Kasus Penggunaan

Enterprise SaaS: Platform + tim + konsumsi
Platform data: Workspace + analyst + query
Platform integrasi: Hub + connector + transaksi
Platform AI: Workspace + developer + inference

Opsi Implementasi

Pilih salah satu pendekatan berikut untuk mengimplementasikan penagihan triple hybrid:

Option A: Base + Seats (Add-on) + On-Demand Usage
Option B: Base + Usage (Meter) + App-Managed Seats

Gunakan subscription dengan seat add-ons, lalu kenakan biaya penggunaan secara manual melalui on-demand charges.Ini adalah pendekatan yang direkomendasikan karena Dodo menangani biaya platform dan penagihan seat secara otomatis.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "User Seat"
Price: $25/month

Create Subscription Product

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach add-on:
- "User Seat" add-on

Enable on-demand charging

Create Checkout with Seats

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'pdt_enterprise_platform',
    quantity: 1,
    addons: [{
      addon_id: 'addon_user_seat',
      quantity: 20  // 20 users
    }]
  }],
  customer: { email: 'enterprise@company.com' },
  return_url: 'https://yourapp.com/success'
});

Track Usage in Your Application

Simpan usage events di sistem Anda.

// Track API calls in your system
async function trackApiCall(customerId: string, endpoint: string) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'api.call',
    endpoint: endpoint,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

Hitung dan kenakan biaya kelebihan penggunaan melalui on-demand charge.

async function billUsageOverage(subscriptionId: string) {
  const usage = await calculatePeriodUsage(subscriptionId);
  const includedCalls = 50000;
  const overageCalls = Math.max(0, usage.totalCalls - includedCalls);

  if (overageCalls > 0) {
    // $0.10 per 1000 calls = $0.0001 per call
    const overageCharge = Math.ceil(overageCalls / 1000) * 10; // cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `API usage: ${overageCalls.toLocaleString()} calls over 50K included`
    });
  }
}

Gunakan subscription dengan usage meter, lalu kelola penagihan seat di aplikasi Anda.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count

Create Subscription Product with Usage

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach usage pricing:
- Meter: api.call
- Price: $0.10 per 1000 calls
- Free threshold: 50,000

Manage Seats in Your Application

Lacak jumlah seat dan sesuaikan harga subscription dasar.

// When seats change, update subscription price
async function updateSeatCount(subscriptionId: string, newSeatCount: number) {
  const basePlatformFee = 19900; // $199 in cents
  const perSeatFee = 2500; // $25 in cents
  const totalPrice = basePlatformFee + (newSeatCount * perSeatFee);

  // Store seat count in your system
  await updateSeatsInDatabase(subscriptionId, newSeatCount);

  // Note: You may need to handle this via plan changes or
  // create multiple tier products for common seat counts
}

Send Usage Events to Dodo

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `api_${Date.now()}`,
      customer_id: 'cus_enterprise',
      event_name: 'api.call',
      timestamp: new Date().toISOString()
    }]
  })
});

Rekomendasi: Opsi A (Base + Seats + On-Demand Usage) umumnya lebih mudah karena Dodo menangani penagihan platform dan seat secara otomatis. Anda hanya perlu melacak penggunaan dan mengirimkan charges di akhir setiap siklus penagihan.

Model Hybrid 6: Base Bertingkat + Kelebihan Penggunaan

Tingkat subscription yang berbeda dengan kuota yang disertakan dan tarif kelebihan penggunaan yang berbeda.

Cara Kerjanya

Tingkat	Harga	Panggilan yang Disertakan	Tarif Kelebihan Penggunaan
Starter	$19/bulan	1,000	$0.02/panggilan
Pro	$79/bulan	25,000	$0.01/panggilan
Business	$199/bulan	100,000	$0.005/panggilan
Enterprise	$499/bulan	500,000	$0.002/panggilan

Implementasi

Buat subscription product terpisah untuk setiap tingkat, masing-masing dengan konfigurasi penggunaan sendiri:

# For each tier, create a subscription product:

# Starter Tier
Dashboard: Create Product → Subscription
Name: "Starter"
Base Price: $19/month
Usage Pricing:
- Meter: api.call
- Price: $0.02/call
- Free threshold: 1,000

# Pro Tier
Name: "Pro"
Base Price: $79/month
Usage Pricing:
- Meter: api.call
- Price: $0.01/call
- Free threshold: 25,000

# ... and so on for Business and Enterprise

Jalur Upgrade

Saat pelanggan melakukan upgrade tingkat, mereka mendapatkan:

Kuota yang disertakan lebih tinggi
Tarif kelebihan penggunaan lebih rendah
Nilai lebih besar untuk setiap dolar

// Customer upgrades from Starter to Pro
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

Model Hybrid 7: Subscription + On-Demand Charges

Subscription berulang ditambah charges manual variabel untuk layanan atau kelebihan penggunaan.

Cara Kerjanya

Paket Retainer: $199/bulan Mencakup:

Akses platform
5 jam konsultasi/bulan
Dukungan email

On-Demand Charges (sesuai kebutuhan):

Konsultasi tambahan: $150/jam
Pengembangan khusus: $200/jam
Dukungan darurat: $100/insiden

Contoh perhitungan (bulan ini):

Retainer: $199.00
3 jam konsultasi tambahan: $450.00
1 dukungan darurat: $100.00
Total: $749.00

Kasus Penggunaan

Layanan konsultasi: Retainer + penagihan per jam
Layanan terkelola: Biaya dasar + biaya insiden
Layanan agensi: Biaya bulanan + biaya proyek
Paket dukungan: Biaya SLA + per-tiket atau per-jam

Implementasi

Create On-Demand Subscription

Siapkan subscription dengan on-demand charging yang diaktifkan.

const subscription = await client.subscriptions.create({
  billing: {
    city: 'San Francisco',
    country: 'US',
    state: 'CA',
    street: '123 Main St',
    zipcode: '94105'
  },
  customer: { customer_id: 'cus_123' },
  product_id: 'pdt_retainer',
  quantity: 1,
  payment_link: true,
  return_url: 'https://yourapp.com/success',
  on_demand: {
    mandate_only: false,
    product_price: 19900  // $199 initial charge
  }
});

Charge for Services

Buat charges saat layanan diberikan.

// Charge for 3 hours of consulting
await client.subscriptions.charge('sub_123', {
  product_price: 45000,  // $450.00 (3 × $150)
  product_description: 'Consulting - 3 hours (March 15)'
});

// Charge for emergency support incident
await client.subscriptions.charge('sub_123', {
  product_price: 10000,  // $100.00
  product_description: 'Emergency support - Server outage (March 18)'
});

Track and Invoice

Semua charges muncul pada invoice pelanggan.

// Retrieve subscription charges
const payments = await client.payments.list({
  subscription_id: 'sub_123'
});

// Show itemized breakdown to customer
payments.items.forEach(payment => {
  console.log(`${payment.payment_id}: $${payment.total_amount / 100}`);
});

Contoh di Dunia Nyata

Contoh-contoh ini menunjukkan struktur harga yang ideal. Karena usage meters dan add-ons tidak dapat dilampirkan ke product yang sama, beberapa kombinasi memerlukan workaround (menggunakan on-demand charges untuk penggunaan atau seat yang dikelola aplikasi).

Contoh 1: Platform AI SaaS

Struktur Harga:

Base Subscription: $99/bulan (akses platform, 5 seat disertakan)
Seat Add-on: $20/seat/bulan
Feature Add-ons: Custom Models ($49/bulan), API Access ($29/bulan), Priority Queue ($19/bulan)
Kelebihan Penggunaan: $0.02 per 1,000 token setelah 100K (dikenakan melalui on-demand)

Implementasi: Gunakan subscription dengan seat dan feature add-ons. Lacak penggunaan token di aplikasi Anda dan kenakan biaya kelebihan penggunaan melalui on-demand charges di akhir siklus penagihan. Contoh Pelanggan (12 pengguna, 500K token, Custom Models + API Access):

Komponen	Perhitungan	Jumlah
Base	Biaya platform	$99
Seat tambahan	7 × $20	$140
Custom Models	Add-on	$49
API Access	Add-on	$29
Kelebihan token	400K × $0.02/1K (on-demand)	$8
Total		$325/bulan

Contoh 2: Platform Alat Developer

Opsi Tingkat:

	Gratis	Pro	Enterprise
Harga	$0/bulan	$29/bulan	$199/bulan
Pengguna	1	5 disertakan	Tidak terbatas
Build	100	1,000	10,000
Penyimpanan	1 GB	10 GB	100 GB

Opsi Implementasi: Opsi A (Berfokus pada penggunaan): Buat product dengan usage meters untuk build/penyimpanan. Kelola pengguna di aplikasi Anda. Opsi B (Berfokus pada seat): Buat product dengan seat add-ons. Lacak penggunaan build/penyimpanan dan kenakan biaya kelebihan penggunaan melalui on-demand. Add-ons (jika menggunakan Opsi B):

Pengguna tambahan: $10/user/bulan
Build prioritas: $19/bulan
Domain khusus: $9/domain/bulan

Contoh 3: Otomatisasi Marketing

Struktur Harga:

Base: $79/bulan (fitur otomatisasi inti, 3 seat disertakan)
Tingkat Kontak (add-ons): 1K disertakan, 5K (+$30), 25K (+$80), 100K (+$200)
Feature Add-ons: SMS Marketing ($29/bulan), Landing Pages ($19/bulan), A/B Testing ($29/bulan)
Seat Tim: add-on $15/user/bulan
Volume Email: Lacak di aplikasi, kenakan biaya kelebihan penggunaan melalui on-demand ($1/1.000 email di atas batas)

Implementasi: Gunakan subscription dengan contact tier add-ons, feature add-ons, dan seat add-ons. Lacak pengiriman email di aplikasi Anda dan kenakan biaya kelebihan penggunaan melalui on-demand charges.

Praktik Terbaik Implementasi

Kejelasan Halaman Harga

Buat harga hybrid mudah dipahami. Tampilkan biaya dasar, hal-hal yang disertakan, dan cara kerja kelebihan penggunaan secara jelas di halaman harga Anda.

Baik: “$49/bulan mencakup 10.000 API calls. Panggilan tambahan: $0.005 per panggilan” Buruk: “$49/bulan + biaya penggunaan”

Prediktabilitas Biaya

Bantu pelanggan memperkirakan biaya mereka:

// Provide a cost calculator
function estimateMonthlyCost({
  plan,
  seats,
  expectedUsage,
  addons
}: EstimateParams): number {
  let total = plan.basePrice;

  // Add seat costs
  const extraSeats = Math.max(0, seats - plan.includedSeats);
  total += extraSeats * plan.seatPrice;

  // Add usage overage
  const overage = Math.max(0, expectedUsage - plan.includedUsage);
  total += overage * plan.overageRate;

  // Add feature add-ons
  total += addons.reduce((sum, addon) => sum + addon.price, 0);

  return total;
}

Visibilitas Penggunaan

Tampilkan penggunaan pelanggan secara real-time:

// Display usage dashboard
async function getUsageSummary(subscriptionId: string) {
  const usage = await client.subscriptions.retrieveUsageHistory(subscriptionId);

  // Each item is a billing period; each meter reports its usage for that period.
  const latestPeriod = usage.items[0];

  return latestPeriod.meters.map((meter) => {
    const consumed = Number(meter.consumed_units);
    const chargeable = Number(meter.chargeable_units);
    return {
      meter: meter.name,
      current: consumed,
      included: meter.free_threshold,
      remaining: Math.max(0, meter.free_threshold - consumed),
      overage: chargeable,
      cost: meter.total_price
    };
  });
}

Transparansi Penagihan

Sediakan invoice terperinci yang menampilkan semua komponen:

Item Baris	Jumlah
Pro Plan (Bulanan)	$49.00
Seat Tambahan (7 × $15.00)	$105.00
Penggunaan API - Disertakan (10.000 panggilan)	$0.00
Penggunaan API - Kelebihan (15.420 panggilan × $0.005)	$77.10
Advanced Analytics Add-on	$19.00
Subtotal	$250.10
Pajak (8.5%)	$21.26
Total Jatuh Tempo	$271.36

Pemecahan Masalah Penagihan Hybrid

Usage not being tracked correctly

Gejala: Penggunaan menampilkan nilai 0 atau nilai yang salah.Solusi:

Verifikasi bahwa event ingestion berfungsi (periksa respons API)
Pastikan customer_id sesuai dengan customer subscription
Periksa bahwa event_name sesuai dengan konfigurasi meter
Verifikasi bahwa event memiliki timestamp yang benar (bukan bertanggal di masa depan)

Proration confusion with multiple components

Gejala: Pelanggan dikenai jumlah yang tidak terduga saat mengubah plan.Solusi:

Gunakan API previewChangePlan untuk menampilkan biaya yang tepat sebelum konfirmasi
Sampaikan bahwa proration berlaku untuk subscription DAN add-ons
Pertimbangkan menggunakan difference_immediately untuk penagihan upgrade yang lebih sederhana

Free threshold not applying correctly

Gejala: Pelanggan dikenai biaya untuk penggunaan yang seharusnya gratis.Solusi:

Verifikasi bahwa free threshold dikonfigurasi pada product berbasis penggunaan
Periksa bahwa unit threshold sesuai dengan agregasi event (calls vs. requests)
Pastikan usage meter terlampir dengan benar pada subscription product

Add-ons not appearing in checkout

Gejala: Tidak dapat menambahkan seat atau fitur selama checkout.Solusi:

Verifikasi bahwa add-ons terlampir pada subscription product di dashboard
Periksa bahwa add-on IDs sudah benar dalam API calls
Pastikan mata uang add-on sesuai dengan mata uang subscription product

Dokumentasi Terkait

Products

Ringkasan semua jenis product dan panduan.

Usage-Based Billing Guide

Implementasi usage billing lengkap.

Subscription Management

Mengelola subscription berulang.

Add-ons

Memperluas subscription dengan add-ons.

Usage-Based Billing

Subscriptions

Add-ons

Seat-Based Billing

​Apa itu Penagihan Hibrida?

​Mengapa Menggunakan Penagihan Hibrida?

​Pola Hibrida Umum

​Model Hibrida 1: Langganan + Penggunaan

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Variasi Harga

​Model Hibrida 2: Langganan + Kursi

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Variasi Harga

​Model Hibrida 3: Langganan + Add-on Fitur

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Model Hibrida 4: Kursi + Penggunaan

​Cara Kerjanya

​Kasus Penggunaan

​Opsi Implementasi

​Model Hybrid 5: Subscription + Seats + Usage (Triple Hybrid)

​Cara Kerjanya

​Kasus Penggunaan

​Opsi Implementasi

​Model Hybrid 6: Base Bertingkat + Kelebihan Penggunaan

​Cara Kerjanya

​Implementasi

​Jalur Upgrade

​Model Hybrid 7: Subscription + On-Demand Charges

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Contoh di Dunia Nyata

​Contoh 1: Platform AI SaaS

​Contoh 2: Platform Alat Developer

​Contoh 3: Otomatisasi Marketing

​Praktik Terbaik Implementasi

​Kejelasan Halaman Harga

​Prediktabilitas Biaya

​Visibilitas Penggunaan

​Transparansi Penagihan

​Pemecahan Masalah Penagihan Hybrid

​Dokumentasi Terkait

Products

Usage-Based Billing Guide

Subscription Management

Add-ons

Apa itu Penagihan Hibrida?

Mengapa Menggunakan Penagihan Hibrida?

Pola Hibrida Umum

Model Hibrida 1: Langganan + Penggunaan

Cara Kerjanya

Kasus Penggunaan

Implementasi

Variasi Harga

Model Hibrida 2: Langganan + Kursi

Cara Kerjanya

Kasus Penggunaan

Implementasi

Variasi Harga

Model Hibrida 3: Langganan + Add-on Fitur

Cara Kerjanya

Kasus Penggunaan

Implementasi

Model Hibrida 4: Kursi + Penggunaan

Cara Kerjanya

Kasus Penggunaan

Opsi Implementasi

Model Hybrid 5: Subscription + Seats + Usage (Triple Hybrid)

Cara Kerjanya

Kasus Penggunaan

Opsi Implementasi

Model Hybrid 6: Base Bertingkat + Kelebihan Penggunaan

Cara Kerjanya

Implementasi

Jalur Upgrade

Model Hybrid 7: Subscription + On-Demand Charges

Cara Kerjanya

Kasus Penggunaan

Implementasi

Contoh di Dunia Nyata

Contoh 1: Platform AI SaaS

Contoh 2: Platform Alat Developer

Contoh 3: Otomatisasi Marketing

Praktik Terbaik Implementasi

Kejelasan Halaman Harga

Prediktabilitas Biaya

Visibilitas Penggunaan

Transparansi Penagihan

Pemecahan Masalah Penagihan Hybrid

Dokumentasi Terkait