LogoLogo
Using BunnyDeveloper
  • Getting started
    • Welcome to Bunny
    • Superdesk - Sample SaaS Co.
  • Product tour
    • Admin UI
      • Tables
      • Forms
      • Search (beta)
    • Product catalog
      • What's a product?
      • Product quick start
      • Products
      • Features
      • Feature editor
      • Plans
      • Price lists
      • Charges
      • Coupons
      • Categories
      • Platforms
      • Tenants
    • Customer management
      • Accounts
      • Contacts
      • Deals
      • Subscriptions
      • Leads
      • Campaigns
    • Subscription management
      • What is a subscription?
      • Subscription states
      • Trial subscriptions
    • Quoting
      • What is a quote?
      • Quote states
      • Quote builder
      • Building a quote
      • Sharing a quote
      • Applying a quote
      • Undoing a quote
      • Amendments
      • Renewals
      • Cancellations
    • Approval workflows
      • How approvals work
      • Approvers
      • Approval rules
    • Customer portal
      • Viewing quotes
      • Invoice history
      • Paying invoices
      • Subscriptions
    • Billing
      • Bill runs
      • Invoices
      • Credit notes
      • Price adjustments
      • Proration
      • Billing day
      • Currencies
      • Sales tax and VAT
      • Payment methods and types
      • Payment plugins
      • Usage records
      • Revenue movements
    • Entities
      • Invoices
      • Quotes
      • Branding
    • Accounting
      • GL mappings
      • Journal entries
      • Revenue recognition
      • Intracom VAT summary
    • Workflows
    • Analytics
      • Using analytics
      • Trials
      • Monthly Recurring Revenue
      • Collections
    • Access control
      • Users
      • Roles
      • Groups
      • API clients
    • Settings
      • Company
      • Outbox
      • Jobs
      • Security
      • Single sign-on
  • Advanced guides
    • Integrations
      • Airbyte
      • Avalara AvaTax
      • Docusign
      • Dropbox Sign
      • HubSpot
      • Mailchimp
      • QuickBooks
      • PandaDoc
      • Salesforce
      • SendGrid
      • Slack
      • Stripe
      • Xero
    • Single sign-on
    • SCIM user provisioning
  • Best practices
    • Pricing by number of users
    • Committed + overage pricing
  • Release notes
    • April 22, 2025 release
    • Mar 28, 2025 release
    • Mar 13, 2025 release
    • Feb 27, 2025 release
    • Feb 13, 2025 release
    • Jan 24, 2025 release
    • Jan 16, 2025 release
    • 2024 Releases
      • Dec 19, 2024 release
      • Dec 12, 2024 release
      • Dec 9, 2024 release
      • Nov 21, 2024 release
      • Nov 14, 2024 release
      • Nov 1, 2024 release
      • Oct 25, 2024 release
  • Legal
    • Terms of service
    • Privacy
    • Subprocessors
Powered by GitBook
On this page
  • From product catalog to subscription
  • Charges are copied to subscriptions
  • Price override

Was this helpful?

  1. Product tour
  2. Subscription management

What is a subscription?

PreviousSubscription managementNextSubscription states

Last updated 3 months ago

Was this helpful?

Enterprise subscriptions are very complex compared to B2C subscriptions, such as gym memberships or online streaming services, which cost a simple flat fee every month.

Not only are enterprise deals highly negotiated, but once the deal is closed, the subscription will most likely undergo a number of changes throughout its lifetime; different quantities, add-ons, renewals etc.

The timeline below shows how a customer starts with an Enterprise product with 1000 users, which grows to 1500 and then also subscribes to a Advanced API plan, which also grows in clients.

A subscription is a relationship between an account and a product plan.

Accounts never subscribe directly to a product since a product can have multiple plans with different pricing. Therefore, the subscription is always to the plan and the product is implicitly inferred.

An account can subscribe to multiple different product plans on different products. Bunny's quote builder helps the user co-term the subscriptions so the customer doesn't drown in invoices.

From product catalog to subscription

The only way a subscription can be created or updated is via a quote. This is a fundamental principle in Bunny and the quotes act as a transaction history of what happened to an account's subscriptions.

All subscriptions are based on products in the product catalog. Quoting the mechanism that copies charges from the product catalog to an account's subscriptions. Consider the diagram below.

The solid lines in the diagram show how the objects are related to each other and the dotted lines show how data is copied from products to quotes to subscriptions. If you are a developer working on subscriptions via Bunny's API, this is very important to understand. If you are merely going to use Bunny's user interface, just appreciate that we have made this complex process simple.

Charges are copied to subscriptions

It's important to note that charges are actually copied to a quote and then copied onto the account's subscriptions. This means that if you subsequently make price changes in the product catalog, they will not automatically affect accounts subscribing to that product. The reason for this is that each account is a separate contract with the customer and you don't want to just bulk change contracts across your customer base.

Price override

By default, price override is performed on quotes, but for self-service subscriptions where customers will always get the latest pricing, price override is disabled. This causes subscriptions to be updated with the latest pricing from the product catalog when they are auto-renewed.

Subscription timeline
Quotes copy charges from product catalog to subscriptions