Keystone Documentation

Appearance

Loyalty Program Settings ​

Overview ​

Configure your loyalty program's basic information and order processing settings. These settings control your program's branding and when customers earn points from purchases.

Accessing Program Settings ​

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

Enable Program Settings ​

Master toggle to enable or disable the entire loyalty program.

When Enabled:

  • Customers can earn points
  • Customers can claim rewards
  • Widget visible on storefront
  • Program is active

When Disabled:

  • No points earned
  • No rewards claimed
  • Widget hidden
  • Program paused

Basic Program Information ​

Program Name ​

The name of your loyalty program displayed to customers.

Default: "Loyalty Program"

Examples:

  • "VIP Rewards"
  • "Gold Member Program"
  • "[Store Name] Rewards"

Where It Appears:

  • Storefront widget
  • Customer emails

Points Name ​

The term used for loyalty points throughout your program.

Default: "Points"

Examples:

  • "Points"
  • "Stars"
  • "Coins"
  • "Credits"

Where It Appears:

  • Point balances
  • Earning notifications
  • Reward costs

Contact Email ​

Email address(es) for receiving app notifications.

Used For:

  • Program alerts and updates
  • System notifications

Multiple Emails:

  • Separate multiple addresses with commas
  • Example: support@store.com, manager@store.com

Not Used For:

  • Test emails (sent to store owner)
  • Export files (sent to store owner for security)
  • Customer-facing emails

Best Practices:

  • Use monitored email addresses
  • Include relevant team members
  • Keep list up to date

Order Processing Webhook ​

Configure when customers earn points from purchases.

Orders Paid ​

Award points when payment is received, before order fulfillment.

When to Use:

  • Want immediate point gratification
  • Digital products (no fulfillment)
  • Most standard stores

Timing:

  • Points awarded when payment processes
  • Before order ships
  • Customer sees points immediately

Orders Fulfilled ​

Award points after order is fulfilled and shipped.

When to Use:

  • High return rate
  • Want to prevent point fraud
  • Ensure order completion before awarding

Timing:

  • Points awarded after fulfillment
  • Customer waits longer
  • Reduces points from returned orders

Webhook Selection

Choose the webhook that best matches your business model. Most stores use "Orders paid" for immediate customer satisfaction. Consider "Orders fulfilled" if you have a high return rate or want to ensure order completion.

Configuration Steps ​

  1. Navigate to Loyalty Program > Settings
  2. Toggle Enable program settings ON
  3. Enter Program name (customer-facing)
  4. Enter Points name (e.g., "Points", "Stars")
  5. Enter Contact email for support
  6. Enter Contact name for communications
  7. Select Webhook to process:
    • Orders paid (immediate)
    • Orders fulfilled (after shipping)
  8. Save changes

All settings apply immediately after saving.

Summary ​

Loyalty Program Settings control your program's basic information and order processing behavior. Configure your program name, points terminology, and contact information for customer-facing elements. Choose whether to award points when orders are paid or fulfilled based on your business model. All settings apply immediately and affect how customers interact with your loyalty program.