> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macropay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing

> Price and invoice metered usage on subscriptions — with tax remitted for you as Merchant of Record.

Once a [meter](/features/usage-based-billing/meters) is counting events, the next decision is what each unit costs and how it lands on an invoice. This page covers how Macropay turns aggregated usage into money: the metered pricing models, when charges are billed, and what customers see.

Because Macropay is your Merchant of Record, the math on top of the usage — global sales tax and VAT — is handled for you. You publish a price per unit; we calculate, collect, and remit the tax on every invoice, in every jurisdiction, so metered revenue doesn't expand your compliance surface.

## Metered pricing models

A metered price binds a meter to a per-unit rate. As events are ingested and aggregated, the meter's total is multiplied by that rate to produce the charge.

| Model              | How it works                                                                  | Status      |
| ------------------ | ----------------------------------------------------------------------------- | ----------- |
| **Unit pricing**   | A flat rate for every unit consumed — linear, no thresholds.                  | Available   |
| **Volume pricing** | Tiered rates where the unit price changes as total volume crosses thresholds. | Coming soon |

### Unit pricing

Unit pricing charges the same amount for each unit, no matter how many are consumed. It's the right default for token billing, API calls, and most AI-agent metering, where you want a predictable rate card.

Say you're billing an LLM feature and meter prompt and completion tokens separately:

| Meter               | Price per unit |
| ------------------- | -------------- |
| `prompt-tokens`     | \$0.10         |
| `completion-tokens` | \$0.18         |

A customer who consumes 1,000 `prompt-tokens` and 400 `completion-tokens` in a period is charged `(1,000 × $0.10) + (400 × $0.18) = $172.00` for usage — before tax, which Macropay adds and remits on your behalf.

<Tip>
  Pricing per meter is independent. Mix metered prices with a fixed base fee on
  the same subscription to build hybrid plans — a flat platform fee plus
  pay-as-you-go usage on top.
</Tip>

### Volume pricing *(coming soon)*

Volume pricing lets the unit rate step down (or up) as a customer's total volume crosses thresholds — for example, a lower per-token rate after the first million tokens. This model is on the roadmap and not yet available.

## Adding a metered price

Metered prices attach to subscription products. To start charging for usage, add one to your product, selecting the **meter** to bill against and the **amount per unit**.

<img className="block dark:hidden" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/features/usage/cap.light.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=9ca85e64226cf74d5069d13986470ebd" width="1434" height="752" data-path="assets/features/usage/cap.light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/features/usage/cap.dark.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=1a39ea6de112c46bd013c818b7b6f615" width="1444" height="748" data-path="assets/features/usage/cap.dark.png" />

You can also set an optional **cap**. Once a customer's usage charge in a period reaches the cap, the charge is held at that amount no matter how much more they consume — a simple way to give customers a predictable ceiling.

<Note>
  Pairing metered prices with prepaid
  [credits](/features/usage-based-billing/credits) is a common pattern: grant
  credits up front, draw them down against usage, then bill the overage.
</Note>

## When usage is invoiced

Usage-based charges ride along with the subscription's billing cycle. Usage accumulates over the period and is settled on the same invoice as the rest of the subscription.

<Tabs>
  <Tab title="Monthly billing">
    Usage is aggregated across the month and invoiced at the end of the billing
    period, together with any recurring subscription fees.
  </Tab>

  <Tab title="Yearly billing">
    Usage is aggregated across the full year and invoiced at the end of the
    annual period, alongside the subscription renewal.
  </Tab>
</Tabs>

### Cancellations and the grace period

Cancelling a subscription doesn't drop accrued usage charges. The subscription stays active through the end of the current billing period — the grace period — and usage continues to be tracked the whole time. At the end of that period, a final invoice settles the consumed usage, even though the subscription won't renew. Nothing billable is lost on the way out.

<Warning>
  When a [discount](/features/discounts) is applied to the subscription, it
  reduces the **entire invoice**, metered usage included — not just the
  recurring base fee.
</Warning>

## What customers see

Customers track their running usage and estimated charges per meter from the customer portal, so there are no surprises at invoice time.

<img className="block dark:hidden" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/features/usage/portal.light.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=4e95c225d4f74a6bbb1bb1ccf20c43de" width="2358" height="1218" data-path="assets/features/usage/portal.light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/macrodeepinc/rPF293t5zy_Onjx_/assets/features/usage/portal.dark.png?fit=max&auto=format&n=rPF293t5zy_Onjx_&q=85&s=1d6dfd7c7d9e87466db8b372bc8c892b" width="2364" height="1214" data-path="assets/features/usage/portal.dark.png" />

Every invoice Macropay issues lists Macropay as the seller of record and itemizes the tax we collect and remit for you, keeping your usage-based revenue compliant in each customer's jurisdiction without any tax engine on your side.