loyalty-points-system

Implements loyalty points earning, redemption, tier progression, and expiration for ecommerce platforms.

3|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill loyalty-points-system-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: loyalty-points-system
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/pricing-promotions-loyalty/finsilabs/pricing-promotions/loyalty-points-system
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill loyalty-points-system-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Merchants need a structured customer retention program that rewards repeat purchases with redeemable points and tiered benefits, but building one from scratch risks balance errors, fraud, and poor auditability. ## Core Features & Use Cases - Platform-Specific Setup: Step-by-step configuration for Shopify (Smile.io, LoyaltyLion), WooCommerce (Points and Rewards, YITH), and BigCommerce, including earning rules, redemption ratios, and VIP tiers. - Custom Ledger-Based Build: SQL schema and TypeScript code for an append-only points ledger with tier multipliers, 12-month expiration, idempotent redemption, and a 50% redemption cap. - Use Case: A fashion brand on Shopify installs Smile.io to award 1 point per dollar, lets customers redeem 100 points for $1 off, and unlocks Gold tier perks once lifetime spend passes $1,000. ## Quick Start Set up a loyalty points program for my Shopify store with purchase earning rules, checkout redemption, and Bronze-to-Platinum tiers.

Frequently Asked Questions about loyalty-points-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a loyalty points program on Shopify?▼

Install Smile.io or LoyaltyLion from the Shopify App Store, then configure ways to earn (points per dollar, reviews, referrals), ways to redeem (points for discount codes), and VIP tiers with spend thresholds. Test by placing an order and verifying points award after fulfillment.

What loyalty app should I use for WooCommerce?▼

WooCommerce Points and Rewards is the official plugin at roughly $79 per year and handles earning and redemption natively. For tier and VIP functionality, use YITH WooCommerce Points & Rewards, since the official plugin lacks tier management.

How do I build a custom loyalty points system for a headless store?▼

Use an append-only ledger pattern with loyalty_accounts and loyalty_ledger tables where every points event is a signed transaction. Calculate balances by summing non-expired ledger rows, award points after fulfillment, and reverse points on refunds.

Should points be awarded at purchase or after fulfillment?▼

Award points after fulfillment, not at purchase, to prevent customers from earning points on orders they plan to return. Most loyalty apps offer a configurable pending period, and custom builds should insert a negative adjustment when a refund occurs.

How do I prevent loyalty points fraud and margin loss?▼

Cap redemption at 50% of order value, validate referrals by checking referrer and referee have different emails or billing addresses, and make redemption idempotent by checking for an existing redemption transaction tied to the order before deducting points.