Skip to main content
A B2B SaaS setup in Alguna is a catalog of a few products (platform fee, seats, usage), two or three plans built from them, self-serve checkout for the smaller plans, and quotes for enterprise. The same subscription object serves both, so a customer who starts on self-serve and grows into a negotiated contract never changes billing systems. This quick start builds that catalog; see How Alguna Works for the chain it feeds.

​
Common SaaS pricing models

See Pricing Models for all eleven types with worked examples.

​
Set up

1

Create the product catalog

Under Products (or POST /products) create:
  • Platform fee — fixed, recurring, advance
  • Seats — fixed, recurring
  • API calls or another usage product — metered, arrears, linked to a billable metric
See Configure Products.
2

Build the plans

Under Plans (or POST /plans):
  • Starter — a monthly platform fee, monthly_rolling, a small included usage allowance (a zero-rate first tier), entitlements for the basic feature set
  • Professional — per-seat pricing, more entitlements, optional annual billing_interval with a plan discount
  • Enterprise — the template reps start quotes from; see Sales-Led
See Manage Plans.
3

Set billing defaults

Under Settings → Organization → Billing & collection, set default payment terms, whether invoices auto-issue and auto-pay, and email delivery. Plans and customers can override. See Invoicing configuration.
4

Open self-serve checkout

Let buyers pick Starter or Professional without talking to sales: create a checkout session for the plan from your pricing page. See Self-Serve and Hosted Checkout.
5

Quote Enterprise deals

Start a quote from the Enterprise plan, negotiate volume discounts, multi-year terms and custom entitlements, and send it for e-signature. See Sales-Led.
6

Gate features on entitlements

Read GET /customers/{id}/entitlements in your application to turn features on and enforce seat quotas. See Entitlements.

​
Billing flow

​
Annual vs monthly

Offer the annual option as a separate plan (or a plan-level discount for fixed 12-month contracts) so the choice is visible in checkout and on quotes.

​
Mid-cycle changes

Seat additions and plan upgrades are the everyday changes in SaaS. Apply them with POST /subscriptions/{id}/changes: effective: "immediate" prorates the advance charge for the rest of the cycle; next_billing_period waits for the boundary. See Amendments and Proration.

​
Key features

Plans

Starter, Professional, Enterprise.

Entitlements

Feature flags and seat quotas per plan.

Quotes

Enterprise deals from the same catalog.

Customer Portal

Self-service invoices and payment methods.

​
API reference

Create a subscription

From a plan, with optional per-customer overrides.

List plans

Drive your pricing page from the catalog.

Create a customer

Create accounts with your own IDs as aliases.

Ingest billable events

Send usage for metered products.

Self-Serve (PLG)

Card checkout and in-app upgrades.

Sales-Led

Quotes and enterprise contracts.

Hybrid Motion

Both motions on one catalog.

← Back to Quick Starts

See all quick start guides