Add-ons: extra products on top of plans - ArcenPay

Add-ons are extra products you sell alongside your subscription plans. They can be one-time purchases (like a setup fee) or recurring items (like extra seats). Add-ons are configured in the dashboard Catalog and resolved as part of a company’s entitlement state at runtime.

What an add-on contains

Field	Description
Name & code	Customer-facing name and unique slug (e.g., `priority-support`)
Billing type	`ONE_TIME` (charged once) or `RECURRING` (billed each cycle)
Sale mode	`STANDALONE` (sold independently), `UPSELL` (only for existing subscribers), or `BOTH`
Price	The amount charged
Entitlements	Features or flags unlocked when this add-on is active

How add-ons work

Add-ons are attached to companies in the dashboard or via API. Once attached, the add-on’s entitlements are merged into the company’s resolved access state alongside the base plan’s entitlements.

const company = await client.getCompany("cm_abc123");
// company.entitlements includes entitlements from both the base plan and active add-ons

Common use cases

Scenario	Billing type	Sale mode
Setup or onboarding fee	One-time	Standalone
Extra API call packs	One-time	Standalone
Extra team seats	Recurring	Upsell
Priority support tier	Recurring	Both

Plans — base plans that add-ons extend
Credits — prepaid usage packs vs. add-on products
Entitlements — how add-on entitlements merge with plan entitlements

Last modified on May 15, 2026