Loyalty Cards Settings.

The Loyalty Cards settings control how your loyalty program behaves, including member limits, redemption code expiration, and staff visibility rules.

Accessing Loyalty Cards Settings

1. Navigate to Settings in the admin sidebar
2. Click the Loyalty Cards tab

You can also configure these settings via environment variables in your .env file.

Member Settings

Max Member Request Links

Controls how many point request links a member can generate at one time.

Default: 5 links

Purpose: Prevents abuse by limiting how many pending point requests a member can have. When a member generates a link to request points from a partner, this counts toward their limit.

Via Admin Dashboard

1. Navigate to Settings > Loyalty Cards tab
2. Find Max Member Request Links under Member Settings
3. Use + / - buttons or enter a number directly
4. Click Save

Via Environment File

MAX_MEMBER_REQUEST_LINKS=5

Redemption Settings

Redemption Code Validity

When a staff member generates a redemption code for a reward, it doesn't last forever. This setting controls how long codes remain valid before expiring.

Default: 3 Days

Purpose: Prevents misuse by automatically expiring old codes. This ensures codes aren't shared or reused inappropriately.

Via Admin Dashboard

1. Navigate to Settings > Loyalty Cards tab
2. Find Redemption Code Validity under Redemption Settings
3. Select your preferred duration from the dropdown:
   • 1 Hour
   • 12 Hours
   • 1 Day
   • 2 Days
   • 3 Days (default)
   • 1 Week
   • 1 Month
   • 1 Year
4. Click Save

Via Environment File

The expiration time is defined in minutes:

# Default: 3 Days = 4320 minutes
CODE_TO_REDEEM_POINTS_VALID_MINUTES=4320

Staff Settings

Staff Transaction Visibility (Days)

Controls how many days a staff member can see members they've interacted with in their staff dashboard.

Default: 7 days

Purpose: This is a privacy and security feature. It limits how long staff can access member transaction history, protecting member privacy while still allowing staff to complete their work.

Via Admin Dashboard

1. Navigate to Settings > Loyalty Cards tab
2. Find Staff Transaction Visibility (Days) under Staff Settings
3. Enter the number of days (0 = cannot see any historical transactions)
4. Click Save

Via Environment File

APP_STAFF_TRANSACTION_DAYS_AGO=7

Privacy Considerations

⚠️ Privacy & Security Notice

This setting helps protect member privacy by limiting how long staff can view member interaction history. Lower values improve privacy but may reduce staff efficiency.

Recommended values:

• 1-3 days — High privacy environments (medical, financial)
• 7 days — Standard retail/hospitality (default)
• 30 days — Low-turnover staff, high trust environments
• 0 days — Staff cannot see past transactions at all

Real-World Examples

Coffee Shop Chain

Spa & Wellness Center

Retail Store

Troubleshooting

"Maximum Request Links Reached" Error

Cause: Member has reached the maximum number of active request links.

Solutions:

1. Ask them to wait for existing links to be used or expire
2. Increase the Max Member Request Links setting

Redemption Code Expired

Cause: The code validity period has passed.

Solutions:

1. Extend the Redemption Code Validity if it's too short for your business
2. Educate members about validity periods when they redeem
3. Consider sending reminder notifications before codes expire

Staff Can't See Recent Transactions

Cause: The Staff Transaction Visibility window is too short.

Solutions:

1. Increase the visibility days setting
2. Verify the transactions exist in the system
3. Check that staff are viewing the correct member's card

Important Notes

• Settings configured in the Admin Dashboard override environment file values
• Changes take effect immediately for new transactions
• Existing codes retain their original expiration time
• If you change settings via .env, clear your configuration cache:

  php artisan config:clear
  

Related Topics

• Redemption Codes — How staff and members use redemption codes
• System Settings — Overview of all admin configuration
• Staff Overview — Managing staff accounts
• Creating Rewards — Setting up rewards