Skip to main content
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 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: 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: 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: 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: 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:
If an item is affected by two multiplier campaigns, Gameball will apply the one with the higher multiplier.
Example: 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.