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

# Coupon

> Create and manage discounts for bills, subscriptions, and customer accounts.

Coupons in Clink allow you to offer discounts to your customers. These can be applied to individual bills, specific subscriptions, or an entire customer account.

<Tip>
  **Key Concept:** It is helpful to understand the two-layer structure:

  * **The Coupon (The Rule):** Defines *what* the discount is (e.g., "\$2.50 off") and its validity.
  * **The Promotion Code (The Key):** The specific string (e.g., `SUMMER2025`) a customer enters. A single Coupon can have multiple Promotion Codes.
</Tip>

## Creating a Coupon

To set up a new discount rule, follow these steps:

<Steps>
  <Step title="Navigate to Coupons">
    Go to **Products > Coupon** in the sidebar and click the **Add** button.
  </Step>

  <Step title="Configure Basic Info">
    Fill in the primary details for the discount rule.

    | Field                     | Description                                                                         |
    | :------------------------ | :---------------------------------------------------------------------------------- |
    | **Name**                  | Internal name (e.g., "Black Friday"). This appears on customer receipts.            |
    | **Type**                  | Choose **Percentage off** (%) or **Fixed amount off** (\$).                         |
    | **Applied to**            | Select scope: **None** (Total invoice), **Product** (Specific items), or **Price**. |
    | **Subscription Duration** | **Once** (First invoice only) or **Repeating** (All future invoices).               |
  </Step>

  <Step title="Set Usage Limits">
    At the bottom of the form, configure high-level restrictions:

    * **Exchange deadline:** The date range during which the coupon is valid.
    * **Limit total redemptions:** The total number of times this coupon can be used globally.
    * **Minimum amount requirement:** Specifies the minimum transaction amount required to redeem this coupon.
  </Step>

  <Step title="Save">
    Click **Add** to create the Coupon.
  </Step>
</Steps>

***

## Managing Promotion Codes

Once a Coupon is created, you must generate codes so customers can redeem it.

1. Click on the **Name** of the coupon you just created in the list.
2. Scroll down to the **Promotion code** section.
3. Click the small <Icon icon="plus" /> button on the right side.

### Code Configuration

When adding a promotional code, you can customize specific constraints:

<CardGroup cols={2}>
  <Card title="Code String" icon="case-upper">
    Enter a custom code (e.g., `WELCOME10`) or leave blank to auto-generate a random string.
  </Card>

  <Card title="Customer Limit" icon="user">
    Check **Limited to specific customers** to restrict redemption to specific Customer IDs.
  </Card>

  <Card title="Usage Limit" icon="infinity">
    Set how many times *this specific code* can be redeemed (distinct from the global coupon limit).
  </Card>

  <Card title="Expiration" icon="calendar-x">
    Set an **Expires on** date specific to this code.
  </Card>
</CardGroup>

***

## Monitoring & Management

### The Coupon List

Navigate to **Products > Coupon** for an overview. You can filter by discount type or duration.

* **Terms:** Shows the rule (e.g., "\$2.5 off once").
* **Exchange:** Shows the current redemption count.

### Coupon Details

Clicking into a specific Coupon provides a detailed dashboard.

<Note>
  **Disabling Codes:** If a code is compromised, you can click the **Disable** button next to the specific code in the "Promotion code" table. This invalidates the code without deleting the parent Coupon.
</Note>

### Editing & Deleting

* **Rename:** You can rename a coupon at any time via the **Rename Coupon** button.
* **Delete:** Clicking **Delete coupon** will remove the discount rule.
  <Warning>Deleting a coupon will permanently disable all associated promotion codes immediately.</Warning>