> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupons

> Create reusable discounts and apply them to subscriptions, invoices, and checkout flows

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](./promotion-codes) 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.

<Note>
  To offer free or discounted prepaid credits instead of a subscription discount, use [credits](../credits/overview) or [wallet top-ups](../wallets/balance).
</Note>

## Coupon configuration

Each coupon contains three types of settings:

| Setting         | Description                                                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Information** | Name and internal description. The name can appear on customer-facing documents, while the description is for internal context.                  |
| **Discount**    | Fixed amount or percentage discount. Fixed amount coupons use one currency. Percentage coupons apply a percentage discount to eligible products. |
| **Settings**    | Optional redemption deadline, redemption limit, and eligible products. These settings control where and how often the coupon can be used.        |

<Warning>
  The discount type and value cannot be edited after the coupon is created. Create a new coupon when the commercial discount changes.
</Warning>

## 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:

| Duration                  | Behavior                                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Once**                  | Applies to a single invoice. Once that invoice is finalized, the coupon expires for the subscription.              |
| **Relative duration**     | Applies for a specific period, such as 3 months or 6 months, from the subscription phase start or transition date. |
| **Phase duration**        | Applies for the full duration of the current subscription phase.                                                   |
| **Subscription duration** | Applies 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.

<Tip>
  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.
</Tip>

Learn how to configure customer-facing codes in [Promotion codes](./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

* Create customer-facing codes with [Promotion codes](./promotion-codes).
* Apply coupons while [assigning a subscription](../subscriptions/create).
* Manage coupons during a [subscription update](../subscriptions/update).