Skip to main content

Subscription group modeling

Subscription groups define packaging constraints for self-serve offers.

They answer "what combinations are valid", "how transitions work", and "how the effective plan is derived".

Model choices

PatternMeaningTypical use
exclusive tier groupcustomer chooses one tier from manybase plans (starter/pro/business)
additive add-on groupadd-ons can coexist with base tiercapacity packs, premium modules
conditional add-on groupadd-on requires specific base tiersenterprise-only modules

Structural constraints

  • Recurring prices must define a subscription group.
  • When recurring cadence is configured, group identity should be explicit and stable.
  • A single provider subscription should not span multiple subscription groups.
  • For non-stackable groups, an account can hold only one active/trialing subscription at a time.

Transition rules to define explicitly

  • upgrade timing
  • downgrade timing
  • cancellation timing
  • mid-cycle proration/credit policy

Governance guidance

  • Keep compatibility matrices versioned and auditable.
  • Treat group-rule changes as migration events, not silent config edits.
  • Validate purchase intent against group rules on backend, not only UI.

Verify

  • Invalid combinations are blocked consistently across UI and backend.
  • Transition outcomes are deterministic for overlapping requests.
  • Support can explain effective subscription state from group rules plus event history.

Next