Loyalty Points API - Rewards & Redemption System

Build powerful loyalty programs and points-based reward systems with our comprehensive Loyalty API. Award points for user actions, create reward catalogs, enable point redemptions, and drive repeat engagement with incentive programs.

Perfect for e-commerce loyalty programs, customer retention systems, membership rewards, referral programs, cashback systems, and any point-based economy. Increase customer lifetime value and repeat purchases.

Overview

The Lynes Loyalty platform allows you to build a complete points-based reward system. Users earn points through events and can redeem these points for various rewards you define.

Points Accumulation

Points are awarded through events when users perform desired actions:

• Each event can have a specific point value
• Points can be fixed or variable (e.g., based on purchase amount)
• Points accumulate in the user's balance automatically
• Point histories are tracked for transparency

Points Redemption

Once users accumulate points, they can exchange them for rewards:

• Discount codes or coupons
• Free products or services
• Exclusive content or features
• Early access to new features
• Status upgrades or tier benefits

Implementation

Today, redemptions are performed via the offers and user endpoints in your Gamification API:

• POST /v1/offer/redeem – redeem an offer for a user (generic offer redemption)
• POST /v1/user/{userId}/offer/{offerId}/redeem – redeem a specific offer for a specific user

// Example redemption API call - using user/offer endpoint
fetch(`/v1/user/${userId}/offer/${offerId}/redeem`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_JWT`,
  },
  body: JSON.stringify({
    metadata: {
      source: "app",
    },
  }),
});

Coming Soon

More detailed documentation on loyalty point redemption is coming soon, including:

• Reward catalog management
• Redemption API reference
• Handling redemption fulfillment
• Implementing tiered rewards
• Advanced redemption rules and constraints
• Analytics for reward popularity and engagement

Stay tuned for updates to this section as we expand our documentation.