Rewards configuration
The rewards configuration holds the global settings for your program. There is one configuration per tenant.Configuring the rewards program
1
Open Rewards settings
Go to Growth Tools → Rewards in the sidebar, then select the Settings tab.
2
Set your earn rate
Enter a value for Points per TZS. For example, a value of
1 means a customer earns 1 point for every 1 TZS spent.3
Define redemption thresholds
Set Redemption points (the minimum balance needed to redeem) and Redemption value (TZS) (what those points are worth at checkout).
4
Set the referral bonus
Enter the number of points to award a referrer when their referee completes a qualifying action. This value populates
referral_bonus_points.5
Activate the program
Toggle Active to enable the program. When
is_active is false, no points are earned or redeemed regardless of other settings.Reward types
Every points transaction is classified by type. There are four reward types:purchase
Points earned when a customer completes a purchase. The amount is calculated using
points_per_tzs multiplied by the order value.referral
Points awarded to the referrer when a referred customer completes a qualifying action, as defined by
referral_bonus_points.redemption
A debit entry recorded when a customer redeems points for a coupon code at checkout.
bonus
Discretionary points granted outside of purchases and referrals, such as promotional campaigns or manual adjustments.
Reward history and balances
Each customer has a rewards balance that tracks their current points alongside their full transaction history.Balance fields
History entry fields
Each entry in the history represents a single points event:Referral program
The referral program rewards customers for bringing new users to your marketplace. Each referral record links a referrer to a referee through a unique code.Referral statistics
The referral statistics section gives you a program-level view of referral activity:
The Top referrers list includes each referrer’s
userId, userName, referralsCount, and pointsEarned, making it easy to identify your most active advocates.
Redemptions
When a customer redeems points, Meneja generates a coupon code and records the redemption.What happens when a coupon expires?
What happens when a coupon expires?
A redemption record moves to
expired status when the coupon code has not been used within its validity window. The deducted points are not automatically refunded — you must issue a manual bonus adjustment if you wish to return them.Can I view a single customer's point history?
Can I view a single customer's point history?
Yes. Use the Rewards section to look up a customer by their user ID and view their full
RewardBalance, including the complete history array with all point events sorted by date.How do I grant bonus points manually?
How do I grant bonus points manually?
Create a
RewardHistory entry with type: 'bonus', the relevant points value, and a description explaining the reason. This increments the customer’s balance immediately.