Skip to main content
Promotions (automatic coupons) are discounts that apply automatically based on cart contents, order value, or customer eligibility—without requiring customers to enter a code.

Promotion Types


Promotions vs Coupons


Promotion Response


Checking for Promotions

Call this API whenever cart contents change to check if promotions apply.

Promotion Conditions

Configured in Gameball dashboard:

Cart-Based

  • Minimum cart value
  • Product collections
  • Product categories
  • Quantity requirements

Customer-Based

  • Customer segments (VIP, first-time)
  • Location
  • Loyalty tier
  • Purchase history

Time-Based

  • Date range
  • Flash sales
  • Recurring (weekly, monthly)
  • Event-based (holidays)

Common Scenarios


Configuration

Promotions are configured in the Gameball Dashboard under Campaigns → Promotions. Once active, the Automatic Coupons API evaluates all eligible promotions against cart data.

Automatic Coupons API

API endpoint documentation

Promotions Tutorial

Implementation guide