Docs

Log into read the version of docs relevant to your site.

Package Pricing

Use package pricing to charge per block of units or usage. Define a package size and bill only in whole packages. For example, if you charge $10 for every 1,000 API calls, the package size is 1,000 units.

How packages are counted?

Chargebee bills usage in whole packages. Within each tier, any usage is rounded up to the next whole package. A minimum of one package is billed per billing period.

Package pricing example (OpenAI - GPT-5)

  • Package size: 1,000,000 tokens (1M tokens)
  • Price: $1.25 per package

Billing outcomes for different usage amounts:

10 tokens are rounded up to the minimum billable amount

  • 1 package billed = $1.25

1,000,000 tokens are exactly one full package

  • 1 package billed = $1.25

1,500,000 tokens are rounded up to two packages

  • 2 packages billed = $2.50

Note:

  • Package pricing can be set for metered items(plan or addon).
  • Currently, package pricing is available for tiered, volume based pricing models(plans and addons) only.

Enabling Package Pricing

Note:

Request access to enable package pricing on your site.

Configure Package Pricing

Configure package pricing for a tiered or volume-based plan or addon:

  1. Select Allow advanced pricing configurations for this item.
  2. Define Package Size for each tier. Example: If a customer consumes 350 units, the total payable amount is $800.

Limitations

  • The package size does not sync with Chargebee's native integrations, such as Sales, Finance, and others. However, all other integration-related functions are supported.
  • The package size is not displayed on hosted pages, such as checkout and self-serve portals.

Was this article helpful?