Skip to main content
A Promotional Offer is an Offer applied directly with offerId. Promotional describes the application channel, not a different catalog resource or purpose. The Offer stays independent from plans and prices until your integration selects it.

​
Create the terms

Direct Offers may combine a free trial with ordered discount or fixed-price phases:
Currency-specific phases require an explicit value for the checkout currency. Commet does not reuse a USD amount silently in another currency.

​
Apply it directly

The Offer must be active, inside its availability window, and resolvable in the selected currency. It does not need a prior association with the plan or price. An explicit offerId overrides automatic introductory selection. It cannot be combined with promoCode, customTrialDays, or skipTrial: true. Immediate plan changes, plan-change previews, and supported reactivation flows also accept offerId. Scheduled plan changes do not accept an Offer.

​
Apply it to an active subscription

For retention, apply an Offer to a subscription that is already active. The discount phases start at the next billing cycle, so the current period stays untouched and the next invoice carries the discount:
Only one Offer applies at a time: while an accepted Offer still has active or upcoming discount phases, a new application is rejected. Once its phases are exhausted, the subscription accepts a new Offer. Offers with a free trial phase cannot be applied to an active subscription, and the discount applies to the plan base price only. The applied Offer belongs to that subscription and plan: it ends with a cancellation and a plan change removes it. The same operation on a subscription with a pending payment checkout quotes or replaces the checkout discount instead; there it accepts an optional expiresAt for the quote.

​
Direct application or Promo Code?

Use direct offerId when your application decides who receives the terms. Use a Promo Code when the customer should enter a code and the campaign needs redemption restrictions. A Promo Code can distribute multiple discount phases, including fixed_price, and can begin with a trial when a discount follows it. A trial-only Offer remains available for direct application.