Usage-based contingency pricing for product variants

You can give members a discounted price on a product and limit how often they get it, for example two discounted coffees per day. Once the limit is reached, the regular price applies automatically. This is enforced at the Finion Pay vending terminal at the moment the member is charged.

Contents

• Prerequisites
• How usage limits work
• Set a usage limit on a product variant
• Set a shared limit across all variants of a product
• Example
• Good to know

Prerequisites

• The feature [TBD: UI name of the "Usage contingency" feature] must be enabled for your tenant. [verified: feature flag USAGE_CONTINGENCY must be on; setting a limit without it is rejected]
• Your user role needs Settings / Product management permission (edit). [verified: SETTINGS_PRODUCT]
• The cash register / Finion Pay vending module must be active, because the limit is checked when the terminal requests the price.
• A product variant with a special price assigned to a rate code or a member tag. The usage limit is added on top of that special price.

How usage limits work

Special prices already let you give certain members a discounted price per product variant, based on rate codes or member tags. A usage limit adds a time window to that discount:

• Variant limit: how often this specific variant can be bought at the discounted price (for example 2 per day).
• Product limit (optional): a shared cap across all variants of the same product (for example 5 discounted coffees per day in total, regardless of variant).

The discounted price applies only while both the variant limit and the product limit still have room. When either is exhausted, the variant's regular default price applies automatically. Usage is counted from finalized sales in the current period (day, week, or month) in the studio time zone. Reversed or voided sales free the quota again.

Set a usage limit on a product variant

1. Go to Settings / Product management / Products (DE: Einstellungen / Produktverwaltung / Produkte) and open the product.
2. On the variant, open the three-dot menu and choose Add price (DE: Preis hinzufügen), or open the existing special price. Set Type (DE: Typ) to Member code or Rate code (DE: Mitgliedscode / Tarif-Code) and the Price (DE: Preis).
3. Switch on [TBD: "Limit usage"].
4. Enter the [TBD: max usages] and choose the [TBD: period] (per day / per week / per month).
5. Click Save (DE: Speichern). The special-price list shows a badge such as 2 / day. [TBD: confirm badge wording]

[Screenshots captured (current dialog, no usage-limit field yet): EN FB_product_config_en.png + FB_special_price_dialog_en.png, DE FB_product_config.png + FB_special_price_dialog.png. RE-CAPTURE once the FE toggle is live.]

Set a shared limit across all variants of a product

1. On the product configuration page, open the [TBD: product contingent / shared limit] section.
2. Enable it and set the max usages and period.
3. Save. This limit is shared: usage on any variant of the product counts against the same pool.

[Screenshot: product configuration page with the shared-limit section — CAPTURE WHEN FE IS LIVE]

Example

Good to know

• The limit is checked the moment the terminal requests the price; the quota is only consumed once the purchase is finalized, so abandoned purchases do not burn the quota.
• Special prices without a usage limit keep working exactly as before.
• Period windows reset at the start of the day, week, or month in the studio time zone.