Skip to content

Commit 9dcc007

Browse files
apply all feedback and minor cleanup
1 parent ab1dd76 commit 9dcc007

1 file changed

Lines changed: 68 additions & 14 deletions

File tree

app/metering-and-billing/pricing-models.md

Lines changed: 68 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,21 @@ rows:
5858
- parameter: Percentage discount
5959
description: Reduces price by a fixed percent across all usage.
6060
- parameter: Tax behavior
61-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
61+
description: |
62+
Select from one of the following behaviors:
63+
<br><br>
64+
* Inclusive: The listed price already includes tax.
65+
* Exclusive: The tax is added on top of the listed price.
66+
<br><br>
67+
68+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
6269
- parameter: Stripe Tax Code
6370
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
6471
{% endtable %}
6572

6673
## Usage based
6774

68-
Usage-based pricing is a model where you charge customers based on the number of units they use, as reported by the meter.
75+
Usage-based pricing is a model where you charge customers based on the number of units they use, as reported by the [meter](/metering-and-billing/metering/).
6976

7077
For example, you could charge customers $0.01 per AI token used.
7178
If a customer uses 10,000 tokens, they would be charged:
@@ -96,7 +103,14 @@ rows:
96103
- parameter: Maximum commitment
97104
description: The maximum amount the customer is charged per billing period, regardless of usage.
98105
- parameter: Tax behavior
99-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
106+
description: |
107+
Select from one of the following behaviors:
108+
<br><br>
109+
* Inclusive: The listed price already includes tax.
110+
* Exclusive: The tax is added on top of the listed price.
111+
<br><br>
112+
113+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
100114
- parameter: Stripe Tax Code
101115
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
102116
{% endtable %}
@@ -175,7 +189,14 @@ rows:
175189
- parameter: Maximum commitment
176190
description: The maximum amount the customer is charged per billing period, regardless of usage.
177191
- parameter: Tax behavior
178-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
192+
description: |
193+
Select from one of the following behaviors:
194+
<br><br>
195+
* Inclusive: The listed price already includes tax.
196+
* Exclusive: The tax is added on top of the listed price.
197+
<br><br>
198+
199+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
179200
- parameter: Stripe Tax Code
180201
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
181202
{% endtable %}
@@ -245,18 +266,26 @@ rows:
245266
- parameter: Maximum commitment
246267
description: The maximum amount the customer is charged per billing period, regardless of usage.
247268
- parameter: Tax behavior
248-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
269+
description: |
270+
Select from one of the following behaviors:
271+
<br><br>
272+
* Inclusive: The listed price already includes tax.
273+
* Exclusive: The tax is added on top of the listed price.
274+
<br><br>
275+
276+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
249277
- parameter: Stripe Tax Code
250278
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
251279
{% endtable %}
252280

253281
### Flat prices in tiers
254282

255-
With tiered pricing, you can define per unit or flat fees in each tier.
283+
With tiered pricing, you can define flat fees for each tier in addition to unit pricing.
256284

257285
For example, you could charge $500 for the first tier and $0.1 per unit for the rest.
258286

259287
This is useful to define overage charges or to bill a flat fee regardless of usage.
288+
For example:
260289

261290
<!--vale off-->
262291
{% table %}
@@ -368,19 +397,19 @@ rows:
368397
- usage: 0 units
369398
calculation: 0 packages × $10
370399
total_price: $0
371-
explanation: No packages needed as there's no usage
400+
explanation: No packages needed as there's no usage.
372401
- usage: 20 units
373402
calculation: 1 package × $10
374403
total_price: $10
375-
explanation: Usage fits exactly in one package
404+
explanation: Usage fits exactly in one package.
376405
- usage: 20.1 units
377406
calculation: 2 packages × $10
378407
total_price: $20
379-
explanation: Additional 0.1 units requires a new package
408+
explanation: Adding 0.1 units requires a new package.
380409
- usage: 98 units
381410
calculation: 5 packages × $10
382411
total_price: $50
383-
explanation: Usage requires 5 full packages
412+
explanation: Usage requires 5 full packages.
384413
{% endtable %}
385414
<!--vale on-->
386415

@@ -411,7 +440,14 @@ rows:
411440
- parameter: Maximum commitment
412441
description: The maximum amount the customer is charged per billing period, regardless of usage.
413442
- parameter: Tax behavior
414-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
443+
description: |
444+
Select from one of the following behaviors:
445+
<br><br>
446+
* Inclusive: The listed price already includes tax.
447+
* Exclusive: The tax is added on top of the listed price.
448+
<br><br>
449+
450+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
415451
- parameter: Stripe Tax Code
416452
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
417453
{% endtable %}
@@ -455,7 +491,14 @@ rows:
455491
- parameter: Maximum commitment
456492
description: The maximum amount the customer is charged per billing period, regardless of usage.
457493
- parameter: Tax behavior
458-
description: Select from inclusive, where the listed price already includes tax, or exclusive, where the tax is added on top of the listed price. See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
494+
description: |
495+
Select from one of the following behaviors:
496+
<br><br>
497+
* Inclusive: The listed price already includes tax.
498+
* Exclusive: The tax is added on top of the listed price.
499+
<br><br>
500+
501+
See [Tax calculations](/metering-and-billing/product-catalog/#tax-calculations) for details.
459502
- parameter: Stripe Tax Code
460503
description: Select a [Stripe product tax code](https://docs.stripe.com/tax/tax-codes).
461504
{% endtable %}
@@ -538,16 +581,27 @@ For simple usage-based pricing, you can achieve the same result by creating a ti
538581

539582
## Set up a pricing model
540583

584+
Set up a pricing model for a rate card through the {{site.konnect_short_name}} UI.
585+
586+
### Prerequisites
541587
To set up a pricing model, you must have:
542588
* [A feature](/metering-and-billing/product-catalog/#features)
543589
* [A plan](/metering-and-billing/product-catalog/#plans)
544590

591+
### Steps
545592
To set up a pricing model on a rate card:
546593
1. Navigate to **Metering and Billing** > **Product Catalog**.
547594
1. Click the **Plans** tab.
548595
1. Select a plan and click **Add Rate Card**.
549596
1. Select a feature.
550-
1. Select and configure the pricing model.
551-
1. Set the entitlement.
597+
1. Select and configure the pricing model. Refer to the parameter reference for your model to fill out the form:
598+
* [Flat fee](#flat-fee)
599+
* [Usage based](#usage-based)
600+
* [Tiered](#tiered)
601+
* [Package](#package)
602+
* [Dynamic](#dynamic)
603+
604+
Free pricing models have no settings to configure.
605+
1. Set the [entitlement](/metering-and-billing/entitlements/).
552606
1. Click **Save Rate Card**.
553607
1. Click **Publish Plan**.

0 commit comments

Comments
 (0)