> For the complete documentation index, see [llms.txt](https://docs.tracknow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracknow.io/payouts/coupons.md).

# Coupons

When you create coupon codes for your affiliates in your store, you can add those coupons to Tracknow and associate each one with the corresponding affiliate. The assigned coupons will be displayed in the affiliate's portal and used for commission attribution.

When a purchase event is sent from your store to Tracknow, our system can use the coupon code included in the event data to identify the affiliate responsible for the sale and attribute the commission accordingly.

{% hint style="info" %}
This allows affiliates to earn commissions from coupon-based referrals even when the customer did not click an affiliate tracking link before making the purchase.
{% endhint %}

***

### Coupon Types (Coupon Payout vs Coupon Code)

Tracknow supports two ways of associating coupon codes with affiliates:

<table><thead><tr><th width="187">Feature</th><th>Coupon Payout</th><th>Coupon Code</th></tr></thead><tbody><tr><td><strong>Purpose</strong></td><td>Apply a custom commission rate for coupon-driven sales</td><td>Attribute sales to affiliates using existing commission rules</td></tr><tr><td><strong>Commission Rate</strong></td><td>Custom rate defined on the coupon payout</td><td>Uses the commission rate from the existing payout</td></tr><tr><td><strong>Overrides Default Commission</strong></td><td>Yes</td><td>No</td></tr><tr><td><strong>Attribution Method</strong></td><td>Coupon code</td><td>Coupon code</td></tr><tr><td><strong>Typical Use Case</strong></td><td>Coupon sales should pay a different commission than link referrals</td><td>Coupon sales should pay the same commission as link referrals</td></tr></tbody></table>

#### Use a Coupon Payout When...

You want purchases made with a coupon code to generate a different commission than the default commission configured for the event.

> **Example**
>
> Your affiliate program pays affiliates **15% of the purchase amount** by default. However, you want purchases made using affiliate coupon codes to generate **10% commission**.
>
> In this case, create the coupon as a **Coupon Payout** and configure its commission rate to **10%**. When a purchase event containing that coupon code is received, Tracknow will trigger the coupon payout and award the affiliate 10% commission instead of the default 15%.

#### Use a Coupon Code When...

You want purchases made with a coupon code to generate the same commission that would be awarded through a standard affiliate referral link.

> **Example**
>
> Your affiliate program pays affiliates **15% of the purchase amount** regardless of whether the sale is attributed through an affiliate link or an affiliate coupon code.
>
> In this case, add the coupon as a **Coupon Code**. When a purchase event containing the coupon code is received, Tracknow will attribute the sale to the associated affiliate and trigger the existing **15% Sale payout**, resulting in the same commission that would have been awarded through a standard affiliate link referral.

***

### Creating a Coupon Payout

Navigate to **Affiliates** → **Coupons** → **Coupon Payouts** tab → **Add Coupon Payout**

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

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

<table><thead><tr><th width="250">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Campaigns</strong> (Required)</td><td>Select the campaign this coupon payout will be added to</td></tr><tr><td><strong>Title</strong> (Required)</td><td>Give the coupon payout a name</td></tr><tr><td><strong>Custom Payout Text</strong> (Optional)</td><td>Enter text to show the affiliate instead of this payout's commission rate</td></tr><tr><td><strong>Payout Type</strong> (Required)</td><td>Select whether it's a <strong>personal payout</strong> (a specific affiliate's code) or a <strong>general payout</strong> (general store coupon)</td></tr><tr><td><strong>Commission Type</strong> (Required)</td><td>Select the commission calculation method</td></tr><tr><td><strong>Payment Type</strong> (Required)</td><td>Select the event type and whether it's a <a href="https://docs.tracknow.io/payouts/lifetime-payout">lifetime type payout</a></td></tr><tr><td><strong>Affiliates</strong> (Required)</td><td>Select the affiliate that this coupon code is associated with</td></tr><tr><td><strong>Countries</strong> (Optional)</td><td>Only purchases by clients from the selected countries can trigger this coupon payout</td></tr><tr><td><strong>Disallowed Countries</strong> (Optional)</td><td>Only purchases by clients <strong>NOT</strong> from the selected countries can trigger this coupon payout</td></tr><tr><td><strong>Catalogs</strong> (Optional)</td><td>Add a <a href="https://docs.tracknow.io/campaigns/catalogs">catalog</a> for item-based commission calculation</td></tr><tr><td><strong>Affiliate Commission</strong> (Required)</td><td>Set the affiliate commission rate</td></tr><tr><td><strong>Max Commission</strong> (Optional)</td><td>Limit the commission amount if it's a percentage based commission rate</td></tr><tr><td><strong>Goal Value</strong> (Optional)</td><td>Read about goal-based payouts <a href="https://docs.tracknow.io/payouts/goal-based-payouts">here</a></td></tr><tr><td><strong>Coupon Code</strong> (Required)</td><td>Ener the coupon code</td></tr><tr><td><strong>Coupon Match Mode</strong> (Required)</td><td>Select how our system will compare the incoming coupon code against the coupon value set in this payout</td></tr><tr><td><strong>Default Conversion Status</strong> (Optional)</td><td>Select the default status for conversion where this payout was applied. When empty, defaults to the campaign setting</td></tr><tr><td><strong>Tier Type</strong> (Optional)</td><td>Add commission tiers to this payout</td></tr><tr><td><strong>New Customer</strong> (Optional)</td><td>Toggle on to trigger this payout only when the event postback contains <code>new_customer=true</code> (First purchases)</td></tr></tbody></table>

***

### Creating a Coupon Code

Navigate to **Affiliates** → **Coupons** → **Coupons** tab → **Add Coupon**

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

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

<table><thead><tr><th width="250">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Coupon Code</strong> (Required)</td><td>Ener the coupon code</td></tr><tr><td><strong>Coupon Match Mode</strong> (Required)</td><td>Select how our system will compare the incoming coupon code against the coupon value set in this payout</td></tr><tr><td><strong>Discount Text</strong> (Required)</td><td>Enter text to show the affiliate the client discount amount (e.g <code>15% OFF</code>)</td></tr><tr><td><strong>Campaign</strong> (Required)</td><td>Select the campaign this coupon will be added to</td></tr><tr><td><strong>Affiliates</strong> (Required)</td><td>Select the affiliate that this coupon code is associated with</td></tr></tbody></table>

***

### Where Affiliates See Their Coupon Codes

#### Main Dashboard

On the affiliate's **Dashboard** screen, there's a **coupon icon** in the **Tracking URL card**

<figure><img src="/files/6tXoG7jxIrIXLtNVPxXL" alt=""><figcaption></figcaption></figure>

> The coupon codes that will appear are determined by the selected campaign

#### Campaign Page

Affiliates can view the coupon codes associated with each of their campaigns on every campaign page.

**Campaigns** → Click on the relevant campaign name → The coupons will appear on that campaign's page

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tracknow.io/payouts/coupons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.