> For the complete documentation index, see [llms.txt](https://docs.chatalog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatalog.ai/e-commerce/coupon.md).

# Coupon

The Coupon feature allows you to create and distribute redeemable coupons directly through your chatbot flows. You can manage coupons from the E-commerce page and automatically send them to customers using the new **Distribute Coupon** flow block.

{% hint style="info" %}
This is an add-on feature. Please contact your account manager if you would like to enable it for your organization. 
{% endhint %}

## Overview

With the Coupon feature, you can:

* Create and manage coupon campaigns
* Set coupon validity periods and redemption limits
* Customize the coupon redeem page
* Distribute coupons automatically through chatbot flows
* Track coupon redemption records

***

## Accessing the Coupon Feature

Go to: **E-commerce → Coupons**

From this page, you can:

* Create new coupons
* View existing coupons
* Check redemption records
* Configure the redeem page

<figure><img src="/files/3hnnEyfF78k5eP7v2W93" alt=""><figcaption></figcaption></figure>

***

## Create a Coupon

Click **Create Coupon** to add a new coupon.

<figure><img src="/files/kj9rldhkIPdeKUgNdIoo" alt="" width="375"><figcaption></figcaption></figure>

### Required Fields

| Field         | Description                                                                                                                            |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Code          | The coupon code customers will redeem. You can either let the system automatically generate the code or create a custom code manually. |
| Name          | Coupon name                                                                                                                            |
| Active Period | Coupon validity period                                                                                                                 |

### Optional Fields

| Field                         | Description                           |
| ----------------------------- | ------------------------------------- |
| Overall Redemption Limit      | Maximum total redemptions allowed     |
| Per-customer Redemption Limit | Maximum redemption count per customer |
| Active                        | Enable or disable the coupon          |

### Notes

* Coupons outside the active period cannot be redeemed.
* Disabled coupons cannot be distributed or redeemed.
* Redemption limits are checked automatically during redemption.

***

## Configure the Redeem Page

Each coupon can have a customizable redeem page shown to customers. You can click **View** on the list after creating a new one.

<figure><img src="/files/E4EMPrbxePNmUxyZFphk" alt=""><figcaption></figcaption></figure>

### Available Configurations

<figure><img src="/files/gigXBLAmbluLHp5jiiRr" alt=""><figcaption></figcaption></figure>

| Setting                                     | Description                                                    |
| ------------------------------------------- | -------------------------------------------------------------- |
| Code on Page                                | Select how the coupon code is displayed                        |
| Redeem Button                               | Configure redeem button behavior                               |
| Button Label (When you set a redeem button) | Customize button text                                          |
| Copy Code Button                            | Enable a copy coupon code button                               |
| Page Background                             | Customize background color                                     |
| Brand Icon                                  | Upload your brand logo                                         |
| Campaign Image                              | Upload campaign banner/image                                   |
| Terms and Conditions                        | Add the coupon usage rules, restrictions, and redemption terms |

### Redeem Page Preview

A mobile preview is available on the right side to help you review the customer experience before saving.

Click **Save Redeem Page** after configuration.

***

## Distribute Coupons in Flow Builder

You can automatically send coupons to customers using the new **Distribute Coupon** flow block.

### How to Use

1. Open **Flow Builder**
2. Add the **Distribute Coupon** block
3. Select a coupon
4. Configure the message content, button title, image URL, and fallback flows.
5. Connect with other flow blocks as needed
6. Save and publish the flow

<figure><img src="/files/Dw1rGW8rgZqhpSAj2jAM" alt="" width="312"><figcaption></figcaption></figure>

### Configurable Content

| Field            | Description                                 |
| ---------------- | ------------------------------------------- |
| Coupon Selection | Choose which coupon to distribute           |
| Message Content  | Text message shown before coupon redemption |
| Button Title     | Customize redeem button text                |
| Image URL        | Upload an image/banner                      |

***

## Flow Outcomes

The **Distribute Coupon** block supports different routing outcomes based on redemption results.

### Available Outcomes

| Outcome                   | Description                                                |
| ------------------------- | ---------------------------------------------------------- |
| Coupon Expired            | Triggered when the coupon validity period has ended        |
| Customer Max Uses Reached | Triggered when the customer exceeds their redemption limit |
| Coupon Max Uses Reached   | Triggered when the coupon reaches total redemption limit   |
| Error                     | Triggered when redemption fails unexpectedly               |

These outcomes can be connected to different follow-up flow blocks.

***

## View Redemption Records

You can monitor coupon usage from the redemption records page.

<figure><img src="/files/fhJSb9GtVIX3v69Y5X0k" alt=""><figcaption></figcaption></figure>

### Available Information

<figure><img src="/files/0cKpJDoPirS0uNmgfuTE" alt=""><figcaption></figcaption></figure>

| Field         | Description                 |
| ------------- | --------------------------- |
| Redemption ID | Unique redemption record ID |
| Customer ID   | Customer identifier         |
| Inbox ID      | Inbox/channel identifier    |
| Status        | Redemption status           |
| Redeemed At   | Redemption timestamp        |