---
source_url: "https://docs.metronome.com/guides/get-started/how-metronome-works"
title: How Metronome works - Metronome
mirrored_at: 2026-08-21T01:01:45.488Z
host: docs.metronome.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/docs.metronome.com/guides/get-started/how-metronome-works"
---

> **Original source:** https://docs.metronome.com/guides/get-started/how-metronome-works

At its core, Metronome transforms your customers’ usage into precise, tailored invoices that reflect your unique business model. Let’s start by looking at the end result — an invoice — and break down the building blocks that make it possible.

While simple invoices might seem to follow the basic formula **Price × Quantity = Charge** , modern usage-based billing requires a more sophisticated approach that includes a third critical element: your **Commercial Model**. Metronome’s data architecture is built on three essential foundations - one for each part of this calculation:

This comprehensive approach ensures you can not only calculate what customers owe but also encode how they should pay—whether through subscriptions, credits, commitments, or consumption-based billing. In the following sections, we’ll explore each building block to show how Metronome’s flexible architecture adapts to your evolving business needs.

## Quantity: Usage Tracking & Aggregation​

In usage-based billing, **quantity** represents how much your customers actually use your platform. Unlike traditional subscription models with fixed fees, usage-based billing requires accurately measuring customer activity — whether that’s API calls made, data processed, storage consumed, or users onboarded. Metronome’s approach to determining these quantities gives you exceptional flexibility through two key components:

-   [**Usage Events**](https://docs.metronome.com/guides/get-started/core-concepts/send-usage-events) capture the raw data about customer activity directly from your platform
-   [**Billable Metrics**](https://docs.metronome.com/guides/get-started/core-concepts/create-billable-metrics) transform this activity data into meaningful, billable quantities by defining both what to measure (filtering) and how to measure it (aggregation)

### Usage Events​

[Usage events](https://docs.metronome.com/guides/events/design-usage-events) are the raw data about how customers interact with your platform—API calls, storage consumption, user logins, or any measurable interaction. Metronome lets you design your own usage schema around your business needs. [Send usage events via our API](https://docs.metronome.com/guides/get-started/core-concepts/send-usage-events) in the format that makes sense for your operations, without conforming to rigid predefined structures.

### Billable Metrics​

[Billable metrics](https://docs.metronome.com/guides/get-started/core-concepts/create-billable-metrics) transform raw usage events into meaningful quantities that appear on an invoice. They define how to meter, filter, and aggregate usage into billable units. Define exactly what you want to measure—from simple counts to complex aggregations with custom filters and groupings. One usage event can feed multiple billable metrics, giving you the flexibility to meter anything your customers use.

> **Strategic Insight:** By separating raw usage collection from billable metrics, you can evolve your metering model without changing how you instrument your application. Your engineering team simply instruments your application to send activity data, while your business team configures how to bill for it—all without additional code changes.

## Price: Products & Rate Cards​

While the quantity side of our equation deals with measuring usage, to configure the **price** for each metric, you must first define what you’re selling and how much you charge for it. Metronome provides two components designed specifically for these tasks:

-   [**Products**](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts) define what you’re selling to customers
-   [**Rate Cards**](https://docs.metronome.com/guides/get-started/core-concepts/create-manage-rate-cards) establish how much you charge for those products

### Products​

[Products](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts) define what you actually sell to customers—the individual SKUs that appear as line items on your invoices. Metronome supports multiple product types to accommodate different types of charges, including usage-based, fixed, or subscription charges. This ensures your product catalog represents everything you might charge for, not just usage-based items.

Your product catalog gives you control over both billing logic and presentation. You can:

-   **Customize invoice appearance** by determining how quantities are displayed, whether they’re rounded, or how they’re converted
-   **Organize related SKUs** using product tags for easier management and reporting
-   **Control granularity** by presenting charges as either a consolidated lump sum or itemized by specific dimensions

This flexibility ensures your customers receive invoices that align with how they understand your value, rather than how your internal systems track usage.

### Rate Cards​

[Rate cards](https://docs.metronome.com/guides/get-started/core-concepts/create-manage-rate-cards) define the default pricing for your usage products across your entire customer base. Each rate includes what to charge per unit for specific start and end dates, enabling scheduled price changes, promotions, or gradual increases/decreases.

Through the rate card, Metronome decouples pricing from commercial models. This separation solves a key challenge in usage-based billing: maintaining consistent pricing while supporting diverse business arrangements. When you add a product to your rate card or update pricing, these changes automatically flow to all commercial models—whether customers are on subscriptions, consumption-based billing, or enterprise agreements.

## Contracts: Encode Your Commercial Model​

With quantities measured and prices defined, the final element in our equation is your Commercial Model—how customers actually pay for what they use. This is where Metronome truly differentiates from traditional billing systems. Your commercial model must answer three essential questions:

-   **What** has the customer agreed to pay for? (products and rates)
-   **How** have they agreed to pay? (arrears, commitments, credits, subscriptions)
-   **Where** should they be charged? (payment systems and marketplaces)

In Metronome, all these elements are defined in a **Contract**.

### Contracts​

[Contracts](https://docs.metronome.com/guides/get-started/core-concepts/provision-contract) connect customers to your pricing structure and define their specific commercial arrangement. Unlike rigid plan-based systems, Metronome contracts let you configure each aspect of the commercial relationship:

-   **Base Pricing** : Inherit standard rates from your rate cards
-   **Custom Terms** : Apply overrides like percentage discounts or custom per-unit pricing
-   **Product Access** : Enable or disable specific products for different customer segments
-   **Payment Structure** : Configure commitments, credits, or subscription fees
-   **Billing Cycles** : Determine invoice frequency and timing

This modular approach means you can support any commercial model your business requires:

-   **Pay-as-you-go** : Bill customers in arrears for their actual usage
-   **Prepaid Credits** : Sell credits upfront that draw down with usage
-   **Subscriptions with Overage** : Provide usage allowances with charges for exceeding thresholds
-   **Enterprise Commitments** : Secure minimum spend commitments with discounts
-   **Hybrid Models** : Combine any of these approaches for specific customer segments
-   And many more!

Once a customer is on a contract, Metronome automatically starts to generate usage statements based on the defined parameters. If a customer has credits, we track utilization and drawdown. If they’re on pay-as-you-go, they’re charged at the end of their billing period. For commitments, we monitor actual usage against committed amounts. All elements of Metronome contracts are programmable via API, allowing you to build self-serve workflows, custom pricing pages, or enterprise quote-to-cash systems on the same foundation.

## Invoice Generation: Bringing It All Together​

When it’s time to generate an invoice, Metronome:

1.  **Receives usage data** from your events for the billing period
2.  **Processes this data** through the appropriate billable metrics to calculate quantities
3.  **Applies pricing** from the customer’s contract, including any overrides from the base rate card
4.  **Generates an invoice** that clearly communicates charges to your customer

Metronome’s dynamic invoice generation happens:

-   **Real-time with usage** - Every time usage is sent, Metronome evaluates [customer alerts and thresholds](https://docs.metronome.com/guides/customers-billing/set-up-notifications/create-and-manage-notifications) to send webhooks if spending limits are reached or credits are depleted
-   **On-demand via API** - Whenever the Metronome APIs are called, [powering real-time dashboards](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/customer-dashboards-and-reporting) in your end-user applications
-   **At billing cycle close** - When a customer invoice is finalized and [sent to your system of choice](https://docs.metronome.com/guides/invoices/overview), such as at the end of the month or quarter

## Ready to Get Started?​

Follow the [API quickstart](https://docs.metronome.com/guides/get-started/api-quickstart) to begin setting up Metronome, or dive deeper with our detailed guides:

-   [Usage Events](https://docs.metronome.com/guides/events/design-usage-events)
-   [Billable Metrics](https://docs.metronome.com/guides/get-started/core-concepts/create-billable-metrics)
-   [Products](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts)
-   [Rate Cards](https://docs.metronome.com/guides/get-started/core-concepts/create-manage-rate-cards)
-   [Customers](https://docs.metronome.com/guides/get-started/core-concepts/provision-customer)
-   [Contracts](https://docs.metronome.com/guides/get-started/core-concepts/provision-contract)
-   [Packages](https://docs.metronome.com/guides/get-started/core-concepts/packages-overview)