Skip to content

Points Expiry ​

Overview ​

Points Expiry automatically resets customer points to zero after a period of inactivity, encouraging regular engagement with your loyalty program. Configure global expiry periods, override for specific customers, and exclude customers as needed.

Accessing Points Expiry ​

  1. Open Keystone Loyalty Rewards app
  2. Navigate to Loyalty Program > Program Settings > Points Expiry

Enable Points Expiry ​

Master toggle to enable or disable points expiry for your entire program.

When Enabled:

  • Points expire after inactivity period
  • Daily check for expired points
  • Customers notified before expiration
  • Transactions archived when expired

When Disabled:

  • Points never expire
  • No inactivity monitoring
  • All points remain active

Inactivity Period ​

Global Inactivity Period ​

Set the default inactivity period for all customers.

Configuration:

  • Set number of months of inactivity
  • Applies to all customers by default
  • Can be overridden per customer

How It Works:

  • Countdown starts from last transaction
  • Any earning or spending resets timer
  • Points expire at end of period

Examples:

Inactivity Period: 3 months

Customer's last transaction: January 1
Inactivity deadline: April 1
If no activity by April 1: Points expire

Individual Customer Override ​

Set custom inactivity periods for specific customers.

Use Cases:

  • VIP customers get longer periods
  • New customers get shorter periods
  • High-value customers get extensions
  • Promotional extensions

Configuration:

  1. Navigate to customer details
  2. Click Edit Expiry Period
  3. Set custom inactivity period
  4. Save changes

Example:

Global period: 3 months
VIP customer override: 6 months

Result: VIP customer has 6 months
before points expire

Bulk Override ​

Apply custom inactivity periods to multiple customers at once.

Process:

  1. Navigate to Customers
  2. Filter or select customers
  3. Click Bulk Actions
  4. Select Set Expiry Period
  5. Enter custom period
  6. Apply to selected customers

Tag/Segment Association ​

Automatically apply expiry periods based on customer tags or segments.

Configuration:

  1. Navigate to Points Expiry Settings
  2. Click Add Tag/Segment Rule
  3. Select tag or segment
  4. Set inactivity period
  5. Save rule

Examples:

Rule 1: Tag "VIP" = 12 months
Rule 2: Segment "New Customers" = 1 month
Rule 3: Tag "Loyal" = 6 months

Priority:

  • Individual overrides > Tag/Segment rules > Global period

Exclude Customers from Expiry ​

Prevent specific customers' points from expiring, regardless of inactivity.

Individual Exclusion ​

Exclude a single customer from points expiry.

Configuration:

  1. Navigate to customer details
  2. Toggle Exclude from Points Expiry ON
  3. Save changes

Result: Customer's points never expire, even with inactivity.

Bulk Exclusion ​

Exclude multiple customers at once.

Process:

  1. Navigate to Customers
  2. Filter or select customers
  3. Click Bulk Actions
  4. Select Exclude from Expiry
  5. Apply to selected customers

Use Cases:

  • Exclude all VIP tier customers
  • Exclude high-value customers
  • Exclude lifetime members
  • Exclude store ambassadors

Expiry Process ​

Daily Check ​

Automated daily job checks for expired points:

Process:

  1. Runs daily at scheduled time
  2. Checks each customer's last activity date
  3. Compares to inactivity period
  4. Expires points if period exceeded
  5. Creates expiry transaction

Ignored:

  • Customers excluded from expiry
  • Inactive stores
  • Already expired points

When Points Expire ​

What Happens:

  1. Customer points reset to zero
  2. "Inactivity expiration" transaction created
  3. Previous transactions archived
  4. Customer notified (if enabled)

Transaction Archive:

  • Transactions soft-deleted
  • Not visible in standard view
  • Can be viewed in "Archived Transactions"
  • Never permanently deleted

Example:

Customer Balance: 500 points
Last Activity: 3 months ago
Inactivity Period: 3 months

Expiry Process:
- Points reset to 0
- Expiry transaction created: -500 points
- Previous transactions archived

Extending Expiry Dates ​

Manually extend expiry dates to give customers more time.

Individual Extension ​

Process:

  1. Navigate to customer details
  2. Click Extend Expiry Date
  3. Select new expiry date or add time
  4. Save changes

Bulk Extension ​

Process:

  1. Navigate to Customers
  2. Filter or select customers
  3. Click Bulk Actions
  4. Select Extend Expiry
  5. Choose extension period
  6. Apply to selected customers

Extend All Customers ​

Process:

  1. Navigate to Points Expiry Settings
  2. Click Extend All
  3. Select extension period
  4. Confirm action
  5. All customer expiry dates extended

Use Case: Run promotional campaign giving all customers extra time.

Customer Notifications ​

Customers can be notified before points expire:

Notification Types:

  • Points Expiring Soon (reminder)
  • Points Expired

See Customer Email Notifications for configuration.

Use Cases ​

Re-engagement Campaign ​

Goal: Bring inactive customers back to store.

Configuration:

Inactivity Period: 3 months
Notification: 7 days before expiry

Strategy: Remind customers about expiring points

VIP Customer Retention ​

Goal: Give VIP customers longer grace period.

Configuration:

Global: 3 months
VIP Tag: 12 months

Result: VIPs have 4x longer expiry period

New Customer Activation ​

Goal: Encourage quick engagement from new customers.

Configuration:

Global: 6 months
Segment "New Customers": 1 month

Result: New customers incentivized to engage quickly

Seasonal Promotion ​

Goal: Give all customers extension during holiday season.

Action:

Extend All: +2 months
Timing: November-December

Result: Holiday boost for all customers

Summary ​

Points Expiry resets customer points to zero after a period of inactivity, encouraging regular engagement. Configure a global inactivity period for all customers, override for individuals or groups, and exclude specific customers entirely. Use customer tags and segments to automatically apply expiry rules. A daily job checks for expired points and creates expiry transactions. Merchants can extend expiry dates for individuals, groups, or all customers. When points expire, transactions are archived (not permanently deleted) and customers are notified if enabled. Use points expiry for re-engagement campaigns, customer retention, and activating inactive customers.