Understand Maxio Metering

Maxio Metering tracks customer activity in Advanced Billing and turns that activity into usage-based charges on invoices. Use Metering when your pricing depends on measurable customer actions, such as API calls, data transferred, documents processed, or similar usage events.

How Maxio Metering works

Metering uses two primary objects:

• Stream: Defines the structure of the events your system sends to Maxio.
• Meter: Defines how usage is calculated from events in a stream.

Events flow into a stream. Meters read those events and calculate usage values. Those usage values feed billing components on customer subscriptions.

Maxio Metering allows you to:

• Define your usage schema before sending data
• Ingest high-volume events
• Calculate usage with flexible aggregation
• Segment usage across dimensions
• Connect usage to billing

Requirements

Before using Maxio Metering, confirm the following requirements:

• Your site uses Maxio Advanced Billing.
• Your site is US-hosted.
• Metering is enabled for your site.

Contact your Customer Success Manager or Maxio Support to request Metering activation.

When to use Maxio Metering

Use Maxio Metering when your billing model depends on customer activity.

Metering is a good fit when you need:

• Real-time usage ingestion
• Pricing across more than one event property
• Schema-first setup before sending event data
• Pricing changes without changes to your event pipeline

If your team aggregates usage before sending it to Maxio, use the existing usage import or usage submission workflow instead.

Related articles in this section

Use the following articles to set up, configure, and troubleshoot Maxio Metering:

• Get Started with Maxio Metering: Set up a stream, create a meter, and send a test event.
• Understand Streams, Meters, and Segments: Understand the core Metering objects and how they relate.
• Choose the Right Aggregation Type: Choose between Count, Sum, Average, Minimum, Maximum, and Count Unique.
• Configure Maxio Metering: Review Metering settings, stream fields, event properties, identifiers, meters, and segments.
• Design Your Catalog: Using Metering with Components: Connect meters to metered components and pricing.
• Understanding Meter Results in Billing: Learn how usage flows into invoices.
• Troubleshoot Metering Issues: Resolve missing events, invalid events, incorrect totals, and missing invoice charges.