Offerings

Offerings are the customer-facing packaging layer. They wrap one or more rate plans into a subscribable plan with a name, description, billing mode, trial configuration, and storefront display options.

Think of an offering as the product listing a customer sees — "Starter Plan — $49/month + usage" — while the underlying rate plans define exactly how usage is priced.

Billing Modes

Mode	Description	Best For
`POSTPAID`	Charge at end of billing period based on actual usage	API products, metered services
`PREPAID`	Customer buys credits upfront; usage draws down the wallet	AI tokens, compute credits
`HYBRID`	Base fee charged upfront, overages charged postpaid	SaaS + API combos

Prepaid / Wallet

In PREPAID mode, customers fund a wallet before using your service. Usage events debit the wallet in real time. When the wallet reaches zero:

BLOCK — Requests are rejected until the wallet is refunded
ALERT — Usage continues; operator is notified to collect

Configure the low-balance threshold and behavior in the offering's escrowConfig.

Trial Periods

Set trialDays to offer a free trial before billing starts:

{
  "name": "Starter — 14-day free trial",
  "trialDays": 14,
  "billingMode": "POSTPAID"
}

When a subscription is created, it enters TRIALING status. After trialDays elapses, Aforo automatically converts to ACTIVE and begins charging.

ℹ

If a customer migrates to a different plan while still in a trial, the trial period carries over to the new plan — the customer doesn't lose unused trial days.

FX Strategy

For multi-currency offerings, configure how Aforo handles currency conversion:

LOCK_AT_SUBSCRIPTION — Exchange rate is locked when the subscription is created
LIVE_RATE — Exchange rate is calculated at invoice time

Creating an Offering

Go to Pricing Studio → Offerings
Click + New Offering
Select one or more rate plans (Step 1)
Configure billing mode, trial, escrow settings (Step 2)
Review and publish (Step 3)

Modification Guard

Aforo protects active offerings from destructive changes. If customers are actively subscribed, these changes are blocked:

Removing a rate plan item
Changing the billing currency
Changing the billing type

Safe changes (name, description, adding items) are always allowed.

Check modification impact before editing:

Storefront Display

Each offering has a published flag controlling storefront visibility. Only published offerings appear in your customer-facing pricing page. You can have multiple offerings in different stages of development without customers seeing them.