混合计费模型 - Dodo Payments Documentation

混合计费将两种或多种计费模型结合成一个单一的定价策略。这使您能够从不同维度捕获价值——经常性费用、使用量、座席和功能，同时为客户提供灵活性和可预测性。

Usage-Based Billing

消费型定价的基础。

Subscriptions

经常性计费的基础。

Add-ons

使用可选升级扩展订阅。

Seat-Based Billing

每用户定价模型。

什么是混合计费？

混合计费将多种定价维度组合成一个产品提供。与仅选择统一价订阅或基于使用的定价相比，您可以将二者结合起来使用。

为什么使用混合计费？

商业目标	混合解决方案
可预测收入+增长潜力	基础订阅+超量使用
团队定价可扩展	每座席+功能附加
吸引客户，后期扩展	低基础费用+消费费用
企业灵活性	承诺支出+按需收费
可变使用的公平定价	包含津贴+按使用付费

常见混合模式

模型	描述	示例	原生支持
1. 订阅+使用	基础费用+消费费用	$49/月 + 每10K免费后每个API调用$ 0.01	✅ 完全支持
2. 订阅+座席	平台费用+每用户费用	$99/月 + 每座席$ 15	✅ 完全支持
3. 订阅+功能附加	核心计划+可选升级	$29/月 +$ 19/月分析 + $9/月API访问	✅ 完全支持
4. 座席+使用	每用户费用+消费超量	$10/用户/月 + 每用户5GB后$ 0.05/GB	⚠️ 解决方案
5. 订阅+座席+使用	平台 + 用户 + 消费（三重混合）	$199/月 + 每座席$ 20 + 超量使用	⚠️ 解决方案
6. 分级基础+使用超量	不同级别不同津贴	入门（5K调用）vs 专业（50K调用）+超量	✅ 完全支持
7. 订阅+按需收费	经常性费用+可变手动费用	$99/月保证金+工作时间收费	✅ 完全支持

混合模型 1：订阅 + 使用

最常见的混合模型。客户支付基础订阅费以及超出包含津贴的使用费用。

如何运作

专业计划：每月$49

包含：每月10,000次API调用
超量：每次调用$0.005，超过10,000次

计算示例（本月客户使用25,000次调用）：

基础订阅：$49.00
超量：（25,000 - 10,000）× $0.005 =$ 75.00
总计：$124.00

使用场景

API平台：基础访问+按请求收费
AI/ML服务：订阅+令牌/生成使用
存储服务：基础计划+每GB超量
通信平台：基础+每消息/分钟收费

实施

Create Usage Meter

设置一个仪表来跟踪可计费的使用维度。

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

Create Subscription Product with Usage Pricing

创建订阅产品并附加价格使用仪表。

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)

使用仪表直接附加到订阅产品上。使用费用自动计算并添加到订阅发票中。

Create Checkout Session

创建一个包含订阅产品的结账会话。

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

Send Usage Events

在整个计费期间跟踪使用情况。

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

定价变化

Included Allowance
Zero Base + Pure Usage
Tiered Allowances

免费门槛覆盖基础订阅中包含的使用。专业计划：每月$49

包含：10,000次API调用
超量：每次调用$0.005，超过10,000次
客户使用8,000→支付$49（无超量）

混合模型 2：订阅 + 座席

平台费用加上每用户费用。适用于团队协作工具和 B2B SaaS。

如何运作

团队计划：每月 $99 + 每座席$ 15

基础平台费用：每月$99（包括3个座席）
附加座席：每座席每月$15

计算示例（12用户团队）：

平台费用：$99.00
额外座席：(12 - 3) × $15 =$ 135.00
总计：每月$234.00

使用场景

协作工具：工作区费用+每成员
CRM 系统：平台授权+每销售代表
项目管理：团队计划+每贡献者
开发者工具：组织费用+每开发者

实施

Create Seat Add-on

为附加座席创建附加功能。

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

Create Base Subscription

创建包含平台费的订阅产品并附加附加功能。

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

在结账时指定座席数量。

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

Adjust Seats as Needed

在现有订阅中增加或减少座席。

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

定价变化

Included Seats
Pure Per-Seat
Tiered Per-Seat

基本计划包括一些座席，对额外座席收费。团队计划：每月$99

包含：5个座席
额外座席：每座席每月$15
20用户 = $99 + (15 ×$ 15) = $324/月

混合模型 3：订阅 + 功能附加

核心订阅及可选的功能升级，客户可以选择添加。

如何运作

核心计划：每月$29 可选附加：

高级分析：+$19/月
API访问：+$9/月
优先支持：+$29/月
白标化：+$49/月

计算示例（客户选择核心+分析+API访问）：

核心计划：$29.00
分析：$19.00
API 访问：$9.00
总计：每月$57.00

使用场景

SaaS平台：核心功能+高级模块
营销工具：基础工具+集成
分析产品：仪表板+高级报告
安全软件：基本保护+高级功能

实施

Create Feature Add-ons

为每个可选功能创建附加功能。

# 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

定义您的基础订阅并附加所有功能附加。

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

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

Let Customers Choose

根据选择的功能结账。

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

Add Features Later

客户可以在现有订阅中添加功能。

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

混合模型 4：座席 + 使用

每用户费用结合消费型费用。每个用户都有一个津贴。

约束：Dodo Payments 当前不支持将使用仪表和附加功能附加到同一个订阅产品。本模型需要使用应用级别逻辑的解决方案。

工作原理

团队分析：$20/用户/月 每位用户包含：

每月 5 GB 数据处理量
超额费用：超出额度后按 $2/GB 计费

计算示例（10 人团队共使用 80 GB）：

席位费用：10 × $20 =$ 200.00
包含的数据量：10 × 5 GB = 50 GB
超额费用：(80 - 50) × $2 =$ 60.00
总计：$260.00/月

使用场景

分析平台：按分析师数量 + 数据处理量计费
设计工具：按设计师数量 + 存储空间/导出量计费
开发环境：按开发者数量 + 计算时长计费
通信工具：按用户数量 + 消息/通话量计费

实现选项

由于无法将 usage meters 和 add-ons 同时附加到同一订阅，请选择以下方法之一：

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

使用基于用量的订阅，并在应用中管理席位计费。

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

跟踪席位数量，并单独计算席位费用。

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

根据席位数量调整包含的用量。

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

使用 add-ons 购买席位，并通过按需收费手动收取用量费用。

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

手动计算并收取用量超额费用。

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`
    });
  }
}

建议：选项 B（席位 Add-on + 按需用量）通常更易于实现，因为 Dodo 会自动处理席位计费。你只需跟踪用量并收取超额费用。

混合模式 5：订阅 + 席位 + 用量（三重混合）

最全面的模式：平台费用 + 按用户计费 + 按用量计费。

限制：Dodo Payments 目前不支持将 usage meters 和 add-ons 同时附加到同一订阅产品。此模式需要采用变通方案。

工作原理

企业平台

平台费用：$199/月
每个席位：$25/用户/月
用量：每 1000 次 API 调用 $0.10（包含 50K 次）

计算示例（一家公司有 20 位用户，发起 150,000 次 API 调用）：

平台：$199.00
席位：20 × $25 =$ 500.00
用量：(150K - 50K) × $0.10/1K = $10.00
总计：$709.00/月

使用场景

企业 SaaS：平台 + 团队 + 用量
数据平台：工作区 + 分析师 + 查询
集成平台：Hub + 连接器 + 事务
AI 平台：工作区 + 开发者 + 推理

实现选项

选择以下方法之一来实现三重混合计费：

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

使用带有席位 add-ons 的订阅，并通过按需收费手动收取用量费用。这是推荐的方法，因为 Dodo 会自动处理平台费用和席位计费。

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

Track Usage in Your Application

在系统中存储用量事件。

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

通过按需收费计算并收取用量超额费用。

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`
    });
  }
}

使用带有 usage meter 的订阅，并在应用中管理席位计费。

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

跟踪席位数量，并相应调整基础订阅价格。

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

建议：选项 A（基础费用 + 席位 + 按需用量）通常更易于实现，因为 Dodo 会自动处理平台和席位计费。你只需跟踪用量，并在每个计费周期结束时提交费用。

混合模式 6：分层基础费用 + 用量超额

不同的订阅层级具有不同的包含额度和超额费率。

工作原理

层级	价格	包含调用次数	超额费率
Starter	$19/月	1,000	$0.02/次调用
Pro	$79/月	25,000	$0.01/次调用
Business	$199/月	100,000	$0.005/次调用
Enterprise	$499/月	500,000	$0.002/次调用

实现

为每个层级创建单独的订阅产品，并为每个产品配置各自的用量设置：

# 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

升级路径

客户升级层级后，将获得：

更高的包含额度
更低的超额费率
更高的单位金额价值

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

混合模式 7：订阅 + 按需收费

周期性订阅，加上针对服务或超额用量的可变手动费用。

工作原理

顾问预付费计划：$199/月 包含：

平台访问权限
每月 5 小时咨询服务
电子邮件支持

按需收费（按需提供）：

额外咨询：$150/小时
定制开发：$200/小时
紧急支持：$100/次事件

计算示例（本月）：

预付费：$199.00
3 小时额外咨询：$450.00
1 次紧急支持：$100.00
总计：$749.00

使用场景

咨询服务：预付费 + 按小时计费
托管服务：基础费用 + 事件费用
代理服务：月费 + 项目费用
支持计划：SLA 费用 + 按工单或按小时计费

实现

Create On-Demand Subscription

设置启用按需收费的订阅。

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

Charge for Services

在服务交付后创建费用。

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

所有费用都会显示在客户的发票上。

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

实际示例

这些示例展示了理想的定价结构。由于 usage meters 和 add-ons 无法附加到同一产品，某些组合需要采用变通方案（使用按需收费收取用量费用，或由应用管理席位）。

示例 1：AI SaaS 平台

定价结构：

基础订阅：$99/月（平台访问权限，包含 5 个席位）
席位 Add-on：$20/席位/月
功能 Add-ons：Custom Models（$49/月）、API Access（$29/月）、Priority Queue（$19/月）
用量超额：超过 100K 后按每 1,000 个 token 收取 $0.02（通过按需收费）

实现：使用带有席位和功能 add-ons 的订阅。在应用中跟踪 token 用量，并在计费周期结束时通过按需收费收取超额费用。 客户示例（12 位用户、500K 个 token、Custom Models + API Access）：

组件	计算方式	金额
基础费用	平台费用	$99
额外席位	7 × $20	$140
Custom Models	Add-on	$49
API Access	Add-on	$29
Token 超额	400K × $0.02/1K（按需）	$8
总计		$325/月

示例 2：开发者工具平台

层级选项：

	Free	Pro	Enterprise
价格	$0/月	$29/月	$199/月
用户数	1	包含 5 个	无限制
构建次数	100	1,000	10,000
存储空间	1 GB	10 GB	100 GB

实现选项： 选项 A（以用量为重点）：创建带有 usage meters 的产品，用于跟踪构建次数/存储空间。在应用中管理用户。 选项 B（以席位为重点）：创建带有席位 add-ons 的产品。跟踪构建次数/存储空间用量，并通过按需收费收取超额费用。 Add-ons（如果使用选项 B）：

额外用户：$10/用户/月
优先构建：$19/月
自定义域名：$9/域名/月

示例 3：营销自动化

定价结构：

基础费用：$79/月（核心自动化功能，包含 3 个席位）
联系人层级（add-ons）：包含 1K，5K（+$30），25K（+$80），100K（+$200）
功能 Add-ons：SMS Marketing（$29/月）、Landing Pages（$19/月）、A/B Testing（$29/月）
团队席位：$15/用户/月的 add-on
电子邮件量：在应用中跟踪，并通过按需收费收取超额费用（超过限制后每 1,000 封邮件 $1）

实现：使用带有联系人层级 add-ons、功能 add-ons 和席位 add-ons 的订阅。在应用中跟踪电子邮件发送量，并通过按需收费收取超额费用。

实现最佳实践

定价页面清晰度

让混合定价易于理解。在定价页面上突出显示基础费用、包含内容以及超额费用的计算方式。

好：“$49/月包含 10,000 次 API 调用。额外调用：每次 $0.005” 不好：“$49/月 + 用量费用”

成本可预测性

帮助客户估算费用：

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

用量可见性

向客户实时显示其用量：

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

计费透明度

提供显示所有组成部分的详细发票：

明细项目	金额
Pro 计划（月费）	$49.00
额外席位（7 × $15.00）	$105.00
API 用量 - 包含（10,000 次调用）	$0.00
API 用量 - 超额（15,420 次调用 × $0.005）	$77.10
Advanced Analytics Add-on	$19.00
小计	$250.10
税费（8.5%）	$21.26
应付总额	$271.36

混合计费故障排查

Usage not being tracked correctly

症状：用量显示为 0 或数值不正确。解决方案：

验证事件摄取是否正常（检查 API 响应）
确认 customer_id 与订阅客户匹配
检查 event_name 与 meter 配置匹配
验证事件具有正确的时间戳（不是未来时间）

Proration confusion with multiple components

症状：客户更改计划时被收取了意外金额。解决方案：

使用 previewChangePlan API 在确认前显示确切费用
说明按比例计费同时适用于订阅和 add-ons
考虑使用 difference_immediately，以简化升级计费

Free threshold not applying correctly

症状：客户被收取了本应免费的用量费用。解决方案：

验证免费阈值已在基于用量的产品上配置
检查阈值单位是否与事件聚合方式匹配（调用次数与请求次数）
确认 usage meter 已正确附加到订阅产品

Add-ons not appearing in checkout

症状：结账时无法添加席位或功能。解决方案：

验证 add-ons 已在 dashboard 中附加到订阅产品
检查 API 调用中的 add-on ID 是否正确
确保 add-on 的货币与订阅产品的货币匹配

Products

所有产品类型和指南的概览。

Usage-Based Billing Guide

完整的用量计费实现指南。

Subscription Management

管理周期性订阅。

Add-ons

使用 add-ons 扩展订阅。

Usage-Based Billing

Subscriptions

Add-ons

Seat-Based Billing

​什么是混合计费？

​为什么使用混合计费？

​常见混合模式

​混合模型 1：订阅 + 使用

​如何运作

​使用场景

​实施

​定价变化

​混合模型 2：订阅 + 座席

​如何运作

​使用场景

​实施

​定价变化

​混合模型 3：订阅 + 功能附加

​如何运作

​使用场景

​实施

​混合模型 4：座席 + 使用

​工作原理

​使用场景

​实现选项

​混合模式 5：订阅 + 席位 + 用量（三重混合）

​工作原理

​使用场景

​实现选项

​混合模式 6：分层基础费用 + 用量超额

​工作原理

​实现

​升级路径

​混合模式 7：订阅 + 按需收费

​工作原理

​使用场景

​实现

​实际示例

​示例 1：AI SaaS 平台

​示例 2：开发者工具平台

​示例 3：营销自动化

​实现最佳实践

​定价页面清晰度

​成本可预测性

​用量可见性

​计费透明度

​混合计费故障排查

​相关文档

Products

Usage-Based Billing Guide

Subscription Management

Add-ons

什么是混合计费？

为什么使用混合计费？

常见混合模式

混合模型 1：订阅 + 使用

如何运作

使用场景

实施

定价变化

混合模型 2：订阅 + 座席

如何运作

使用场景

实施

定价变化

混合模型 3：订阅 + 功能附加

如何运作

使用场景

实施

混合模型 4：座席 + 使用

工作原理

使用场景

实现选项

混合模式 5：订阅 + 席位 + 用量（三重混合）

工作原理

使用场景

实现选项

混合模式 6：分层基础费用 + 用量超额

工作原理

实现

升级路径

混合模式 7：订阅 + 按需收费

工作原理

使用场景

实现

实际示例

示例 1：AI SaaS 平台

示例 2：开发者工具平台

示例 3：营销自动化

实现最佳实践

定价页面清晰度

成本可预测性

用量可见性

计费透明度

混合计费故障排查

相关文档