Platform	Plan
Selfserve	Add-on (Contact Support)

With Gameball’s couponing engine, you can manually create unique coupons to reward your customers or drive specific business objectives. In this article, we will walk you through the process of accessing the coupon creation feature and setting up a coupon manually.

Accessing the Coupon Creation Feature

Log in to your Gameball Dashboard.
From the left-side menu, navigate to Coupons.
Click on the Create Coupon button at the top of the page.

How to Create a New Coupon

When creating a coupon manually, follow these steps to set it up:

Step 1: Choose the Coupon Type

Define the type of coupon you want to create:

Free Product
Free Shipping
Fixed Amount-Based Discount (e.g., $10 off)
Percentage Amount-Based Discount (e.g., 15% off)
Buy X Get Y (For automatically applied coupons only)
Percentage-Based Cashback
Fixed Amount-Based Cashback
Percentage Amount-Based Fees Discount

Step 2: Add the Coupon Details

Set how the coupon will be applied: Choose between Discount Code or Automatic
1. Discount Code: A code that you will share with your customers that they will use while checking out
2. Automatic: Once the customer meets, a discount will be applied automatically
Internal Name the Coupon: Provide a unique name for your coupon for better monitoring on the dashboard.
Set the Coupon Code: You can manually enter a code or allow Gameball to auto-generate it.
External Name: Customers can see the localized display name in their widget, emails, and web messages.
Terms & Conditions: Add localized Terms & Conditions for manual coupons, helping you clearly communicate coupon rules and usage limits to customers in their preferred language.
Set the Coupon Value: Enter the value based on the type chosen.
Set the Minimum Purchase Amount: Define the minimum amount required for the coupon to apply.
Apply the Coupon: Decide whether it applies to All Orders or Specific Collections.

❗️Note: clients can specify whether the coupon should apply to both merchants and collections (AND) or either merchants or collections (OR).

General notes on "Display Name" and "Terms & Conditions":

Supports multiple languages, matching your widget’s configured languages.

Customer-Facing Experience:
- Customers now see the localized display name in their widget, emails, and web messages.
- If no translation exists for a customer’s language, the default language name will be shown instead.
API Updates:
- displayName is included in coupon API responses as a multi-language object (key-value pairs).
- No breaking changes for existing API integrations.
Terms & Conditions Field:
- A dedicated “Terms & Conditions” section is now available when creating or editing manual coupons.
API Updates:
- The coupon API includes an termsAndConditions object containing multilingual key-value pairs.
- No impact on existing coupon API consumers.
  
  How to distinguish regular coupons from automatic promotions?
  We’ve enhanced the Customer Coupons API to make it easier for apps and storefronts to distinguish automatic promotions from regular coupons and to display the promotion rules that define how customers can qualify for each offer. Here is what you will find:
  - Gameball added a new boolean flag: "isPromotion": true
    isPromotion = false → Regular or manually issued coupon.
    isPromotion = true → Promotion or rule-based discount (e.g., “Buy 2 Get 1 Free”, “50% Off Collection”).
  - Added a new object for promotion details:
    "promotionRules": {"type": "Buy X Get Y","description": "Buy 2 items from Summer Collection, get 1 free T-shirt","conditions": {"buyQuantity": 2,"getQuantity": 1,"applicableCollections": ["Summer Collection"],"minOrderValue": 0}}
    Includes:
    Promotion type and description
    Applicable collections or products
    Minimum order value or eligibility rules

Step 3: Choose the Audience

Select the target audience for the coupon:

All Customers: The coupon will be accessible to all customers.
Specific Customers: Target specific customer groups with precision using these options:
- Segments: Based on predefined customer behaviors.
- RFM Segments: Utilize Recency, Frequency, and Monetary metrics.
- Tags: Assign tags to filter customers.
- Customer Attributes: Filter customers based on attributes such as:
  - Customer ID
  - Customer Email

Step 4: Configure Advanced Options (if needed)

Add optional configurations to customize the coupon further:

Start Date: Specify when the coupon will become active.
End Date: Specify when the coupon will expire.

Expiry Date: Set an end date for the coupon.
Coupon Usage Per Customer Limit: Set how many times an individual customer can use the coupon.
Coupon Usage Limit: Establish a total usage cap for the coupon.
Reward Combined with Other Coupons: Specify whether the coupon can be used alongside other offers.

Step 5: Save the Coupon

Once all details have been added, click the Save button to finalize your coupon.

Manage Your Coupons Efficiently

Edit each coupon

Gameball offers shortcuts to help you manage your coupons effectively:

Shortcut	Description
Duplicate	Create an identical copy of an existing coupon for similar campaigns or promotions.
Activate/Deactivate	Toggle the coupon’s status to control its availability.
Edit	Update the coupon’s details, including name, value, usage limits, and more.
Delete	Permanently remove a coupon. Use this with caution, as deleted coupons cannot be recovered.