Skip to content

Commit 252e648

Browse files
Fix naming variable usage, remove get started from landing page and replace with learn more
Signed-off-by: Diana <[email protected]>
1 parent 89b6798 commit 252e648

File tree

7 files changed

+65
-65
lines changed

7 files changed

+65
-65
lines changed

app/_how-tos/get-started-with-metering-and-billing.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Get started with Metering and Billing in {{site.konnect_short_name}}
2+
title: Get started with {{site.metering_and_billing}} in {{site.konnect_short_name}}
33
description: Learn how to...
44
content_type: how_to
55

@@ -18,11 +18,11 @@ tags:
1818
- get-started
1919

2020
tldr:
21-
q: What is Metering and Billing in {{site.konnect_short_name}}, and how can I get started with it?
21+
q: What is {{site.metering_and_billing}} in {{site.konnect_short_name}}, and how can I get started with it?
2222
a: |
23-
[Metering & Billing](/metering-and-billing/) provides flexible billing and metering for AI and DevTool companies. It also includes real-time insights and usage limit enforcement.
23+
[{{site.metering_and_billing}}](/metering-and-billing/) provides flexible billing and metering for AI and DevTool companies. It also includes real-time insights and usage limit enforcement.
2424
25-
This tutorial will help you get started with Metering & Billing by setting up metering based on {{site.base_gateway}} API requests, turn raw API usage into billable product offerings by defining features and pricing plans, and start subscriptions to assign to customers.
25+
This tutorial will help you get started with {{site.metering_and_billing}} by setting up metering based on {{site.base_gateway}} API requests, turn raw API usage into billable product offerings by defining features and pricing plans, and start subscriptions to assign to customers.
2626
2727
tools:
2828
- deck
@@ -36,7 +36,7 @@ prereqs:
3636
inline:
3737
- title: "{{site.konnect_short_name}} roles"
3838
content: |
39-
You need the [? role](/konnect-platform/teams-and-roles/#service-catalog) in {{site.konnect_short_name}} to configure metering and billing.
39+
You need the [? role](/konnect-platform/teams-and-roles/#service-catalog) in {{site.konnect_short_name}} to configure {{site.metering_and_billing}}.
4040
icon_url: /assets/icons/kogo-white.svg
4141

4242
cleanup:
@@ -59,7 +59,7 @@ next_steps:
5959
automated_tests: false
6060
---
6161

62-
This getting-started guide shows how you can meter {{site.base_gateway}} API requests and invoice your customers based on their API consumption with Metering & Billing in {{site.konnect_short_name}}.
62+
This getting-started guide shows how you can meter {{site.base_gateway}} API requests and invoice your customers based on their API consumption with {{site.metering_and_billing}} in {{site.konnect_short_name}}.
6363

6464
In this guide, you'll:
6565
* Create a {{site.base_gateway}} Consumer that you'll map as a customer
@@ -68,7 +68,7 @@ In this guide, you'll:
6868
* Start subscriptions for a customer
6969
* Generate an invoice for a customer on the paid premium plan and see their API usage
7070

71-
The following diagram shows how {{site.base_gateway}} entities and Metering & Billing entities are associated:
71+
The following diagram shows how {{site.base_gateway}} entities and {{site.metering_and_billing}} entities are associated:
7272

7373
{% mermaid %}
7474
flowchart TB
@@ -78,7 +78,7 @@ flowchart TB
7878
route["example-route"]
7979
consumer1["Consumer-Kong Air"]
8080
end
81-
subgraph metering["<b>Konnect Metering & Billing</b>"]
81+
subgraph metering["<b>Konnect {{site.metering_and_billing}}</b>"]
8282
direction LR
8383
meter["Meter"]
8484
subgraph plan["Premium Plan"]
@@ -102,7 +102,7 @@ flowchart TB
102102

103103
## Create a Consumer
104104

105-
Before you configure metering and billing, you can set up a Consumer, Kong Air. [Consumers](/gateway/entities/consumer/) let you identify the client that's interacting with {{site.base_gateway}}. Later in this guide, you'll be mapping this Consumer to a customer in Metering & Billing and assigning them to a Premium plan. Doing this allows you map existing Consumers that are already consuming your APIs to customers to make them billable.
105+
Before you configure {{site.metering_and_billing}}, you can set up a Consumer, Kong Air. [Consumers](/gateway/entities/consumer/) let you identify the client that's interacting with {{site.base_gateway}}. Later in this guide, you'll be mapping this Consumer to a customer in {{site.metering_and_billing}} and assigning them to a Premium plan. Doing this allows you map existing Consumers that are already consuming your APIs to customers to make them billable.
106106

107107
You're going to use key [authentication](/gateway/authentication/) in this tutorial, so the Consumer needs an API key to access any {{site.base_gateway}} Services.
108108

@@ -136,11 +136,11 @@ entities:
136136

137137
## Create a meter
138138

139-
In Metering & Billing, meters track and record the consumption of a resource or service over time. This usage can take various forms, such as API requests, compute time seconds, or tokens consumed. Usage metering is commonly event-based to ensure accuracy and data you can audit.
139+
In {{site.metering_and_billing}}, meters track and record the consumption of a resource or service over time. This usage can take various forms, such as API requests, compute time seconds, or tokens consumed. Usage metering is commonly event-based to ensure accuracy and data you can audit.
140140

141-
In this guide, you'll enable API Gateway requests for metering. This will meter API request traffic in Metering & Billing so that you can charge customers for API traffic usage.
141+
In this guide, you'll enable API Gateway requests for metering. This will meter API request traffic in {{site.metering_and_billing}} so that you can charge customers for API traffic usage.
142142

143-
1. In the {{site.konnect_short_name}} sidebar, click **Metering & Billing**.
143+
1. In the {{site.konnect_short_name}} sidebar, click **{{site.metering_and_billing}}**.
144144
1. Enable **API Gateway Requests**.
145145

146146
## Create a feature
@@ -151,8 +151,8 @@ Features are customer-facing, and show up on the invoice for paid plans. Feature
151151

152152
In this guide, you'll create a feature for the `example-service` you created in the prerequisites.
153153

154-
1. In the {{site.konnect_short_name}} sidebar, click **Metering & Billing**.
155-
1. In the Metering & Billing sidebar, click **Product Catalog**.
154+
1. In the {{site.konnect_short_name}} sidebar, click **{{site.metering_and_billing}}**.
155+
1. In the {{site.metering_and_billing}} sidebar, click **Product Catalog**.
156156
1. Click **Create Feature**.
157157
1. In the **Name** field, enter `example-service`.
158158
1. From the **Meter** dropdown menu, select "kong_konnect_api_request".
@@ -171,8 +171,8 @@ A rate card describes price and usage limits or access control for a feature or
171171

172172
In this section, you'll create a Premium plan that grants paying customers access to the `example-service` at a rate of 5,000 requests per month:
173173

174-
1. In the {{site.konnect_short_name}} sidebar, click **Metering & Billing**.
175-
1. In the Metering & Billing sidebar, click **Product Catalog**.
174+
1. In the {{site.konnect_short_name}} sidebar, click **{{site.metering_and_billing}}**.
175+
1. In the {{site.metering_and_billing}} sidebar, click **Product Catalog**.
176176
1. Click the **Plans** tab.
177177
1. Click **Create Plan**.
178178
1. In the **Name** field, enter `Premium`.
@@ -192,8 +192,8 @@ In this section, you'll create a Premium plan that grants paying customers acces
192192

193193
Customers are the entities who pay for the consumption. In many cases, it's equal to your Consumer. Here you are going to create a customer and map our Consumer to it.
194194

195-
1. In the {{site.konnect_short_name}} sidebar, click **Metering & Billing**.
196-
1. In the Metering & Billing sidebar, click **Billing**.
195+
1. In the {{site.konnect_short_name}} sidebar, click **{{site.metering_and_billing}}**.
196+
1. In the {{site.metering_and_billing}} sidebar, click **Billing**.
197197
1. Click **Create Customer**.
198198
1. In the **Name** field, enter `Kong Air`.
199199
1. In the **Include usage from** dropdown, select "kong-air".
@@ -219,13 +219,13 @@ headers:
219219
{% endvalidation %}
220220
<!--vale on-->
221221

222-
This will generate six requests. Now, check the invoice that was created in Metering & Billing:
222+
This will generate six requests. Now, check the invoice that was created in {{site.metering_and_billing}}:
223223

224-
1. In the {{site.konnect_short_name}} sidebar, click **Metering & Billing**.
225-
1. In the Metering & Billing sidebar, click **Billing**.
224+
1. In the {{site.konnect_short_name}} sidebar, click **{{site.metering_and_billing}}**.
225+
1. In the {{site.metering_and_billing}} sidebar, click **Billing**.
226226
1. Click the **Invoices** tab.
227227
1. Click **Kong Air**.
228228
1. Click the **Invoicing** tab.
229229
1. Click **Preview Invoice**.
230230

231-
You'll see in Lines that `example-service` is listed and was used six times. In this guide, you're using the sandbox for invoices. To deploy your subscription in production, configure a payments integration in **Metering & Billing** > **Settings**.
231+
You'll see in Lines that `example-service` is listed and was used six times. In this guide, you're using the sandbox for invoices. To deploy your subscription in production, configure a payments integration in **{{site.metering_and_billing}}** > **Settings**.

app/_indices/metering-and-billing.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
title: Metering and Billing Documentation Index
1+
title: {{site.metering_and_billing}} Documentation Index
22
sections:
33
- title: Reference
44
items:

app/_landing_pages/metering-and-billing.yaml

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
metadata:
2-
title: "Metering and Billing"
2+
title: "{{site.metering_and_billing}}"
33
content_type: landing_page
4-
description: Learn how to meter and bill for your features with Metering and Billing.
4+
description: Learn how to meter and bill for your features with {{site.metering_and_billing}}.
55
breadcrumbs:
66
- /metering-and-billing/
77
products:
@@ -10,7 +10,7 @@ metadata:
1010
rows:
1111
- header:
1212
type: h1
13-
text: "Metering and Billing"
13+
text: "{{site.metering_and_billing}}"
1414
sub_text: Meter, bill, and monetize the entire AI connectivity data path.
1515
columns:
1616
- blocks:
@@ -19,7 +19,7 @@ rows:
1919
blocks:
2020
- type: text
2121
text: |
22-
{{site.konnect_short_name}} Metering & Billing provides a full system for tracking real-time usage, pricing products, enforcing entitlements, and generating invoices.
22+
{{site.konnect_short_name}} {{site.metering_and_billing}} provides a full system for tracking real-time usage, pricing products, enforcing entitlements, and generating invoices.
2323
It is designed for AI and API-first businesses that need accurate usage metering, flexible pricing models, and customer-level billing detail.
2424
2525
You can meter {{site.base_gateway}} requests, LLM tokens, or any custom event.
@@ -29,49 +29,49 @@ rows:
2929
- type: image
3030
config:
3131
url: /assets/images/konnect/metering.png
32-
alt_text: Metering and Billing Overview
32+
alt_text: "{{site.metering_and_billing}} Overview"
3333

3434

3535
- header:
3636
type: h2
37-
text: "Get started with Metering and Billing"
37+
text: "Learn more"
3838

3939
columns:
4040
- blocks:
4141
- type: card
4242
config:
43-
title: Meter LLM traffic
43+
title: Product Catalog
4444
description: |
45-
Track prompt tokens, completion tokens, and model usage from {{site.base_gateway}} or any AI gateway backed by Konnect.
46-
icon: /assets/icons/ai.svg
45+
{{site.konnect_short_name}} {{site.metering_and_billing}}’s Product Catalog lets you centrally define the different plans and plan features that make up your offering—so you can manage pricing, entitlements, and packaging in one place.
46+
icon: /assets/icons/document.svg
4747
cta:
48-
text: Learn how
49-
url: /metering-and-billing/monitor-llm-traffic/
48+
text: Learn more
49+
url: /metering-and-billing/product-catalog/
5050
- blocks:
5151
- type: card
5252
config:
53-
title: Meter {{site.base_gateway}} API requests
53+
title: Customers and usage attribution
5454
description: |
55-
Convert raw API request events into billable usage. Create meters, features, pricing, and subscriptions.
56-
icon: /assets/icons/gateway.svg
55+
Customers represent individuals or organizations that subscribe to plans, gain access to features, and are invoiced for their consumption.
56+
icon: /assets/icons/team.svg
5757
cta:
58-
text: Get started
59-
url: /metering-and-billing/get-started/
58+
text: Learn more
59+
url: /metering-and-billing/customer/
6060
- blocks:
6161
- type: card
6262
config:
63-
title: Understand customers
63+
title: Billing, invoicing, and subscriptions
6464
description: |
65-
Learn how {{site.konnect_short_name}} models customers and usage mapping for billing systems.
66-
icon: /assets/icons/team.svg
65+
Learn how to set up billing, invoicing, and subscriptions in {{site.konnect_short_name}} {{site.metering_and_billing}}.
66+
icon: /assets/icons/money.svg
6767
cta:
6868
text: Learn more
69-
url: /metering-and-billing/subjects/
69+
url: /metering-and-billing/billing-invoicing-subscriptions/
7070

7171
- header:
7272
type: h2
7373
text: "Integrations"
74-
sub_text: "Connect Metering and Billing to external payment, CRM, and invoicing systems"
74+
sub_text: "Connect {{site.metering_and_billing}} to external payment, CRM, and invoicing systems"
7575

7676
column_count: 3
7777
columns:

app/metering-and-billing/billing-invoicing-subscriptions.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ works_on:
1212
breadcrumbs:
1313
- /metering-and-billing/
1414
related_resources:
15-
- text: "{{site.konnect_short_name}} Metering and Billing"
15+
- text: "{{site.konnect_short_name}} {{site.metering_and_billing}}"
1616
url: /metering-and-billing/
1717
---
1818

@@ -24,7 +24,7 @@ Each {{site.metering_and_billing}} instance has one default billing profile that
2424

2525
A billing profile is linked to a specific App. This association is established during the billing profile's creation and remains immutable. When transitioning to a new app, organizations must [migrate to a new billing profile](#customer-billing-profile-overrides).
2626

27-
Billing profiles can be managed from the [**Billing Profiles**](https://cloud.konghq.com/metering-billing/billing-profiles) tab in **Metering & Billing > Settings** in the {{site.konnect_short_name}} UI.
27+
Billing profiles can be managed from the [**Billing Profiles**](https://cloud.konghq.com/metering-billing/billing-profiles) tab in **{{site.metering_and_billing}} > Settings** in the {{site.konnect_short_name}} UI.
2828

2929
### Invoicing settings
3030

@@ -64,7 +64,7 @@ Customer overrides can be useful for the following use cases:
6464
* **Enterprise billing**: Set up one billing profile for SaaS customers and another for Enterprise customers (with send invoice for bank transfer selected).
6565
* **Migrating customers billing**: Create a new billing profile that you want to migrate customers to and then assign them to the new profile with a customer override.
6666

67-
Configure customer overrides by navigating to **Metering & Billing** > [**Billing**](https://cloud.konghq.com/metering-billing/customers), click a customer, then navigate to the **Billing Profile** section of the customer settings.
67+
Configure customer overrides by navigating to **{{site.metering_and_billing}}** > [**Billing**](https://cloud.konghq.com/metering-billing/customers), click a customer, then navigate to the **Billing Profile** section of the customer settings.
6868

6969
## Tax calculations
7070

@@ -84,7 +84,7 @@ The invoice document maintains comprehensive and structured information that is
8484
* The total amount of taxes
8585
* The total amount after taxes and discounts charged to the customer
8686

87-
To view invoices in {{site.konnect_short_name}}, navigate to **Metering & Billing** > **Billing** and click the **Invoices** tab.
87+
To view invoices in {{site.konnect_short_name}}, navigate to **{{site.metering_and_billing}}** > **Billing** and click the **Invoices** tab.
8888

8989
### Invoice lifecycle
9090

@@ -155,7 +155,7 @@ Subscriptions automate the billing lifecycle by:
155155

156156
Subscriptions can be created from predefined plans or fully customized at creation time to accommodate unique customer requirements. This flexibility supports everything from self-serve sign-ups to enterprise contract negotiations.
157157

158-
To add a subscription to a customer, navigate to **Metering & Billing** > **Billing**, click your customer, and then click the **Subscriptions** tab in the {{site.konnect_short_name}} UI.
158+
To add a subscription to a customer, navigate to **{{site.metering_and_billing}}** > **Billing**, click your customer, and then click the **Subscriptions** tab in the {{site.konnect_short_name}} UI.
159159

160160
## Plan migration
161161

0 commit comments

Comments
 (0)