Model Penagihan Hibrida - Dodo Payments Documentation

Penagihan hibrida menggabungkan dua atau lebih model penagihan menjadi satu strategi harga. Ini memungkinkan Anda menangkap nilai dari berbagai dimensi—biaya berulang, penggunaan, kursi, dan fitur—sambil memberikan fleksibilitas dan kepastian kepada pelanggan.

Penagihan Berdasarkan Penggunaan

Dasar untuk penetapan harga berbasis konsumsi.

Langganan

Dasar untuk penagihan berulang.

Tambahan

Perluas langganan dengan peningkatan opsional.

Penagihan Berdasarkan Kursi

Model harga per pengguna.

Apa itu Penagihan Hibrida?

Penagihan hibrida menggabungkan beberapa dimensi harga menjadi satu penawaran produk. Alih-alih memilih antara langganan tarif tetap ATAU harga berbasis penggunaan, Anda menggunakan keduanya bersama-sama.

Mengapa Menggunakan Penagihan Hibrida?

Tujuan Bisnis	Solusi Hibrida
Pendapatan yang dapat diprediksi + potensi pertumbuhan	Langganan dasar + kelebihan penggunaan
Harga tim yang dapat diskalakan	Per-kursi + tambahan fitur
Menarik pelanggan, memperluas nanti	Biaya dasar rendah + biaya konsumsi
Fleksibilitas perusahaan	Pengeluaran yang terikat + biaya sesuai permintaan
Harga yang adil untuk penggunaan variabel	Alokasi yang termasuk + bayar sesuai penggunaan

Pola Hibrida Umum

Model	Deskripsi	Contoh	Dukungan Asli
1. Langganan + Penggunaan	Biaya dasar + biaya konsumsi	$49/bulan + $0.01/panggilan API setelah 10K gratis	✅ Penuh
2. Langganan + Kursi	Biaya platform + biaya per pengguna	$99/bulan + $15/kursi	✅ Penuh
3. Langganan + Tambahan Fitur	Rencana inti + peningkatan opsional	$29/bulan + $19/bulan analitik + $9/bulan akses API	✅ Penuh
4. Kursi + Penggunaan	Biaya per pengguna + kelebihan konsumsi	$10/pengguna/bulan + $0.05/GB setelah 5GB/pengguna	⚠️ Solusi Sementara
5. Langganan + Kursi + Penggunaan	Platform + pengguna + konsumsi (hibrida tiga)	$199/bulan + $20/kursi + kelebihan penggunaan	⚠️ Solusi Sementara
6. Dasar Bertingkat + Kelebihan Penggunaan	Tingkatan berbeda dengan alokasi berbeda	Starter (5K panggilan) vs Pro (50K panggilan) + kelebihan	✅ Penuh
7. Langganan + Biaya Sesuai Permintaan	Biaya berulang + biaya manual variabel	$99/bulan retainer + 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 alokasi yang termasuk.

Cara Kerjanya

Rencana Pro: $49/bulan

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

Contoh perhitungan (pelanggan menggunakan 25.000 panggilan bulan ini):

Biaya langganan dasar: $49.00
Kelebihan: (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: Rencana dasar + kelebihan per-GB
Platform komunikasi: Dasar + biaya per pesan/menit

Implementasi

Buat Meter Penggunaan

Siapkan meter untuk melacak dimensi penggunaan yang dapat ditagih.

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

Buat Produk Langganan dengan Harga Penggunaan

Buat produk langganan dan lampirkan meter penggunaan dengan harga.

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 faktur langganan secara otomatis.

Buat Sesi Checkout

Buat sesi checkout dengan produk langganan Anda.

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

Kirim Peristiwa Penggunaan

Lacak penggunaan sepanjang 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

Alokasi Termasuk
Dasar Nol + Penggunaan Murni
Alokasi Bertingkat

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

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

Model Hibrida 2: Langganan + Kursi

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

Cara Kerjanya

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

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

Contoh perhitungan (tim dengan 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-representatif penjualan
Manajemen proyek: Rencana tim + per-kontributor
Alat pengembang: Biaya organisasi + per-pengembang

Implementasi

Buat Tambahan Kursi

Buat tambahan untuk kursi tambahan.

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

Buat Langganan Dasar

Buat produk langganan dengan biaya platform dan lampirkan tambahan.

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

Buat Checkout dengan Kursi

Tentukan jumlah kursi selama checkout.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_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'
});

Sesuaikan Kursi Sesuai Kebutuhan

Tambahkan atau hapus kursi pada langganan yang ada.

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

Variasi Harga

Kursi Termasuk
Murni Per-Kursi
Per-Kursi Bertingkat

Rencana dasar mencakup beberapa kursi, biaya untuk tambahan.Rencana Tim: $99/bulan

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

Model Hibrida 3: Langganan + Tambahan Fitur

Langganan inti dengan peningkatan fitur opsional yang dapat ditambahkan pelanggan.

Cara Kerjanya

Rencana Inti: $29/bulan Tambahan Opsional:

Analitik Lanjutan: +$19/bulan
Akses API: +$9/bulan
Dukungan Prioritas: +$29/bulan
Label Putih: +$49/bulan

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

Rencana 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

Buat Tambahan Fitur

Buat tambahan 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

Buat Langganan Inti

Tentukan langganan dasar Anda dan lampirkan semua tambahan fitur.

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

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

Biarkan Pelanggan Memilih

Checkout dengan fitur yang dipilih.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_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'
});

Tambahkan Fitur Nanti

Pelanggan dapat menambahkan fitur ke langganan yang ada.

// Customer wants to add Priority Support
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_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 digabungkan dengan biaya berbasis konsumsi. Setiap pengguna mendapatkan alokasi.

Keterbatasan: Dodo Payments saat ini tidak mendukung melampirkan baik meter penggunaan maupun tambahan ke produk langganan yang sama. Model ini memerlukan solusi sementara menggunakan logika tingkat aplikasi.

Segera Hadir: Dukungan asli untuk penagihan hibrida Kursi + Penggunaan ada dalam peta jalan kami. Ini akan memungkinkan Anda untuk melampirkan baik meter penggunaan maupun tambahan kursi ke produk langganan yang sama.

Cara Kerjanya

Analitik Tim: $20/pengguna/bulan Setiap pengguna termasuk:

5 GB pemrosesan data/bulan
Kelebihan: $2/GB setelah alokasi

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

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

Kasus Penggunaan

Platform analitik: Per-analis + pemrosesan data
Alat desain: Per-desainer + penyimpanan/ekspor
Lingkungan pengembangan: Per-pengembang + jam komputasi
Alat komunikasi: Per-pengguna + volume pesan/panggilan

Opsi Implementasi

Karena Anda tidak dapat melampirkan baik meter penggunaan maupun tambahan ke langganan yang sama, pilih salah satu dari pendekatan ini:

Opsi A: Produk Penggunaan + Kursi yang Dikelola Aplikasi
Opsi B: Tambahan Kursi + Biaya Penggunaan Sesuai Permintaan

Gunakan langganan berbasis penggunaan dan kelola penagihan kursi di aplikasi Anda.

Buat Meter Penggunaan

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

Buat Langganan Berbasis Penggunaan

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)

Kelola Kursi di Aplikasi Anda

Lacak jumlah kursi dan hitung biaya kursi 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
  });
}

Hitung Ambang Bebas Dinamis

Sesuaikan penggunaan yang termasuk berdasarkan jumlah kursi.

// 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 tambahan untuk kursi dan tagih penggunaan secara manual melalui biaya sesuai permintaan.

Buat Tambahan Kursi

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

Buat Langganan dengan Tambahan

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

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

Enable on-demand charging

Lacak Penggunaan di Aplikasi Anda

// 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()
  });
}

Tagih Penggunaan di Akhir Siklus

Hitung dan tagih 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 (Tambahan Kursi + Penggunaan Sesuai Permintaan) seringkali lebih mudah diimplementasikan karena Dodo menangani penagihan kursi secara otomatis. Anda hanya perlu melacak dan menagih kelebihan penggunaan.

Model Hibrida 5: Langganan + Kursi + Penggunaan (Hibrida Tiga)

Model yang paling komprehensif: biaya platform + per pengguna + konsumsi.

Keterbatasan: Dodo Payments saat ini tidak mendukung melampirkan baik meter penggunaan maupun tambahan ke produk langganan yang sama. Model ini memerlukan pendekatan solusi sementara.

Segera Hadir: Dukungan asli untuk penagihan Hibrida Tiga (Dasar + Kursi + Penggunaan) ada dalam peta jalan kami. Ini akan memungkinkan Anda untuk melampirkan baik meter penggunaan maupun tambahan kursi ke produk langganan yang sama.

Cara Kerjanya

Platform Enterprise

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

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

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

Kasus Penggunaan

SaaS Perusahaan: Platform + tim + konsumsi
Platform Data: Ruang kerja + analis + kueri
Platform Integrasi: Hub + konektor + transaksi
Platform AI: Ruang kerja + pengembang + inferensi

Opsi Implementasi

Pilih salah satu dari pendekatan ini untuk mengimplementasikan penagihan hibrida tiga:

Opsi A: Dasar + Kursi (Tambahan) + Penggunaan Sesuai Permintaan
Opsi B: Dasar + Penggunaan (Meter) + Kursi yang Dikelola Aplikasi

Gunakan langganan dengan tambahan kursi, tagih penggunaan secara manual melalui biaya sesuai permintaan.Ini adalah pendekatan yang direkomendasikan karena Dodo menangani biaya platform dan penagihan kursi secara otomatis.

Buat Tambahan Kursi

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

Buat Produk Langganan

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

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

Enable on-demand charging

Buat Checkout dengan Kursi

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_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'
});

Lacak Penggunaan di Aplikasi Anda

Simpan peristiwa penggunaan 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()
  });
}

Tagih Penggunaan di Akhir Siklus

Hitung dan tagih kelebihan penggunaan melalui biaya sesuai permintaan.

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 langganan dengan meter penggunaan, kelola penagihan kursi di aplikasi Anda.

Buat Meter Penggunaan

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

Buat Produk Langganan dengan Penggunaan

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

Kelola Kursi di Aplikasi Anda

Lacak jumlah kursi dan sesuaikan harga langganan dasar sesuai.

// 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
}

Kirim Peristiwa Penggunaan ke 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 (Dasar + Kursi + Penggunaan Sesuai Permintaan) umumnya lebih mudah karena Dodo menangani biaya platform dan penagihan kursi secara otomatis. Anda hanya perlu melacak penggunaan dan mengajukan biaya di akhir setiap siklus penagihan.

Model Hibrida 6: Dasar Bertingkat + Kelebihan Penggunaan

Tingkatan langganan yang berbeda dengan alokasi dan tarif kelebihan yang berbeda.

Cara Kerjanya

Tingkat	Harga	Panggilan Termasuk	Tarif Kelebihan
Starter	$19/bulan	1.000	$0.02/panggilan
Pro	$79/bulan	25.000	$0.01/panggilan
Bisnis	$199/bulan	100.000	$0.005/panggilan
Enterprise	$499/bulan	500.000	$0.002/panggilan

Implementasi

Buat produk langganan 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 Peningkatan

Ketika pelanggan meningkatkan tingkat, mereka mendapatkan:

Alokasi yang lebih tinggi
Tarif kelebihan yang lebih rendah
Lebih banyak nilai per dolar

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

Model Hibrida 7: Langganan + Biaya Sesuai Permintaan

Langganan berulang ditambah biaya manual variabel untuk layanan atau kelebihan.

Cara Kerjanya

Rencana Retainer: $199/bulan Termasuk:

Akses platform
5 jam konsultasi/bulan
Dukungan email

Biaya Sesuai Permintaan (sesuai kebutuhan):

Konsultasi tambahan: $150/jam
Pengembangan kustom: $200/jam
Dukungan darurat: $100/kejadian

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 kejadian
Layanan agensi: Biaya bulanan + biaya proyek
Rencana dukungan: Biaya SLA + per-tiket atau per-jam

Implementasi

Buat Langganan Sesuai Permintaan

Siapkan langganan dengan penagihan sesuai permintaan 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: 'prod_retainer',
  quantity: 1,
  payment_link: true,
  return_url: 'https://yourapp.com/success',
  on_demand: {
    mandate_only: false,
    product_price: 19900  // $199 initial charge
  }
});

Tagih untuk Layanan

Buat biaya saat layanan disampaikan.

// 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)'
});

Lacak dan Faktur

Semua biaya muncul di faktur 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.description}: $${payment.amount / 100}`);
});

Contoh Dunia Nyata

Contoh-contoh ini menunjukkan struktur harga yang ideal. Karena keterbatasan bahwa meter penggunaan dan tambahan tidak dapat dilampirkan ke produk yang sama, beberapa kombinasi memerlukan solusi sementara (menggunakan biaya sesuai permintaan untuk penggunaan atau kursi yang dikelola aplikasi).

Contoh 1: Platform AI SaaS

Struktur Harga:

Langganan Dasar: $99/bulan (akses platform, 5 kursi termasuk)
Tambahan Kursi: $20/kursi/bulan
Tambahan Fitur: Model Kustom ($49/bulan), Akses API ($29/bulan), Antrian Prioritas ($19/bulan)
Kelebihan Penggunaan: $0.02 per 1.000 token setelah 100K (ditagih melalui sesuai permintaan)

Implementasi: Gunakan langganan dengan tambahan kursi dan fitur. Lacak penggunaan token di aplikasi Anda dan tagih kelebihan melalui biaya sesuai permintaan di akhir siklus penagihan. Contoh Pelanggan (12 pengguna, 500K token, Model Kustom + Akses API):

Komponen	Perhitungan	Jumlah
Dasar	Biaya platform	$99
Kursi tambahan	7 × $20	$140
Model Kustom	Tambahan	$49
Akses API	Tambahan	$29
Kelebihan token	400K × $0.02/1K (sesuai permintaan)	$8
Total		$325/bulan

Contoh 2: Platform Alat Pengembang

Opsi Tingkat:

	Gratis	Pro	Enterprise
Harga	$0/bulan	$29/bulan	$199/bulan
Pengguna	1	5 termasuk	Tidak terbatas
Builds	100	1.000	10.000
Penyimpanan	1 GB	10 GB	100 GB

Opsi Implementasi: Opsi A (Fokus Penggunaan): Buat produk dengan meter penggunaan untuk builds/penyimpanan. Kelola pengguna di aplikasi Anda. Opsi B (Fokus Kursi): Buat produk dengan tambahan kursi. Lacak penggunaan builds/penyimpanan dan tagih kelebihan melalui biaya sesuai permintaan. Tambahan (jika menggunakan Opsi B):

Pengguna tambahan: $10/pengguna/bulan
Builds prioritas: $19/bulan
Domain kustom: $9/domain/bulan

Contoh 3: Automasi Pemasaran

Struktur Harga:

Dasar: $79/bulan (fitur otomatisasi inti, 3 kursi termasuk)
Tingkatan Kontak (tambahan): 1K termasuk, 5K (+$30), 25K (+$80), 100K (+$200)
Tambahan Fitur: Pemasaran SMS ($29/bulan), Halaman Arahan ($19/bulan), Pengujian A/B ($29/bulan)
Kursi Tim: $15/pengguna/bulan tambahan
Volume Email: Lacak di aplikasi, tagih kelebihan melalui sesuai permintaan ($1/1.000 email di atas batas)

Implementasi: Gunakan langganan dengan tambahan tingkatan kontak, tambahan fitur, dan tambahan kursi. Lacak pengiriman email di aplikasi Anda dan tagih kelebihan melalui biaya sesuai permintaan.

Praktik Terbaik Implementasi

Kejelasan Halaman Harga

Buat harga hibrida mudah dipahami. Tampilkan biaya dasar, apa yang termasuk, dan bagaimana kelebihan bekerja secara mencolok di halaman harga Anda.

Baik: “$49/bulan termasuk 10.000 panggilan API. Panggilan tambahan: $0.005 masing-masing” 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 kepada pelanggan penggunaan mereka secara real-time:

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

  return {
    current: usage.current_period_usage,
    included: usage.free_threshold,
    remaining: Math.max(0, usage.free_threshold - usage.current_period_usage),
    overage: Math.max(0, usage.current_period_usage - usage.free_threshold),
    projectedCost: calculateProjectedOverage(usage)
  };
}

Transparansi Penagihan

Berikan faktur terperinci yang menunjukkan semua komponen:

Item Baris	Jumlah
Rencana Pro (Bulanan)	$49.00
Kursi Tambahan (7 × $15.00)	$105.00
Penggunaan API - Termasuk (10.000 panggilan)	$0.00
Penggunaan API - Kelebihan (15.420 panggilan × $0.005)	$77.10
Tambahan Analitik Lanjutan	$19.00
Subtotal	$250.10
Pajak (8.5%)	$21.26
Total yang Harus Dibayar	$271.36

Memecahkan Masalah Penagihan Hibrida

Penggunaan tidak dilacak dengan benar

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

Verifikasi bahwa pengambilan acara berfungsi (periksa respons API)
Konfirmasi customer_id cocok dengan pelanggan langganan
Periksa event_name cocok dengan konfigurasi meter
Verifikasi bahwa acara memiliki cap waktu yang benar (tidak bertanggal di masa depan)

Kebingungan prorata dengan beberapa komponen

Gejala: Pelanggan dikenakan jumlah yang tidak terduga saat mengubah rencana.Solusi:

Gunakan previewChangePlan API untuk menunjukkan biaya yang tepat sebelum mengonfirmasi
Komunikasikan bahwa prorata berlaku untuk langganan DAN tambahan
Pertimbangkan untuk menggunakan difference_immediately untuk penagihan upgrade yang lebih sederhana

Ambang gratis tidak diterapkan dengan benar

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

Verifikasi ambang gratis dikonfigurasi pada produk berbasis penggunaan
Periksa unit ambang cocok dengan agregasi peristiwa (panggilan vs. permintaan)
Konfirmasi meter penggunaan terlampir dengan benar ke produk langganan

Tambahan tidak muncul di checkout

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

Verifikasi tambahan terlampir ke produk langganan di dasbor
Periksa ID tambahan benar dalam panggilan API
Pastikan mata uang tambahan cocok dengan mata uang produk langganan

Dokumentasi Terkait

Produk

Ikhtisar semua jenis produk dan panduan.

Panduan Penagihan Berdasarkan Penggunaan

Implementasi penagihan penggunaan lengkap.

Manajemen Langganan

Mengelola langganan berulang.

Tambahan

Memperluas langganan dengan tambahan.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Penagihan Berdasarkan Penggunaan

Langganan

Tambahan

Penagihan Berdasarkan Kursi

​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 + Tambahan Fitur

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Model Hibrida 4: Kursi + Penggunaan

​Cara Kerjanya

​Kasus Penggunaan

​Opsi Implementasi

​Model Hibrida 5: Langganan + Kursi + Penggunaan (Hibrida Tiga)

​Cara Kerjanya

​Kasus Penggunaan

​Opsi Implementasi

​Model Hibrida 6: Dasar Bertingkat + Kelebihan Penggunaan

​Cara Kerjanya

​Implementasi

​Jalur Peningkatan

​Model Hibrida 7: Langganan + Biaya Sesuai Permintaan

​Cara Kerjanya

​Kasus Penggunaan

​Implementasi

​Contoh Dunia Nyata

​Contoh 1: Platform AI SaaS

​Contoh 2: Platform Alat Pengembang

​Contoh 3: Automasi Pemasaran

​Praktik Terbaik Implementasi

​Kejelasan Halaman Harga

​Prediktabilitas Biaya

​Visibilitas Penggunaan

​Transparansi Penagihan

​Memecahkan Masalah Penagihan Hibrida

​Dokumentasi Terkait

Produk

Panduan Penagihan Berdasarkan Penggunaan

Manajemen Langganan

Tambahan

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 + Tambahan Fitur

Cara Kerjanya

Kasus Penggunaan

Implementasi

Model Hibrida 4: Kursi + Penggunaan

Cara Kerjanya

Kasus Penggunaan

Opsi Implementasi

Model Hibrida 5: Langganan + Kursi + Penggunaan (Hibrida Tiga)

Cara Kerjanya

Kasus Penggunaan

Opsi Implementasi

Model Hibrida 6: Dasar Bertingkat + Kelebihan Penggunaan

Cara Kerjanya

Implementasi

Jalur Peningkatan

Model Hibrida 7: Langganan + Biaya Sesuai Permintaan

Cara Kerjanya

Kasus Penggunaan

Implementasi

Contoh Dunia Nyata

Contoh 1: Platform AI SaaS

Contoh 2: Platform Alat Pengembang

Contoh 3: Automasi Pemasaran

Praktik Terbaik Implementasi

Kejelasan Halaman Harga

Prediktabilitas Biaya

Visibilitas Penggunaan

Transparansi Penagihan

Memecahkan Masalah Penagihan Hibrida

Dokumentasi Terkait