Skip to main content

Core concepts & data flow

Billerang is a multi-tenant monetization platform. It takes a catalog of what you sell, captures orders, rates usage, and produces invoices you can collect on. This page is the mental model that ties every module together. Read it once and the rest of the docs will map cleanly onto it.

The quote-to-cash pipeline​

Everything in Billerang moves left to right along one pipeline. Each stage owns a few entities and hands off to the next.

Quote-to-cash pipeline
  • Catalog defines what can be sold and how it is priced.
  • Orders turn a customer's intent into active subscriptions.
  • Subscriptions hold the services a customer is entitled to, over time.
  • Usage & rating convert raw events into priced rated transactions (RTs).
  • Billing aggregates RTs into invoice lines and produces invoices.
  • Receivables track who owes what and match incoming payments.

The account hierarchy​

Customer data hangs off a strict hierarchy. Each level has one job, so you always know where a piece of configuration belongs.

Account hierarchy

The two levels that matter most day to day: the Customer Account is where payment methods live, and the Billing Account is where the billing cycle is assigned and invoices are produced. Full detail in Account hierarchy.

Two ways to work​

You can drive Billerang two ways, and this documentation is split to match.

Use BillerangThe platform guideFunctional walkthroughs that mirror the app: catalog, orders, billing, receivables.Build on BillerangThe v1 APIThe canonical REST API, with auth, quickstarts, and interactive explorers.

Where to go next​

Quick startCatalog to first invoice in one sitting.Catalog managementOffers, products, charges, and price plans.Billing managementBill runs, aggregation, and invoicing.Real-world scenariosStreaming, AI usage, prepaid, and more.