1. Overview
In this section, you can see a customer's current token balance and their balance history. Merchants can either add or delete balances from a customer’s account.
2. Reaching "Customer Balances" page
Log into Control Center
- Select Loyalty
- Select Customer
- Select Customer Balances
Figure 1.0
By selecting "Customer Balances," you will see the screen below. A log of the customer's earned tokens from purchases will appear here.
Figure 1.1
In this section, the following search functions are available:
- Balance Type – All balance types will appear in the drop-down menu.
- Customer Email – It displays the registered email address of the customer.
- First Name & Last Name – First and last name of the customer.
- Balance – Displays the current balance of the customer.
- Employee – A drop-down menu with Yes/No options to indicate whether the customer is a Loyal-n-Save employee.
- Created – Date when the balance was created.
- Updated – Date when the balance was updated.
- Actions – Displays three option buttons:
Figure 1.2
1. Modify Balance – Modify the customer’s balance by adding or removing tokens.
2. Balance History – The number denoted here is the combined total of the customer’s balance history.
3. Remove Item – Remove balance from the customer’s account.
Modify Balance
This refers to updating the number of tokens in a customer's account. This feature is used to correct errors, add credit tokens, or reflect the total available tokens. A customer's balance may be adjusted due to refunds, rewards, deductions, or corrections, ensuring an accurate token balance is displayed in their account.
Balance History
Balance history refers to a detailed record of all transactions that affect a user’s token balance. This feature helps customers track their token usage. Balance history includes deposits, withdrawals, rewards, deductions, and adjustments, giving a clear overview of token activity.
2.1 Merge Balance Type
This button allows the admin to merge two different balance types into one. When a campaign becomes inactive or expires, customers will no longer be able to earn or redeem tokens for it. If a balance type is decommissioned, it can be merged with the default balance.
Figure 1.3
- Allow Multiple: It allows adding multiple balances from the customer’s account.
- Source Type: Source type of the balance from which the balance would be deducted.
- Destination Type: Destination type of the balance to which the balance would be added.
- Delete Balance from Source: After the balance gets added to the destination type, the balance from the source would be deleted and would become 0.
- Once you fill in required details, click on "Save" to merge the balance in the customer’s account.
2.2 Adding Balance to New Customer
- Click on the "Add New" button to add balance to the new customer’s account. (Customers who have yet to earn tokens.)
Figure 1.5
- On clicking on the "Add New" button, you will see the screen below:
Figure 1.6
- Select the customer's name to which you want to add the customer balance.
- After you have entered the customer’s name, click on the "Search" button, and your customer details will be displayed.
Figure 1.7
Figure 1.8
- Once the result gets displayed, click on the "Apply" button.
Figure 1.9
- When you click on "Apply," you will see the customer's name along with two fields: Balance Type and Balance.
Figure 2.0
- In the Balance Type field, you will get options in the drop-down.
- Select any balance type.
- Additional token buckets (balance types) can be created in Control Center.
Figure 2.1
- Enter the token amount. For example: 1000 (in this case)
- Click on "Save & Close" to successfully add the amount to the customer’s balance.
Figure 2.2
2.3 Select Another Balance Type
- Select another balance type: For example, Winston.
- Enter the balance amount.
- Click on the "Save & New" button to successfully add the entered amount to the customer’s balance.
- When you click on the "Save" button, then you will be redirected to another screen as shown in Figure 2.4.
Figure 2.3
2.4 Modify Balance
This refers to updating the number of tokens in a customer's account. This feature is used to correct errors, add credit tokens, or reflect the total available tokens. A customer's balance may be adjusted due to refunds, rewards, deductions, or corrections, ensuring an accurate token balance is displayed in their account.
Use the column filters to search for the customer.
Figure 3.0
- Click the Modify icon under Actions to adjust the customer balance.
Figure 3.1
- 1. Modify Balance – Modify the customer’s balance by adding or removing tokens.
- 2. Balance History – The number denoted here is the combined total of the customer’s balance history.
- 3. Remove Item – Remove balance from the customer’s account.
Figure 3.2
In the screen above, you will see the balance amount entered for the customer’s account. Directly below, you will see the field labeled Change Type. There, you will have two options to choose from: Manual Change and Flagged Deduction.
- Manual Change: If you choose "Manual Change," the specified amount will be added to the customer’s account. Manual Change is a classification for when maybe system had a problem, etc.
- Flagged Deduction: If you select "Flagged Deduction," the entered amount will be deducted from the customer’s account. Flagged deduction is for marking something as if someone's points are being removed due to violations or abuse.
- Enter Change Notes: Provide a brief description of the change.
- Click on the "Save" button to save the details and exit.
The balance details will appear in the newly added balance history in the customer's account.
Bulk Add Tokens
The Bulk Add Tokens feature allows merchants to efficiently add token balances to multiple customers at once — either to a filtered group or all customers in the system.
- To add token balance to multiple customers, click on "Bulk Add Tokens."
Figure 3.3
- On the Bulk Add Tokens page, you can filter the customers based on Genders and Balance Type.
Figure 3.4
- Once you select the filters of your choice, the list of customers will be displayed based on applied filters.
- To select All Customers in the list, click on the top-left checkbox in the grid.
Figure 3.5
- Once you select the checkbox, a popup will be displayed with the following options:
- Select All Pages: Selects all customers across all pages.
- Select Current Page: Selects only the customers visible on the current page.
Figure 3.6
- Enter the amount of balance you wish to add to each selected customer's balance.
- Click on the "Update Balance For Selected List" button.
- Once you update, the specified token amount will be appended to each selected customer’s existing token balance.
Provision to adjust a customer's token balance to a negative amount
Merchant admins now have the ability to adjust a customer’s token balance to a negative amount. This feature is useful when correcting discrepancies, such as reversing incorrectly awarded tokens or handling refund scenarios where tokens need to be deducted.
- Admin Rights Required: Only users with merchant admin rights can perform this action, ensuring controlled access to sensitive token adjustments.
- Negative Balance Adjustment: Admins can directly set the customer’s token balance to a negative value when necessary.
- Balance History Update: Once the changes are saved, the balance history is automatically updated to reflect the negative adjustment. This ensures complete transparency and accountability in the customer’s token transaction history.
Why Allow Negative Token Balances?
Error Corrections:
- Sometimes, tokens might be awarded incorrectly due to system glitches, manual errors, or misconfigurations.
- Allowing negative adjustments helps correct such mistakes without completely voiding the transaction.
Refund and Returns Handling:
- When a customer returns a product or receives a refund, the originally awarded tokens need to be reversed.
- If the customer has already used those tokens, the balance may need to go negative to accurately reflect the deduction.
Fraud Prevention and Management:
- In cases where fraudulent activity is detected, admins can reduce or even nullify token balances to offset the misuse.
How to Perform a Negative Adjustment:
- Step 1: Choose Loyalty from the admin dashboard.
- Step 2: Choose Customer.
- Step 3: Choose Customer Balances.
Figure 3.7
- Step 4: Click on Edit icon to access the Customer Profile
Figure 3.8
- Step 5: Navigate to the token balance section.
- Step 6: Enter the negative token amount to be deducted.
- Step 7: Enter a reason or note for the adjustment (for transparency).
Figure 3.9
- Step 8: Save the changes, and the negative balance will immediately reflect in the Balance History.
Figure 4.0