Skip to main content
Meneja’s rewards system gives you a flexible, points-based loyalty program that you can tailor to your marketplace. Customers earn points through purchases, referrals, and bonuses, then redeem them for coupon codes at checkout. You control every aspect of the program — the earn rate, the redemption value, referral bonuses, and whether the program is active — all from the Rewards settings page.

Rewards configuration

The rewards configuration holds the global settings for your program. There is one configuration per tenant.
Start with a conservative earn rate and adjust upward based on redemption patterns. A higher points_per_tzs value increases engagement but also raises your redemption liability.

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.
Disabling the program (is_active: false) prevents new points from being earned, but does not clear existing point balances. Customers can still redeem previously accumulated points once you re-enable the program.

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.
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.
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.
Create a RewardHistory entry with type: 'bonus', the relevant points value, and a description explaining the reason. This increments the customer’s balance immediately.