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?

Hybrid billing menggabungkan beberapa dimensi harga ke dalam satu penawaran produk. Alih-alih memilih antara subscription tarif tetap atau pricing 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. Subscription + Usage	Biaya dasar + biaya konsumsi	$49/bln + $0.01/panggilan API setelah 10K gratis	✅ Penuh
2. Subscription + Seats	Biaya platform + biaya per pengguna	$99/bln + $15/seat	✅ Penuh
3. Subscription + Feature Add-ons	Paket inti + upgrade opsional	$29/bln + $19/bln analytics + $9/bln akses API	✅ Penuh
4. Seats + Usage	Biaya per pengguna + kelebihan konsumsi	$10/pengguna/bln + $0.05/GB setelah 5GB/pengguna	⚠️ Solusi alternatif
5. Subscription + Seats + Usage	Platform + pengguna + konsumsi	$199/bln + $20/seat + kelebihan penggunaan	⚠️ Solusi alternatif
6. Tiered Base + Usage Overage	Tingkatan berbeda dengan alokasi berbeda	Starter (5K panggilan) vs Pro (50K panggilan) + kelebihan penggunaan	✅ Penuh
7. Subscription + On-Demand Charges	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):

Subscription 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 ${process.env.DODO_PAYMENTS_API_KEY}`,
    '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 Team: $99/bulan + $15/seat

Biaya platform dasar: $99/bulan (termasuk 3 seat)
Seat tambahan: $15/seat/bulan

Contoh perhitungan (tim yang terdiri dari 12 pengguna):

Biaya platform: $99.00
Seat 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 Team: $99/bulan

Termasuk: 5 seat
Seat tambahan: $15/seat/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 Core: $29/bulan Add-on Opsional:

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

Contoh perhitungan (pelanggan memilih Core + Analytics + Akses API):

Paket Core: $29.00
Analytics: $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/pengguna/bulan Setiap pengguna mencakup:

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

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

Biaya seat: 10 × $20 = $200.00
Data yang termasuk: 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.addon_id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer.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

Biaya Platform: $199/bulan
Per Seat: $25/pengguna/bulan
Penggunaan: $0.10/1000 panggilan API (termasuk 50K)

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

Platform: $199.00
Seat: 20 × $25 = $500.00
Penggunaan: (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 ${process.env.DODO_PAYMENTS_API_KEY}`,
    '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

Tier	Harga	Panggilan yang Termasuk	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

Biaya On-Demand (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.

// Note: POST /subscriptions is deprecated — prefer checkout sessions for new integrations
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:

Subscription Dasar: $99/bulan (akses platform, termasuk 5 seat)
Add-on Seat: $20/seat/bulan
Add-on Fitur: Custom Models ($49/bln), Akses API ($29/bln), Priority Queue ($19/bln)
Kelebihan Penggunaan: $0.02 per 1.000 token setelah 100K (dibebankan melalui on-demand)

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

Komponen	Perhitungan	Jumlah
Dasar	Biaya platform	$99
Seat tambahan	7 × $20	$140
Custom Models	Add-on	$49
Akses API	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	termasuk 5	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-on (jika menggunakan Opsi B):

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

Contoh 3: Otomatisasi Marketing

Struktur Harga:

Dasar: $79/bulan (fitur automasi inti, termasuk 3 seat)
Tier Kontak (add-on): termasuk 1K, 5K (+$30), 25K (+$80), 100K (+$200)
Add-on Fitur: SMS Marketing ($29/bln), Landing Pages ($19/bln), A/B Testing ($29/bln)
Seat Tim: add-on $15/pengguna/bulan
Volume Email: Lacak di aplikasi, kenakan biaya kelebihan penggunaan melalui on-demand ($1/1.000 email di atas batas)

Implementasi: Gunakan subscription dengan add-on tier kontak, add-on fitur, dan add-on seat. Lacak pengiriman email di aplikasi Anda dan kenakan biaya kelebihan penggunaan melalui biaya on-demand pada akhir siklus billing.

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.

Jelas: “$49/bulan mencakup 10.000 panggilan API. Panggilan tambahan: $0.005 per panggilan” Tidak jelas: “$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 Tagihan	Jumlah
Paket Pro (Bulanan)	$49.00
Seat Tambahan (7 × $15.00)	$105.00
Penggunaan API - Termasuk (10.000 panggilan)	$0.00
Penggunaan API - Kelebihan (15,420 panggilan × $0.005)	$77.10
Add-on Analytics Lanjutan	$19.00
Subtotal	$250.10
Pajak (8.5%)	$21.26
Total yang Harus Dibayar	$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