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

# Coupons

> Create discount codes tenants can use when they pay.

Coupons are discount codes that tenants can enter at checkout. Manage them from **Setup → Coupons**.

<Info>
  A coupon applies to a **particular payment only**. The tenant's next renewal is charged at the normal price.
</Info>

## Create a coupon

Click **Add Coupon** to create a new coupon.

<Frame caption="The coupon form, with the code and discount, eligibility rules, and schedule and limits">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/coupon-form.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=b743ea4b97cf2be3ced932d76f999f2e" alt="The coupon form, with the code and discount, eligibility rules, and schedule and limits" width="1625" height="776" data-path="images/pa/coupon-form.png" />
</Frame>

### Coupon details

| Field           | Description                                                                     |
| --------------- | ------------------------------------------------------------------------------- |
| **Code**        | Code the tenant enters at checkout. Click **Generate** to create a random code. |
| **Type**        | Choose **Percentage** or **Fixed amount**.                                      |
| **Description** | Internal note about the coupon. Tenants cannot see it.                          |

<Tip>
  Coupon codes are stored in uppercase, so `save20` and `SAVE20` are treated as the same code.
</Tip>

### Discount

The fields depend on the selected **Type**.

<Tabs>
  <Tab title="Percentage">
    | Field                   | Description                       |
    | ----------------------- | --------------------------------- |
    | **Discount Percentage** | Discount from 1% to 100%.         |
    | **Max discount**        | Optional maximum discount amount. |
  </Tab>

  <Tab title="Fixed amount">
    | Field               | Description                                       |
    | ------------------- | ------------------------------------------------- |
    | **Discount amount** | Fixed discount amount in the platform's currency. |
  </Tab>
</Tabs>

<Note>
  Coupon amounts use the platform's base currency configured under [Currency setup](/pa/currency-setup).
</Note>

### Usage and validity

| Field                  | Description                                                                 |
| ---------------------- | --------------------------------------------------------------------------- |
| **Applicable plans**   | Restrict the coupon to selected plans. Leave empty for all plans.           |
| **Billing cycles**     | Restrict the coupon to selected billing cycles. Leave empty for all cycles. |
| **Min order**          | Minimum order amount required to use the coupon.                            |
| **First payment only** | Allow the coupon only for tenants making their first payment.               |
| **Valid from**         | Date when the coupon becomes active.                                        |
| **Expires at**         | Date when the coupon expires.                                               |
| **Global usage limit** | Maximum number of times the coupon can be used by all tenants.              |
| **Per-tenant limit**   | Maximum number of times one tenant can use the coupon.                      |

Leaving a limit empty means there is no limit.

<Tip>
  Enable **First payment only** if the coupon is intended for new tenants.
</Tip>

## Manage coupons

<Frame caption="The Coupons list, with each code's type, value, usage, expiry, and status switch">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/coupons-list.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=74ce6006635fa24d0ff6671f595e5d60" alt="The Coupons list, with each code's type, value, usage, expiry, and status switch" width="1633" height="619" data-path="images/pa/coupons-list.png" />
</Frame>

The coupon list shows the **Code**, **Type**, **Value**, **Used**, **Expires**, and **Status** of each coupon. You can filter coupons by **Status**, **Type**, and **Expired**.

The **Status** switch allows you to disable a coupon without deleting it.

| Action     | What it does                                             |
| ---------- | -------------------------------------------------------- |
| **Edit**   | Change the coupon details.                               |
| **Usage**  | View the tenant, discount, status, and date of each use. |
| **Delete** | Delete the coupon.                                       |

<Warning>
  Deleting a coupon does not remove discounts from existing invoices. To stop a coupon from being used, disable its **Status** instead.
</Warning>

## How tenants use coupons

Tenants enter the coupon code at checkout when they:

* Activate a subscription
* Renew a subscription
* Upgrade a subscription

Coupons can be used with both online payments and bank transfers. The discount is applied before tax is calculated.