Skip to main content
Coupons define the discount that can be applied to a customer. In Hyperline, a coupon can reduce a charge by a fixed amount or by a percentage, and can be reused across subscriptions when the same commercial offer applies to several customers. A coupon is the discount rule. A promotion code is a customer-facing code that lets customers redeem that coupon on a checkout page.

When to use coupons

Use coupons when you need to apply a recurring or one-time discount to a subscription, quote, or invoice. Common examples include onboarding discounts, partner discounts, contract-specific concessions, and limited-time commercial offers. Coupons are managed from the catalog so they can be created once, tracked centrally, and applied consistently by your team.
To offer free or discounted prepaid credits instead of a subscription discount, use credits or wallet top-ups.

Coupon configuration

Each coupon contains three types of settings:
SettingDescription
InformationName and internal description. The name can appear on customer-facing documents, while the description is for internal context.
DiscountFixed amount or percentage discount. Fixed amount coupons use one currency. Percentage coupons apply a percentage discount to eligible products.
SettingsOptional redemption deadline, redemption limit, and eligible products. These settings control where and how often the coupon can be used.
The discount type and value cannot be edited after the coupon is created. Create a new coupon when the commercial discount changes.

Create a coupon

  1. Go to Catalog > Coupons.
  2. Click New coupon.
  3. Enter the coupon Name and, if needed, an Internal description.
  4. Choose the discount type:
    • Fixed amount: select the currency and discount amount.
    • Percentage: enter the percentage discount.
  5. Configure optional settings:
    • Redemption deadline: date after which the coupon can no longer be redeemed.
    • Redemption limit: maximum number of times the coupon can be redeemed.
    • Eligible products: products the coupon can apply to. Leave empty to allow all products.
  6. Click Create new coupon.
The coupon appears in the Coupons list after creation.

Apply coupons

Coupons can be applied when creating or updating subscriptions, preparing quotes, and editing invoices before they are finalized. When applying a coupon, Hyperline asks how long the discount should apply and which eligible products should receive the discount. Product eligibility comes from the coupon settings, then can be narrowed down for the specific subscription, quote, or invoice.

Coupon duration

When applying a coupon to a subscription, choose how long it should apply:
DurationBehavior
OnceApplies to a single invoice. Once that invoice is finalized, the coupon expires for the subscription.
Relative durationApplies for a specific period, such as 3 months or 6 months, from the subscription phase start or transition date.
Phase durationApplies for the full duration of the current subscription phase.
Subscription durationApplies for the lifetime of the subscription.

Promotion codes

Promotion codes are created from a coupon. They let customers enter a code on a checkout page and redeem the coupon themselves. Use promotion codes when you want a self-serve checkout experience, public campaign code, partner code, or customer-specific code. Use coupons directly when your team should apply the discount internally during subscription, quote, or invoice setup.
A single coupon can have multiple promotion codes. For example, a 20% annual discount coupon can power SPRING20, PARTNER20, and customer-specific codes with different limits.
Learn how to configure customer-facing codes in Promotion codes.

Manage coupons

Open a coupon to review its configuration, see its promotion codes, or delete it. Deleting a coupon archives it and prevents future use. It does not remove the coupon from active subscriptions where it has already been applied.

Next steps