LogoLogo
HomepageCase studiesBook a demo
User Guide
User Guide
  • Welcome to Open Loyalty!
  • What's New
    • 2024
    • 2023
    • 2022
  • What's Next
  • Technical Guide
  • Main Features
    • Global Management
      • Analytics
      • Settings
      • Config Duplication
      • Usage
    • Dashboard
      • General Overview
      • Units Wallet Overview
      • Additional Metrics
      • Members by Tiers
    • Members
      • Member List
        • Configuration
        • Creating Members
        • Managing Members
        • Removing Members
      • Segments
        • Creating Segments
        • Managing Segments
        • Segment Conditions
      • Referred Members
    • Campaigns
      • Creating Campaigns
        • Return Campaign
        • Referral Campaign
        • Time-Based Campaign
        • Redemption Code Campaign
        • Internal event - Achievement progressed
        • Percent value distribution
      • Managing Campaigns
      • Campaign Simulation
      • Follow-up Campaigns
    • Custom Events
      • Custom Event Schemas
    • Transactions
      • Adding Transactions
      • Managing Transactions
      • Channels
    • Tiers
      • Adding Tiers
      • Managing Tiers
      • Tiers Configuration
      • Tier Benefits
    • Wallets
      • Wallet Types and Configuration
      • Unit Transfers
        • Creating Unit Transfers
        • Importing Unit Transfers
        • Managing Unit Transfers
    • Achievements
      • Creating Achievement
      • Managing Achievements
      • Follow up Achievements
    • Rewards
      • Reward List
        • Rewards Configuration
        • Creating Reward
        • Reward Types
        • Units Conversion Coupon
        • Adding Coupons
        • Reward Flow
      • Reward Fulfillment
      • Reward Categories
    • Webhooks
      • How to Configure a Webhook
      • What Triggers a Webhook
      • Expiring Notifications
    • Collections
    • Imports / Exports
      • Imports
        • Sample Import Files
      • Exports
        • UI Data Exports
        • Configuration Exports
        • S3 Bucket Exports
    • Settings
      • Roles
      • Admins
        • System Logs
      • Tenants
      • Translations
    • Expressions
      • Attributes List
      • Operators
      • Custom Functions
      • Expression Examples
      • Sample Use Cases
        • Using Member Custom Attributes
        • Complex Effects (if, else)
        • Excluding Members
        • Elapsed Time Conditions
        • Using Additional Dates for Calculations
        • Register on Birthday
        • Transaction on Birthday
        • Tier Upgrade or Downgrade
  • Sample Setups
    • Good Practices
    • Pay with Points
    • Promo and Discounts in Cart
    • Sample Campaigns
      • #1 Earn 1 point for every $1 spent
      • #2 Earn 2x points when shopping on Monday morning
      • #3 Earn 1 stamp for every transaction
      • #4 Buy product ACME 123 and earn 100 points
      • #5 Refer a friend and get 100 points
      • #6 Refer 5 friends and get a $50 off coupon for the next purchase
      • #7 Register to the program and get 50 bonus points
      • #8 Get 30 bonus points for your first transaction in the loyalty program
      • #9 Cashback campaign
      • #10 Product meets selected criteria
    • Sample Achievements
      • #1 Celebrate summer - Buy 5 times between June and August
      • #2 Place 10 Orders above 50€ - Complete 10 transactions, for more than 50€ each
      • #3 Ambitious player - Log in to the game 3 times per week for 8 consecutive weeks
      • #4 SKU 'ABC' configuration - Spend total of 100$ on products with SKU 'ABC132' in September
      • #5 Workout track -Track a workout of at least 30 minutes for 5 days in a row
      • #6 4 referees made the transactions for 2 consecutive weeks
      • #7 2 referees made a transaction configuration
  • FAQ
    • Configuration Migration
    • Custom Attributes
    • Achievements
    • GDPR
    • Opt-Out
    • Referral Programs
    • Returns and Cancellations
Powered by GitBook
On this page
  • Adding New Wallet Type
  • Basic settings
  • Unit settings
  • Wallet type status
  • Wallet Configuration
  • Unit expiration method
  • Unit pending method
  • Limitation
  • Negative points balance
  • Wallet export/import
  • Exporting wallets
  • Importing wallets
  • Duplicating wallet configurations to a different tenant

Was this helpful?

  1. Main Features
  2. Wallets

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 3 months ago

Was this helpful?

Adding New Wallet Type

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:

  1. Go to Wallets -> Types of Wallets

  2. Click ADD NEW WALLET TYPE

  3. Fill in the required fields

  4. Set the Wallet Type status to Active

  5. Click ADD WALLET TYPE


Basic settings

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

Unit settings

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”

Wallet type status

  • 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.


Wallet Configuration

In this section, we will guide you through the configuration of the wallet's settings:

Unit expiration method

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

Unit pending method

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.

Limitation

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.

Negative points balance

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.

Wallet export/import

In the Wallets section, you can export and import wallets. These actions require a file in a .json format.

Exporting wallets

Exporting wallets how-to

To export a single wallet or several wallets:

  1. Go to Wallets -> Types of Wallets

  2. Click SELECT TO EXPORT

After clicking this button you will see the checkboxes next to the wallet number

  1. Select the wallets you want to export to the JSON file

  2. Click EXPORT TO .JSON FILE (X) to download the file

Importing wallets

Importing wallets how-to

To import a single wallet or several wallets:

  1. Go to Wallets -> Types of Wallets

  2. Click ADD WALLET TYPE -> Import wallet types

After clicking this button you will see the pop-up window to upload the JSON file

  1. Follow the instructions from the popup window.

  2. Click IMPORT to upload the waller file

  3. After importing the wallets you will see the list of all successful and/or wallets that require the action.

Duplicating wallet configurations to a different tenant

Exporting wallets to a different tenant how-to:

To export a single wallet or several wallets to different tenants:

  1. Go to Wallets -> Types of Wallets

  2. Click SELECT TO EXPORT

After clicking this button you will see the checkboxes next to the wallet number

  1. Select the wallets you want to export to a different tenant

  2. Click Export wallets to 'Different tenant' -> Select the targeted tenant

  3. To complete the action click Copy `Wallets and view the target tenant.

  4. After importing the wallets you will see the list of all successful and/or wallets that require the action to edit.

Unit expiration method - set when the units will expire - more information

Unit pending method - set for how long the units are pending (locked) - more information

Global units limitation - set the global limitation for a time period or in total - more information

Member units limitation - set the member limitation for a time period or in total - more information

here
here
here
here