--- title: "How usage-based billing works: from product setup to credit note" slug: "usage-based-billing-lifecycle" description: "Learn the complete Frisbii Billing usage-based billing lifecycle, from product setup and usage tracking to invoicing, credits, and refunds." updated: 2026-10-26T10:49:13Z published: 2026-10-26T10:49:13Z canonical: "help.frisbii.com/usage-based-billing-lifecycle" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.frisbii.com/llms.txt > Use this file to discover all available pages before exploring further. # How usage-based billing works: from product setup to credit note **Plans supporting this feature:** Growth Scale ## Overview This article walks you through the complete lifecycle of a usage-based billing product in Frisbii Billing: how you create the product, add it to a subscription, record usage, how invoices are generated, where usage appears on the invoice, how the subscription view changes, and how credits and refunds work. Use this article as an end-to-end overview. For field-by-field details, follow the links to the dedicated articles in each section. > [!NOTE] > **Note** > > Usage-based billing products are different from add-ons and additional costs. Add-ons are billed for a quantity declared upfront. Additional costs are one-off, free-form order lines. Usage-based billing products charge for usage that is reported during the billing period and billed afterwards. --- ## The lifecycle at a glance 1. You create a usage-based billing product in the product catalogue. 2. You add the product to a subscription, either manually or automatically when usage is first reported. 3. Usage is recorded against the subscription, via the API or manually in Frisbii. 4. At the end of the billing period, Frisbii aggregates the usage, prices it and adds it to the invoice. 5. If needed, you correct the invoice with a credit note or a refund. --- ## Step 1: Create the usage-based billing product The usage-based billing product defines what you measure and how usage is priced. 1. Open the menu item **Configurations → Product catalogue → Usage-based billing**. 2. Click **New**. 3. Enter a **Name** and a **Handle**, and optionally a **Description**. 4. In the pricing section, set the **Currency**, the unit (for example "GB" or "API call"), the **Included Units**, the **Minimum Fee**, the **Pricing Model**, the VAT and the usage ranges (**From** – **To**). 5. Choose how the usage is calculated at the end of the billing period: **Sum of All Usages**, **Maximum of All Usages** or **The Latest Usage**. 6. Optionally, enable **Enable Auto-add to Subscription on Usage** so the product is added to a subscription automatically as soon as usage is reported for it. 7. Optionally, choose whether zero-amount usage line items appear on the invoice. This works the same way as the zero-amount setting on plans. 8. Optionally, set a separate billing frequency: click **More options**, select **Billing frequencies** and confirm, then define **When do you want to bill?** and **How often do you want to bill?**. 9. Click **Save**. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/image-93T7SCQV.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A18%3A41Z&se=2026-11-22T18%3A18%3A41Z&sr=b&sp=r&sig=ZSA1glAxeMhfFfbFicAEktxGTRKEcOknm9Ci5T%2BNL48%3D) Use the **Pricing Calculator** on the product page to check how your pricing model prices a given number of units before you use the product on subscriptions. > [!NOTE] > **Note** > > - The **Minimum Fee** applies even if no usage occurs in the billing period. > - Usage ranges only accept whole-number units. > - The price on a usage-based billing product always refers to its own billing period, not the plan's period. For all fields and pricing models, see [Usage-based billing](/frisbii/docs/usage-based-billing). --- ## Step 2: Add the product to a subscription There are three ways to add a usage-based billing product to a subscription. ### While creating a subscription 1. Create the subscription and select the plan. 2. In the **Subscriptions options** section, click **Add Usage-based billing product**. 3. Select the usage-based billing product. 4. Under **How would you like to manage the unbilled usage?**, choose whether to write off unbilled usage or bill it in the next billing cycle. This is relevant if you removed the product from the subscription and add it again within the same billing cycle. 5. Under **Select your preferred pricing strategy**, choose **Fixed** (the currently valid price is always billed), **Flexible** (the price follows later changes to the product price) or **Custom** (a price specific to this subscription). 6. Click **Confirm**. ### On an existing subscription 1. Open the subscription via **Subscriptions** or via the customer account. 2. In the **Usage-based billing** section, click **Add usage-based billing product**. 3. Select the product, choose the options described above and confirm. ### Automatically when usage is reported If **Enable Auto-add to Subscription on Usage** is active on the product, Frisbii adds the product to the subscription when the first usage for it is reported. > [!CAUTION] > **Limitations** > > - You can add each usage-based billing product only once to the same subscription. > - The product's billing frequency must be equal to or longer than the plan's billing frequency and must align with the plan's billing periods. Otherwise, you cannot save the configuration. > - If you switch a subscription to a plan with an incompatible billing frequency, incompatible usage-based billing products are removed from the subscription. Frisbii warns you before this happens. --- ## Step 3: The customer's subscription becomes active Usage-based billing charges in arrears: there is no upfront charge for usage when the subscription starts. Throughout the billing period, usage is collected on the subscription. At the end of the billing period, the collected usage is calculated with the strategy you chose (sum, maximum or latest) and priced with the configured pricing model, included units and minimum fee. --- ## Step 4: Record usage Usage is usually reported by your system via the API. You can also add usage manually. ### Add usage manually on the subscription 1. Open the subscription. 2. Click **Add metered usage record**. 3. Select the usage-based billing product and enter the number of units. 4. Optionally, enter a **Handle**. If you submit the same handle again within the same open billing period, Frisbii returns the existing record instead of creating a duplicate. 5. Optionally, enter **Period from** and **Period to**. These dates appear as the service period on the resulting invoice line. You must fill in both fields, and the start date cannot be later than the end date. 6. Confirm. You can set the same optional fields when you add usage during the invoice charge flow. ### Bill usage immediately with a one-time invoice If you do not want to wait for the next scheduled invoice, you can include unbilled usage on a one-time invoice: 1. Open the subscription and, in the **Invoices** box, click **Create invoice**. 2. Click **Include from subscription**. 3. Select the usage-based billing product and confirm. 4. Set the service period for the invoice line. 5. Complete the invoice options and submit. See [Create a One-Time Invoice for a Subscription](/frisbii/docs/creating-a-manual-invoice-for-a-subscription). --- ## How the subscription view changes Once a usage-based billing product is on a subscription, the subscription details page shows: - A **Usage-based billing** section listing each product with a pricing strategy badge (`fixed`, `flexible` or `custom`). Active products are listed before deleted products. - Up to two pricing ranges directly below the product name. If there are more ranges, a **more** link opens a full price preview. - For products with a `fixed` or `custom` pricing strategy, a view button that opens a read-only price preview with all unit ranges, included units, minimum fee and tax policy. - The list of usage records, with the most recent records first. - Written-off usage, marked as written off and shown as read-only history. Written-off usage is not billable and is excluded when invoices are created. If the plan uses a [billing delay](/frisbii/docs/finalize-an-invoice#usagebased-billing-behavior), a blue banner on the subscription indicates that usage and the invoice amount may still change before the invoice is finalized. --- ## Step 5: How invoices are created ### Regular billing On the billing date, Frisbii adds the calculated usage charge as an order line to the subscription invoice. - If the usage-based billing product uses the plan's billing frequency, the usage line appears on the same invoice as the plan. - If the product has its own billing frequency, it is invoiced on a separate invoice on its own billing date. If its billing date coincides with the plan's billing date, it can be included on the plan's invoice. ### With a billing delay If the plan has a billing delay, the invoice is created on the renewal date with the status **Unfinalized**. While the invoice is unfinalized, usage can still be added within the billing delay. After the delay, the invoice is finalized automatically and moves to **Pending**. When you finalize the invoice manually, you can choose to bill outstanding usage now. This adds all usage recorded up to that point before the invoice is finalized. If you cancel an unfinalized invoice, Frisbii finalizes it first and applies the usage before the cancellation is processed. > [!NOTE] > **Note** > > The first invoice of a subscription and invoices created after a reactivation are never delayed. ### When the subscription ends When a subscription with a usage-based billing product ends, the last usage charge is billed and an accounting invoice and PDF are generated for this last billing period. See [Delay Invoice generation for a subscription plan](/frisbii/docs/finalize-an-invoice) and [Set different billing frequencies for add-ons and usage-based billing products](/frisbii/docs/different-billing-frequencies). --- ## Which usage appears on the invoice and where - **Which usage:** only unbilled usage is included. Usage that was billed on an earlier invoice and written-off usage are excluded. - **Where:** the usage charge appears as an order line for the usage-based billing product on the subscription invoice, or on a separate invoice if the product has its own billing frequency. - **Service period:** every order line on a subscription invoice, including usage lines, shows a service period. For usage lines, the service period reflects only the usage that is part of the current bill. With **Maximum of All Usages** or **The Latest Usage**, it follows the record that determined the billed units. If you set **Period from** and **Period to** on usage records, these dates appear on the invoice line. - **Zero amounts:** whether a usage line with a zero amount appears on the invoice depends on the zero-amount setting of the usage-based billing product. - **One-time invoices:** when you include usage on a one-time invoice, you set the service period yourself. The invoice PDF shows product descriptions and timestamps in the service periods if you have enabled **Include product descriptions** and **Include Timestamps** under **Configurations → Finance and accounting → Invoices and credit notes**. --- ## Step 6: Credits, credit notes and refunds ### Credit on the next invoice To reduce what the customer owes on an upcoming invoice, add a credit to the subscription in the **Pending costs and credits** box. The credit appears as a negative order line on the next invoice or on a date you choose. If the credit is higher than the invoice amount, the remaining amount is deducted from future invoices. See [Add credit to a subscription](/frisbii/docs/add-credit-to-subscription). ### Credit note and refund on an invoice Usage order lines can be credited with a credit note in the same way as other invoice lines. Refunding a settled invoice creates a credit note for the customer. - The credit note uses the original order line amounts of the invoice. - Discounts on the subscription are applied to the credit note in the same way as on the original invoice. - Customer details (name, company, address) are taken from the original accounting invoice. ### Subscription changes When you upgrade, downgrade or cancel a subscription whose components have different billing frequencies, Frisbii prorates each component based on its own billing window. Credits and refunds are calculated per component and applied automatically. > [!NOTE] > **Note** > > The title of your credit note documents is configurable: under **Configurations → Finance and accounting → Invoices and credit notes**, choose between "Credit note" and "Cancellation invoice". ---