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

# Checkout Coupons

> Create discount codes, bulk-generate coupons, and control when they apply.

> [!WARNING]
>
> 9Pic Checkout is a **Business plan** feature. Coupons only work once checkout is live with at least one published package.

## Overview

The **Coupons** tab lets you create discount codes buyers enter at checkout. Search existing codes, activate or deactivate them in bulk, and export codes to CSV.

> [!NOTE]
>
> If no package is published yet, a notice reminds you that coupons take effect only after buyers can check out.

## Create a coupon

Click **New coupon** and choose:

| Option | Use when |
| - | - |
| **Single coupon** | You want one specific code with custom settings |
| **Bulk create** | You need many unique codes at once (for example, a promo batch) |

### Single coupon fields

The coupon builder groups settings into sections:

**Discount basics**

| Field | Options |
| - | - |
| **Code** | The text buyers type at checkout |
| **Discount type** | **Percentage off** or **Flat amount off** |
| **Value** | Percentage or fixed amount in a currency used by your packages |

**Redemption limits**

| Field | Purpose |
| - | - |
| **Once per buyer** | Each buyer can use the code only once |
| **Max redemptions** | Total times the code can be used across all buyers |

**Targeting**

| Field | Options |
| - | - |
| **Sale phase** | **Any time**, **Pre-event only**, or **Post-event only** |
| **Active** | Whether the code is live immediately |

**Advanced (optional)**

| Field | Purpose |
| - | - |
| **Package restriction** | Limit the code to one specific package |
| **Validity window** | Start and end dates |
| **Minimum order amount** | Order must meet this threshold before the discount applies |
| **Note** | Internal label for your team |

### Bulk create

Bulk creation generates many unique codes with shared settings (discount type, sale phase, limits, etc.). After creation, use **Download CSV** to retrieve the generated codes.

## Manage coupons

### Search and filter

* **Search** — match by code or internal note
* **State filter** — All, Active, Inactive, or Archived

### Coupon states

| State | Meaning |
| - | - |
| **Active** | Buyers can redeem the code |
| **Inactive** | Code exists but cannot be used |
| **Archived** | Retired; removed from active management |

### Bulk actions

Select coupons with the row checkboxes, then stage **Activate** or **Deactivate** for the selection. Click **Save changes** to apply staged status updates. The page blocks navigation while unsaved coupon status changes are pending.

Individual coupons can also be edited or archived from the row actions menu.

### Export

**Download CSV** exports the current filtered coupon list for spreadsheets or external distribution.

## Common Questions

> [accordion] Can a coupon apply to only one package?
>
> Yes. Use the optional package restriction in the coupon builder, or create a coupon directly from a package editor with the package pre-selected.

> [accordion] Which currencies can flat-amount coupons use?
>
> Flat discounts use currencies already present in your event's packages — not the full gateway currency list.

> [accordion] What is the difference between inactive and archived?
>
> Inactive codes can be reactivated quickly. Archived codes are retired from day-to-day use but kept for records.

## Next Steps

> [card] [Packages](https://docs.9pic.ai/products/checkout/packages.md)
>
> Publish packages before coupons can be redeemed.

> [card] [Checkout Configuration](https://docs.9pic.ai/products/checkout/configuration.md)
>
> Enable checkout when setup is complete.

> [card] [Transactions](https://docs.9pic.ai/products/checkout/transactions.md)
>
> Review completed orders after promotions run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.