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

# What Is Third-Party Coupons Through the Gameball Dashboard?

> Learn how to upload, organize, and manage third-party coupon codes directly from your Gameball dashboard for seamless distribution.

## Plan Availability

| Platform | Plan                                                         |
| -------- | ------------------------------------------------------------ |
| All      | Upon Request ([Contact Support](mailto:support@gameball.co)) |

Gameball allows you to upload and manage third-party coupon codes efficiently through the dashboard. This feature helps you deliver coupon codes to customers automatically and track their redemption without manual work.

***

## Prerequisites

<Info>
  Ensure you have the necessary permission levels to access this feature. Only users with the roles of **Workspace Owner**, **Admin**, or **Merchant/Branch Manager** can manage third-party coupons.
</Info>

***

## Step-by-Step Instructions

<Steps>
  <Step title="Create a New Coupon Group">
    Go to your Gameball dashboard and click **Settings**, then navigate to the **Admin Settings** section.

    <Frame>
      <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/third-party-admin-settings.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=40c7969c55b6394bd87d1d5af775b3c2" alt="Admin Settings" width="2504" height="1412" data-path="images/product-docs/admin-settings/third-party-admin-settings.png" />
    </Frame>

    Under the **Coupons** section, click on **3rd Party Coupons**.

    <Frame>
      <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/third-party-coupons-menu.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=7beeb77b2c442adb8f8e2c0bbecf1b83" alt="Third Party Coupons" width="2050" height="996" data-path="images/product-docs/admin-settings/third-party-coupons-menu.png" />
    </Frame>

    To add a new coupon group, click **Add New Group**.

    <Frame>
      <img src="https://mintcdn.com/gameball/_0P_nX_CDM4maIwW/images/product-docs/admin-settings/add-new-group.png?fit=max&auto=format&n=_0P_nX_CDM4maIwW&q=85&s=0ce31cf14b97d07def59fa3a9fa9d818" alt="Add New Group" width="2256" height="1324" data-path="images/product-docs/admin-settings/add-new-group.png" />
    </Frame>

    Enter the following details and then click **Save**:

    * **Name**
    * **Group URL**
    * **Title**
    * **Description**
    * Upload Image under **Group Icon**

    <Frame>
      <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/group-details.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=ae851392bfca0c631bcf09f8e07d5ffc" alt="Group Details" width="2170" height="1202" data-path="images/product-docs/admin-settings/group-details.png" />
    </Frame>
  </Step>

  <Step title="Upload a CSV File of Coupons">
    Once the coupon group is created, you can upload a CSV file that includes third-party coupon codes. Next to the new coupon group created, click **Upload CSV**.

    <Frame>
      <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/upload-csv.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=80a8ea89673fba5f03fdc92a7b4faab2" alt="Upload CSV" width="1520" height="606" data-path="images/product-docs/admin-settings/upload-csv.png" />
    </Frame>

    The CSV file must include the following columns:

    | Column                          | Required |
    | ------------------------------- | -------- |
    | Coupon Code                     | Required |
    | Start Date                      | Optional |
    | Expiry Date                     | Optional |
    | Expiry Window                   | Optional |
    | Capping                         | Optional |
    | Minimum Order Value             | Optional |
    | Combine with Product Discounts  | Optional |
    | Combine with Order Discounts    | Optional |
    | Combine with Shipping Discounts | Optional |

    The system will validate your file for any missing or duplicate codes. You will receive an email notification confirming whether the upload was successful or not.
  </Step>

  <Step title="Manage Coupon Inventory">
    Go to the **Coupon Inventory** tab to view all uploaded third-party coupons. The table displays each coupon along with its status:

    | Status    | Meaning                                             |
    | --------- | --------------------------------------------------- |
    | Available | The coupon has not yet been claimed by any customer |
    | Used      | The coupon has already been redeemed                |
  </Step>

  <Step title="Track Coupon Redemption">
    Gameball automatically marks a coupon as **Used** once it is claimed by a customer. You can track redemption statuses directly from the dashboard.
  </Step>
</Steps>

***

## Common Questions

<AccordionGroup>
  <Accordion title="What happens if I upload duplicate coupon codes?" icon="circle-question">
    The system will reject duplicates during validation and notify you via email.
  </Accordion>

  <Accordion title="Can I reuse a coupon code that has been marked as Used?" icon="circle-question">
    No, once a coupon is used, it cannot be reassigned or reused.
  </Accordion>
</AccordionGroup>

<Note>
  Ensure your CSV file is correctly formatted to avoid upload issues. Only users with the appropriate permission levels can manage coupons.
</Note>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Request Coupon Creation from Your Couponing Engine" icon="gear" href="/product-documentation/admin-settings/request-coupon-creation">
    Configure Gameball to request coupons from your custom couponing engine.
  </Card>
</CardGroup>
