Skip to main content
PlatformPlan
ShopifyFree, Starter, Pro & Guru
SallaStarter, Pro & Guru
Non-platform ClientsGrowth & Enterprise
Gameball provides several loyalty points earning configurations, each with specific conditions and priority rules. This ensures customers earn the correct amount of points based on their level, the collection or merchant they are purchasing from, and any active campaigns.
Custom loyalty points per merchant cannot be used in combination with custom loyalty points per collection.

​
Default Loyalty Points Earning

This is the basic loyalty points earning rule that applies if no other rule has been set up. If no specific configurations are in place for collections, merchants, or tiers, the system will apply the default Loyalty Points earning rate. Learn more Example:
Loyalty Points Earning TypeValuePoints Earned
Default Loyalty Points Earning1 pts1 pts per $1

​
Loyalty Points Earning per Tier

This rule overrides the default earning rate. When a customer qualifies for a tier-based earning configuration, points will be granted according to their level rate.
If an item has custom loyalty points for a collection or merchant, this rule is ignored.
Example:
Loyalty Points Earning TypePoints Value
Default Loyalty Points Earning3 pts
Loyalty Points Earning per Tier2 pts
Points Earned2 pts per $1
In this case, the customer earns 2 points per $1 based on their tier.

​
Custom Loyalty Points Earning per Collection or Merchant

This rule takes precedence over both the default rate and tier-based earnings. If an item belongs to multiple collections, the system compares all configured values and applies the highest. Example:
Collection NameCustom Loyalty Points Earning
Collection Breakfast4 pts
Collection Cheese2 pts
Points Earned4 pts
If an item belongs to both collections, the customer receives the highest value (4 pts).

​
Custom Loyalty Points per Tier per Collection or Merchant

This rule overrides all previous configurations. Gameball compares the loyalty points set at the collection or merchant tier with the customer tier, and the higher value is applied. Example 1:
CollectionCustom Loyalty PointsLoyalty Points per Tier 2
Collection Breakfast4 pts6 pts
Collection Cheese3 pts2 pts
Points Earned6 pts from Breakfast3 pts from Cheese
In this case, the customer earns 6 points for items in Collection Breakfast and 3 points for items in Collection Cheese, as these are the higher values. Example 2:
CollectionCustom Loyalty PointsLoyalty Points per Tier 2
Collection Breakfast4 pts5 pts
Collection Cheese2 pts6 pts
Points Earned6 pts
In this case, 6 points are awarded based on the highest applicable rule.

​
Multiplier Campaign

Multiplier campaigns are applied after all earning rules. Learn more. The system calculates points per item and then applies the multiplier, rounding down the result per item before summing. Example:
ItemPoints Before MultiplierMultiplierEarned Points
Item 12.3 pts2x4 pts
Item 23.1 pts3x9 pts
Points Earned13 pts
If an item is affected by two multiplier campaigns, Gameball will apply the one with the higher multiplier.
Example:
Campaign TypeMultiplier
Whole order3x
Campaign on Collection5x (on cheese)
Points EarnedEarned points from the first four rules x5
If the customer purchases an item from the Cheese collection, the 5x multiplier will be applied.

​
Refund Rules

Gameball deducts points proportionally based on the refunded item’s value.Example: If an item worth $12.50 is refunded, 12 points will be deducted.
All points earned from the order will be removed, including points from campaigns.
To correctly deduct both base and campaign points, the product ID and quantity must be submitted during the refund process. If this data is not provided, Gameball will only deduct the base points value.

​
General Notes

  • Orders with custom loyalty points must be submitted using the Order API.
  • Include all line items with details like price, taxes, discounts, and points values.
  • If not applicable, these values must be set to “0”.
  • Shipping rewards follow the same rules as general, campaign, or tier-based rewards. However, shipping refunds are not supported.
  • If the returned item is the last item in the order, all points (except shipping) will be deducted.

Launch and Configure Your Earn Pointing System

Activate and configure how customers earn points.

Introduction to Reward Campaigns

Learn about the different types of reward campaigns.

Configure Your Redeem Pointing System

Set up how customers can redeem their earned points.