Pricing and subscriptions

This guide contains both end-user and administrator flows.

1. PricingAdmin overview (administrator)

Use PricingAdmin to maintain the pricing model that is shown on the public Pricing page and synchronized to Stripe.

Main tabs include:

Defaults
Features
Tiers
Currencies
Regions
Discount codes
Affiliates (older data/model labels may still use Reseller internally)

In edit screens, you can use Close and Delete actions directly from the form toolbar.

2. Defaults tab

Use Defaults to set the global default currency.

Open PricingAdmin -> Defaults.
Select the default currency.
Save.

This currency is used as the baseline fallback when more specific currency/region overrides are not available.

3. Features tab

Use the Features tab to define billable capabilities and their pricing behavior.

3.1 Organize features

Drag and drop feature rows to reorder them.
Drop onto a row to make a feature a child of that row.
When detail is open, the list keeps focus on the selected row and hides non-essential columns.

3.2 Configure feature metadata

In feature details, configure:

Name and key
Add-on flag
Value and data type
Quota-exceeded description

Use Add-on for purchasable extras that can be bought outside base tier limits.

3.3 Configure feature prices

For yearly values:

Enter per-month yearly values (not full-year totals).
Use the % toggle when the yearly value is a discount percentage.
Tooltip updates as you type and shows the computed yearly total.

In currency and region sub-tables you can define per-row overrides and set active/tax flags.

4. Tiers tab

Use tiers to define subscription plans and included features.

Reorder tiers by drag-and-drop.
Set monthly and yearly pricing.
Mark tiers as organization tiers where required.
Add long description text for the public pricing page.

For included features, you can set tier-specific values where the feature supports a typed value.

5. Currencies and regions tabs

5.1 Currencies

Currencies are listed by code.
Open a row directly to edit it.
Save active/default behavior for pricing calculations.

5.2 Regions

Create regions from known region entries.
Region selection can auto-fill region metadata.
Assign a default currency per region.

Region-level overrides apply when a matching user region is detected.

6. Discount codes and resellers (administrator)

6.1 Discount codes

Use the Discount codes tab to:

Create and manage codes.
Generate unique 10-character codes.
Control validity, limits, and applicability.
Restrict by target entity when needed.
Show active codes by default, with optional inactive visibility.
Open linked affiliate details directly from the code list.

6.2 Affiliates (resellers)

Use Affiliates to:

Manage affiliate profiles.
Manage affiliate-linked codes.
Review ledger and payout-related information.
Filter by requested payouts and open payout detail workflows.

Note: database and some legacy labels can still use the term reseller while the UI uses affiliate wording.

6.3 Affiliate self-service page

Eligible affiliates can access their own page from the user menu.

Typical tabs include:

Details: nickname, earnings summary, paid vs remaining balance.
Discount codes: active codes and optional inactive visibility.
Your ledger: recent earning/payout records.

This page also supports payout-request flows and account details updates.

7. Pricing page behavior (end users)

7.1 Tier cards and yearly display

Pricing defaults to yearly mode.
Card headline displays the per-month yearly amount.
The line below shows full yearly total and savings percent.
Save up to X% is calculated from the best available yearly discount.
If a tier has extra long-form notes, Aisman can show a More about the tiers section below the cards.
Your current subscription is highlighted, and exhausted free-trial quota can switch that highlight to a warning style.

7.2 Current subscription highlighting

Your current tier is highlighted.
If relevant quota limits are exceeded, affected values are emphasized and guidance is shown.

7.3 Add-ons

If add-ons are available for your context:

Add-ons are listed with quantity controls.
The add-on list follows the tier or subscription you are currently viewing.
Add-ons can use monthly, yearly, or one-off pricing.
Total updates live as quantities change.
Purchase action appears when total is greater than zero.

7.4 Entity selection

If you manage organizations, the pricing page can include an Entity selector:

My personal account
Organizations where you have admin access
Option to add a new organization

Selected entity controls subscription targeting and highlighted current subscription.

7.5 Promotions and referrer flows

If active promotions are available:

A Promotions section is shown.
Promotions can be expanded and reviewed before checkout.
Discount codes can be applied during checkout (one active code at a time).
Referrer-based offers can expand the promotions list when a valid referrer is provided.
Checkout summary labels include clear period suffixes where relevant (for example subscription period context on line items).

When a referrer code is provided, matching promotions/referrer code behavior is applied automatically where eligible.

8. Checkout outcomes

During checkout, Aisman validates discount and eligibility conditions and gives explicit messages for cases such as:

Code not found
Code expired
Usage quota reached
Code not applicable to selected purchase items
Code not allowed for current user or selected organization

To protect checkout, repeated invalid-code attempts can be rate-limited within a short time window.

If a code is valid, totals are recalculated immediately.

Additional checkout behavior:

Add-on purchases go through the same checkout page flow, including discount-code entry and validation.
Subscription subscribe/upgrade flow keeps the selected tier and context reliably through checkout.
When an organization entity is selected, non-organization subscription tiers are disabled.
After successful checkout (including 100% discount/coupon flows), the pricing view refreshes immediately so updated subscription/quota state is visible without manual page reload.