> 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="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FFt24zS115l4RSa6VBQjK%2Fimage.png?alt=media&amp;token=742e8b91-3f7d-4f9a-8feb-4406ec3ff35a" alt=""><figcaption></figcaption></figure>

***

## Create a Coupon

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

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2Fnnckuq11ZBZUc8TqyUgf%2Fimage.png?alt=media&amp;token=c87fa973-b855-4072-8cd3-ba60edbff296" 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="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FmzNXhDWjQIc7QhKr1SPn%2Fimage.png?alt=media&amp;token=2d968d05-9b3e-427d-91cc-f4c541682582" alt=""><figcaption></figcaption></figure>

### Available Configurations

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FG1x0Z8ZNGBZqg1x0U1wL%2Fimage.png?alt=media&amp;token=36eab7cb-f180-4d7d-92ae-f5d2370abd7e" 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="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FWyOzkykbdMtUiqnvYPdJ%2Fimage.png?alt=media&amp;token=71bca281-d757-4864-9d3b-a7d50f8b4eb1" 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="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2Fh9SrFU3pSWL77ymIAFuD%2Fimage.png?alt=media&amp;token=17d49561-4218-439a-83ec-84cc03dc5b29" alt=""><figcaption></figcaption></figure>

### Available Information

<figure><img src="https://605198658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP7nf2G1iCRba8EP7DawZ%2Fuploads%2FbxsNINL8JAHwUZkibwQ8%2Fimage.png?alt=media&amp;token=9cc0e433-c01b-4679-8b27-3194e733f7ca" 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        |