Points Allocation lets you create various allocation strategies and use the desired one when configuring rule-sets. You can allocate points on the transaction amount and custom field values. You can also have common points allocation across tiers or different allocation for each tier.

For MLP enabled orgs, allocation strategies created in a program are associated only to that program and cannot be used even in the org's default program.

There are two allocation types - Fixed and Prorated. 

  • In Fixed, a fixed number of points will be allocated irrespective of the transaction amount.
  • In Prorated, points are issued as a percentage of the transaction amount or custom field value.

Based on the allocation types, you can have the following combinations of points allocation strategies.

  • Reward points as a percentage of a transaction amount with the same percentage across tiers (example: Tier1: 15%, Tier2: 15%).
  • Reward points as a percentage of the transaction amount with different percentages for each tier (example: Tier1: 15% of the transaction amount, Tier2: 20% of the transaction amount).
  • Reward a fixed number of points per transaction across tiers. (example: Tier1: 15 points per transaction, Tier2: 15 points per transaction).
  • Reward a fixed number of points per transaction with different values across tiers (example: Tier1: 10 points per transaction, Tier2: 15 points per transaction).

This article covers the following topics.

Create or modify the points allocation strategy

To configure points to be allocated for each tier, do the following:

  1. On the loyalty program configuration page, go to the Points Allocation tab.
  2. In Round Decimals, select the decimal point that you want to round off for prorated (%) points. 0 is for no decimal, 1 is for one decimal point (example 2.1), 2 is for two decimal points (example 3.23), 3 is for three decimal points (example 4.321).  For example, if 50.3458 points have to be allocated to a customer.
Round Decimals value0123
Points round up in each case5050.350.3450.346
  1. Click +New to create a new strategy. [OR] Click the Edit button of a strategy to modify it.
In Show Allocation strategies for, you can choose to see points allocation strategies of only Loyalty module, only Campaign module, or All modules (default option).

  1. Create a new strategy or modify the existing settings based on the description provided in the following table and click Save.

NameSpecify a name for the points allocation strategy.
Module using the strategyChoose the module for which you want to use the current strategy (destination) - Loyalty to consume by loyalty module or Campaign to consume by campaign module.
Allocate based on custom field (only for the Loyalty module)Enable this option if you want to allocate points on custom fields.
For this, you need to configure Custom field type and Custom field name.

  1. Custom field type: Choose the type of the custom field customer level (loyalty_registration), transaction-level (loyalty_transaction), or store level (store_custom_fields).
  2. Custom field name: Choose the custom field for which you want to create a points allocation strategy.
Same for all tierEnable this to have a common points allocation settings across tiers.
Disable this option to set up different points allocation setting for each tier.
Allocation typeChoose your preferred allocation type.
The following are the options available for the Loyalty module (Module using the strategy is Loyalty).
  • Fixed to reward a fixed number of points (irrespective of the transaction amount). Example: 10 to issue 10 points per transaction
  • Prorated to reward points as a percentage of the transaction amount. Example: 10 to issue points of 50 points if the transaction amount is 500
  • Points Multiplier is used in promotions (run for a shorter period) along with allocation strategy used in the regular loyalty program. Points Multiplier is used to reward extra points, `n` times of the points allocated through the regular strategy.


Currently, if 5% of the transaction amount is rewarding as points (Prorated - 5%) and during Christmas, you want to double the count, create a promotion, and set the points allocation strategy as Points Multiplier and set the rate as 2 for each tier.

The following are the options available for the Campaign module (Module using the strategy is Campaign).

  • Fixed to reward a fixed number of points.
  • Round up lets you round up points that are in a specific range for each tier. In from and to, set the range of points that you want to have for the roundup and set the roundup value in Round up to for each slab All Slabs as per the options available.


You can run a campaign to round up points that are between 30-100 to 100 for all customers in the base tier. If a customer has 40 points in his base tier, another 60 points will be credited to his account rounding it up to 100 after you run the campaign.
All Slabs/Individual tiersIf Same for all tiers is enabled, specify the points to be allocated for a tier in All Slabs.
If Same for all tiers is disabled, configure the points that you want to allocate for each tier independently.
Enable delayed accrualEnable this option to delay points allocation for a specific number of days after the event date.
In Accrue points after, set the number of days after which the points have to add to the customer's account. The points will be added the next day morning.
If Enable delayed accrual is enabled and set Accrue points after as 7 days and Allocation type is Prorated at 10% for All Slabs.
A customer makes a transaction on Apr 1, 2019, for $200.
  • On 1 Apr, 20 points are issued as non-redeemable or promised points. A customer cannot redeem promised points.
  • On 9 Apr, those promised points will be credited to the main account, which is called the accrued date. Accrued Date = (Event Date + Delay Days + 1)
See the Notes for more information on Delayed Accrual.
DescriptionSpecify a short description of the current allocation strategy
  1. Once you create allocation strategies, configure Rulesets (EventView page) to define when to execute the Points Allocation Strategy. This is not applicable for campaign points (Module using the strategy as Campaign). 
Important points about Delayed Accrual
  • New event: DelayedAccrual: You need to configure the DelayedAccrual event to perform actions on Delayed Accrual.  
  • To enable converting promised points to current points, for the DelayedAccrual event, you need to set Delayed Accrual Action.

  •  Supported actions:
    • Send Messages (SMS, Email, Mobile Push)
    • Upgrade To Tier
    • Issue Coupon
    • Delayed Accrual
  • Functionality
    • In normal terms, the points allocation date is when points are actually issued to the customer. In the case of Delayed Accrual, the awarded date is when points get added to the current points (accrued date). 
    • Example
      • If a transaction with bill date A is sent to Loyalty EMF on date B, the awarded date will be date B
      • If the transactionAdd event of date A gets replayed on date B, the awarded date will be date B
      • If bill points with bill date A are imported on date B, the awarded date will be date B
    • The 'delayed accrual points' will be added to the 'current points' on the next morning of the delay period, i.e., (event date  + number of days of delay) specified in the point allocation strategy
      if a transaction is added on 28th Sep and the number of days of delay is 1, the delayed accrual points will get added to current points on the morning of 30th Sep (morning after 28, Sep + 1 day). The awarded date will be 30 Sep.
    • You can create rules on the points that are redeemable, non-redeemable, or with the summation of both.
  • Limitations:
    • In an event, you cannot use both direct allocation and delayed accrual strategies.

      In an event, you cannot have strategies with different delay periods. For example, you cannot use one strategy with 4 days delay period and another strategy with 7 days delay period.

    • You cannot use Delayed Accrual strategies on Registration and Customer Update events.

Points Allocation on Custom Field Values

You can also reward points to your customers based on the custom field values that submitted on the customer registration and profile update screens of InStore.  This works only for the custom fields with integer values (example: 20) and not for string values (example: John). It is recommended to use a fixed points allocation type for custom fields. 

To configure rewarding points based on the custom fields, do the following:

  1. Open the Points Allocation tab and click New to create a new allocation strategy (or ) To modify an existing strategy, navigate to the allocation strategy and click the respective Edit button.
  2. Set Allocate points based on custom fields to Yes.

  1. In the Allocation type, choose Fixed to allocate a specific number of points for every transaction (irrespective of the transaction amount). Choose Prorated to allocate points as a percentage of the transaction amount.
  2. In the Custom field type, choose the location of the custom field on InStore. For example, if the custom field is present on the Registration screen, choose loyalty_registration.
  3. In the Custom field name, choose the custom field for which you want to issue points.
  4. Click Save.
NoteTo modify an existing allocation strategy, click Edit button, and modify the strategy. 

Configure Points Round up for Campaigns

Points Allocation Configuration for Campaigns has an additional Allocation Type, Round Up. This lets you round up points that are in a specific range for each tier. For example, when running campaigns, you can roundup points that are between 30-100 to 100 for all customers in the base tier.

The points round up configuration can be done at the tier level.

  • In Allocation type, choose Round up
  • from and to: The range of points that you want to have for the roundup. You can configure this at the tier level or make it common for all the tiers. For example, if a customer has 40 points (current points) in his/her account and when the campaign is triggered, an additional of 60 points will be added to his/her account making it 100 as configured.

Configuring Rules for Points Allocation Strategy

Once you create a strategy, you need to configure the relevant event and define rules based on which you want to execute a specific points allocation strategy.

You can configure rules on TransactionAdd event and DelayedAccrual event.

To configure Rules for Points Allocation:

  1. On the top menu, click EventView.
  2. On the Events View page, choose the event for which you want to define points allocation rules. While defining actions,  you can choose the desired allocation strategy in Points Allocation as shown below. Always save your settings and click Reconfigure to apply the changes to the live loyalty program.

  1. You can also set up notifications to send to customers on the successful execution of the event. Configure SMS, email, WeChat, and/or Mobile Push templates accordingly. For detailed help on how to configure these messages, see Configuring Notification Messages and Configuring Notifications section in Configuring Rules.

Configure Events for Points Allocation at Line-Item Level

To allocate points at the line-item level, you need to have a forward case in which the line-item level unroller is enabled. To issue points on line-items based on the item price enable Use proportions as shown below.

Line item unroller is available only for forward cases (Forward to set action).

  • Enable transaction item unrollerEnable this option to issue points at the line-item level. You can see this option only on forward cases (Forward to Set Action).
  • Use proportions: Enable this option to split points according to the price of line-items. For example, consider a transaction with bill amount $300 consisting of two line items lineitem1 of $100, and lineitem2 of $200. If points allocation is 10% of transaction amount, then 10 points will be issued for lineitem1 and 20 for lineitem2.
  • Enable tender unroller: Enable this option to configure rules on payment modes.