# How Metronome works with Stripe

Use Metronome for usage-based billing alongside Stripe for payment collection.

Use Metronome with Stripe to bill for advanced pricing models. Metronome handles usage-based billing, credit-based pricing, enterprise contracts, and multi-dimensional rating. Stripe handles payment collection, tax calculation, Revenue Recognition, data export, and fraud screening with [Radar](https://docs.stripe.com/radar.md).

Your billing model and growth strategy determine how you [integrate Metronome with Stripe](https://docs.stripe.com/billing/how-metronome-works-with-stripe.md#get-started).

## Get started

Follow these steps to begin your integration:

1. [Choose an integration pattern](https://docs.stripe.com/billing/how-metronome-works-with-stripe.md#integration-patterns).
2. [Create your Metronome account](https://signup.metronome.com/) if you don’t have one.
3. [Set up Metronome with Stripe](https://docs.metronome.com/integrations/invoice-integrations/stripe).

For the complete setup checklist, see [Set up Metronome with Stripe](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md).

## Metronome-supported billing models

Metronome supports billing models for both product-led growth (PLG) and sales-led growth (SLG) strategies. You can combine these models to serve different customer segments and lifecycle stages within a single system. Learn more about [Metronome pricing](https://metronome.com/pricing).

### Self-serve and PLG models

- Pure usage-based billing with automatic collection
- Prepaid credit wallets with usage burn-down
- Auto-recharge when balances drop below a threshold
- Payment-gated credit purchases where credits release only on successful payment
- Spend threshold models that cap exposure and reduce surprise bills
- Subscription lifecycles including trials, tier upgrades and downgrades, and hybrid prepaid-plus-overage

If you offer prepaid credits in a self-serve product, start with Metronome’s [Apply credits and commits to contracts](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit). To enable automatic recharges, see Metronome’s [Set prepaid balance thresholds](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds).

### Sales-led and enterprise models

- Postpaid commits with minimum spend agreements and true-up invoicing for overages
- Prepaid enterprise commits with burn-down and overage billing
- Usage-based invoicing with net terms
- Multi-wallet credit architectures with priority rules across scopes (for example, per-user pool first, then organization-level commit)
- Multi-entity and multi-Stripe configurations for regional or contract-specific setups

Committed spend is an amount a customer agrees to spend under a contract. If your enterprise agreements include committed spend, start with Metronome’s [Launch an enterprise commit model](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit). For product configuration, see Metronome’s [Create products](https://docs.metronome.com/guides/implement-metronome/core-concepts/create-products-contracts).

Many companies run both growth strategies in parallel. For example, they might start users on a free trial with spend thresholds, convert them to prepaid credits with auto-recharge, and graduate enterprise customers to committed contracts. For in-depth walkthroughs, see [Billing model guides](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/guides-home).

## Integration patterns

Choose a pattern based on how you want to manage recurring and usage-based billing.

| Metronome independently | Metronome with Stripe Subscriptions |
| --- | --- |
| **What it is:** Metronome handles all billing and metering, including rating and contract logic. | **What it is:** Stripe Subscriptions handles recurring seat-based or flat-rate billing. Metronome handles usage metering and billing separately. |
| **Choose it if:** You’re migrating from an existing usage-based billing system or don’t have one. | **Choose it if:** You already use Stripe Subscriptions for recurring billing and want to add usage-based pricing. |
| **What changes for you:** You use Metronome’s full billing platform and build custom integrations for some Stripe products, such as Checkout. | **What changes for you:** You keep existing subscription signup flows, including Checkout, Adaptive Pricing, Payment Links, and the API. Customers receive separate subscription and usage invoices on the same Stripe Customer. |

In both patterns, you send usage events to Metronome. For invoices sent to Stripe, Metronome finalizes the invoice first, then creates a corresponding Stripe invoice through the [Invoicing API](https://docs.stripe.com/api/invoices.md). Depending on your [integration settings](https://docs.metronome.com/integrations/invoice-integrations/stripe), the Stripe invoice can remain a draft for manual finalization. Stripe handles payment collection, tax calculation, Revenue Recognition, and reporting.

Invoices you create directly in Stripe aren’t synced to Metronome, but payment status for Metronome-created invoices syncs back automatically. For more information, see [How invoicing works](https://docs.metronome.com/guides/implement-metronome/core-concepts/how-invoicing-works).

### Metronome independently

Follow the [setup checklist](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md#setup-checklist) to set up Metronome with Stripe. For architecture planning guidance, see [Planning your billing architecture](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture).

### Metronome with Stripe Subscriptions

Complete the [setup checklist](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md#setup-checklist), then [add Metronome customers, contracts, and usage to your subscription flow](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md#configure-metronome-with-stripe-subscriptions).

## Stripe product compatibility

| Stripe product | Support level | Notes |
| --- | --- | --- |
| [Invoicing](https://docs.stripe.com/invoicing.md) | Fully supported | Metronome invoices become standard Stripe invoices. Manages accounts receivable, collections, and dunning. |
| [Tax](https://docs.stripe.com/tax.md) | Fully supported | Calculates tax at invoice finalization. |
| [Payments](https://docs.stripe.com/payments.md) | Fully supported | Processes payments, retries with [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md), screens fraud with [Radar](https://docs.stripe.com/radar.md). |
| [Stripe Data Pipeline and Stripe Sigma](https://docs.stripe.com/data.md) | Partially supported | Queries Stripe invoice, charge, and payment data. Metronome-specific data (metering events, contract state, credit ledgers) requires [Metronome data export](https://docs.metronome.com/guides/reporting-insights/data-export/overview). |
| [Checkout](https://docs.stripe.com/payments/checkout.md) | Requires custom integration | Checkout handles subscription signups and one-time payments. Metronome invoices use Stripe invoice payment flows (automatic charge or hosted invoice page), not Checkout. |

## Metronome concepts for Stripe developers

| Stripe analog | Metronome concept | Definition |
| --- | --- | --- |
| [Meter](https://docs.stripe.com/api/billing/meter.md) | [Billable metric](https://docs.metronome.com/guides/implement-metronome/core-concepts/create-billable-metrics) | Defines how to count customer usage (API calls, tokens, GB-hours). Supports SUM, COUNT, MAX, UNIQUE. |
| [Price](https://docs.stripe.com/api/prices.md) | [Rate](https://docs.metronome.com/guides/implement-metronome/core-concepts/create-manage-rate-cards) | A price mapped to a billable metric through a Rate Card, a reusable pricing template. |
| [Subscription](https://docs.stripe.com/api/subscriptions.md) | [Contract](https://docs.metronome.com/guides/implement-metronome/core-concepts/provision-contract) | Enterprise agreement defining a customer’s pricing terms, including rate cards, commits, credits, and schedules. It serves as Metronome’s equivalent of a Stripe `Subscription`, but it can also contain Metronome subscriptions. |
| [CreditGrant](https://docs.stripe.com/api/billing/credit-grant.md) | [Prepaid commit](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit) | Up-front payment for committed usage. Credits draw down over time. |
| No direct analog | [Postpaid commit](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit) | Minimum spend agreement. True-up invoice if usage falls short. |
| [Credit balance](https://docs.stripe.com/api/billing/credit-balance-summary.md) | [Credit ledger](https://docs.metronome.com/api-reference/credits-and-commits/list-balances) | Tracks credit balances, credit deductions, expirations, and rollovers. |
| No direct analog | [Threshold billing](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds) | Auto-recharge when credit balance drops below a threshold. |
| No direct analog | [Dimensional pricing](https://docs.metronome.com/guides/implement-metronome/core-concepts/create-manage-rate-cards#dimensional-pricing%E2%80%8B) | Price varies by attribute dimensions on the same metric. |

If you use Stripe Subscriptions for recurring billing, follow [Configure Metronome with Stripe Subscriptions](https://docs.stripe.com/billing/set-up-metronome-with-stripe.md#configure-metronome-with-stripe-subscriptions).

For invoice processing and attribute ownership, see the [invoice lifecycle](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#invoice-lifecycle) and [invoice attributes](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#invoice-attributes).

For collection, credit release, and invoice management, see [payments](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#payments), [payment-gated commits](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#payment-gated-commits), [payment failures](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#payment-failures), and [post-invoice operations](https://docs.stripe.com/billing/metronome-invoice-payment-reference.md#post-invoice-operations).

## See also

- [How Metronome works](https://docs.metronome.com/guides/get-started/how-metronome-works)
- [API quickstart](https://docs.metronome.com/guides/get-started/api-quickstart)
- [Metronome API reference](https://docs.metronome.com/api-reference/introduction)
