Plans overview
Plans are the packaging boundary that turns catalog resources into enforceable commercial behavior.
At a high level:
- Catalog defines what exists: feature families, features, and meters.
- Plans define what an account can do: entitlements, limits/policies, and pricing intent.
- Assignment makes the plan effective for a billing account over time.
Vluna supports two common plan-source patterns:
- Direct plan assignment (sales-led).
- Provider self-serve (checkout and portal flows).
Prereqs
- You understand identity mapping: Identity mapping: principal to billing account.
- Catalog exists: Define your product catalog.
What is a billing plan
A billing plan is a sellable package that can be assigned to a billing account.
What a plan typically includes:
| Area | Examples |
|---|---|
| entitlements | which feature families are allowed |
| limits | quota and rate policy intent |
| funding design | included credits/grants and plan-linked value strategy |
Plan-centered wiring:
- Access chain:
plan -> entitlements -> feature family/feature - Feature-to-meter chain:
feature family/feature -> meter_code - Pricing chain:
meter_code -> meter pricing baseline (+ optional contract-term-based pricing) -> priced outcome - Enforcement chain:
plan -> limit intent -> gate policies -> runtime decisions
Choose a plan source
Before choosing a source, define your pricing model baseline:
Direct assignment (recommended for sales-led)
Your backend assigns an effective plan to a billing account for a window.
See:
Provider self-serve (optional)
Your frontend uses checkout and portal flows and the provider becomes the purchase source of truth.
See:
Next
- Entitlements and policy model: Entitlements, Limits and policies, Gate policies and bundles
- Optional gate policy design: Policy model, Policy evaluation
- Assignment windows: Windows and precedence
- JSON contracts: Metadata-driven configuration