Wallet Types and Configuration
In this article, you will get all the information about the types of wallets shown in the main table. You will also learn to edit and add new wallets.
Last updated
In this article, you will get all the information about the types of wallets shown in the main table. You will also learn to edit and add new wallets.
Last updated
In this section, you can define the settings of the new wallet type and determine the status of its activity.
To add a new Wallet Type:
Go to Wallets -> Types of Wallets
Click ADD NEW WALLET TYPE
Fill in the required fields
Set the Wallet Type status to Active
Click ADD WALLET TYPE
In the Basic settings, you define:
Wallet name - Name of the wallet
Wallet description - Short description of the wallet. It can be used for identification purposes as well as describing customer-facing applications.
Add translation - New translation for wallet name and description.
Wallet code - Wallet identification code
In the Unit settings, you define:
Unit singular name - Singular form of the unit name. E.g. “Star”
Unit plural name - Plural form of the unit name. E.g. “Stars”
Unit expiration method - set when the units will expire - more information here
Unit pending method - set for how long the units are pending (locked) - more information here
Global units limitation - set the global limitation for a time period or in total - more information here
Member units limitation - set the member limitation for a time period or in total - more information here
Active - Status of the wallet. You can deactivate the wallet at any time.
Upon the creation of a wallet, please be aware that it may take a few minutes for the wallet to become fully activated.
The Active toggle is not available for the default wallet because each program must have at least one active wallet.
In this section, we will guide you through the configuration of the wallet's settings:
In this part, you can set when the Units will expire.
No expiration - Units never expire
After X days - Units will expire after a defined number of days
At the end of the month - Units will expire at the end of the month
At the end of the X-th year - Units will expire at the end of the defined year. (if you set 0 as the value, the units will expire at the end of the current year)
Annual expiration on a chosen date - the points will expire annually on the chosen date
This option allows you to lock or unlock the Units. The expiration date of blocked units is calculated Unit pending method.
No pending - Units are automatically available
Pending for X days - Units are pending (locked) for a defined number of days
After the specified time, units are no longer pending and change their status to active, thus becoming available for the member. If necessary, you also have the option to manually activate these units before the scheduled time.
the Expiration method: After X days vs At the end of the month/year
Please note the different behaviors in correlation to the pending method (Pending for X days):
After X days - if you set the days after the points will expire and days in the pending method, the expiration time will be extended by X days set in the Pending method.
At the end of the month/year - the points expire at the end of the month or year, and the days in the pending method don't extend/affect the expiry date.
You can set two types of limits here:
Global units limitation - defines how many units can be added to all members for this type of wallet. You can set the limit for a time period or in total.
Member units limitation - defines how many units can be added to this type of wallet for a single member. You can set the limit for a time period or in total.
If you set both limits, they are active at the same time - units are not added to the user if the unit transfer exceeds any limit. For example, the transfer can be within the member's unit limitation, but if it exceeds the global limitation - it will not be processed. Keep in mind, that these limits are only for automatic transfers (e.g. coming from campaigns), and you can still adjust the units manually if needed.
Once the point transfer is canceled, the units back to the pool.
Once the campaign point transfer (Units Campaign effect) is canceled, the units back to the pool.
Optionally, you can enable the negative points balance for the specific wallet.
This feature allows users to spend units even when they don’t have enough balance. In a way, they borrow units from the business.
From the Operational/Finance perspective, negative balances represent a loss. If misused, they allow members to exploit the system and accumulate rewards without spending money or engaging with the company, risking the loyalty program’s health.
Some good practices for using negative balances:
Review all campaigns that reward members with units
Set accrual limits so members can’t obtain units endlessly
Monitor the unit's dashboard regularly for negative spikes
Consult your financial department for possible scenarios
The feature is available upon request. If you want to enable this option, please contact OpenLoyalty.
This feature is still in a BETA phase, therefore it may undergo changes or you may experience unforeseen behavior.
In the Wallets section, you can export and import wallets. These actions require a file in a .json format.
Exporting wallets how-to
To export a single wallet or several wallets:
Go to Wallets -> Types of Wallets
Click SELECT TO EXPORT
After clicking this button you will see the checkboxes next to the wallet number
Select the wallets you want to export to the JSON file
Click EXPORT TO .JSON FILE (X) to download the file
Importing wallets how-to
To import a single wallet or several wallets:
Go to Wallets -> Types of Wallets
Click ADD WALLET TYPE -> Import wallet types
After clicking this button you will see the pop-up window to upload the JSON file
Follow the instructions from the popup window.
Click IMPORT to upload the waller file
After importing the wallets you will see the list of all successful and/or wallets that require the action.
Exporting wallets to a different tenant how-to:
To export a single wallet or several wallets to different tenants:
Go to Wallets -> Types of Wallets
Click SELECT TO EXPORT
After clicking this button you will see the checkboxes next to the wallet number
Select the wallets you want to export to a different tenant
Click Export wallets to 'Different tenant' -> Select the targeted tenant
To complete the action click Copy `Wallets and view the target tenant.
After importing the wallets you will see the list of all successful and/or wallets that require the action to edit.
