Lions Creek Rewards — Support

For support, please email Support@TwoMenOnAYellowCouch.com.

How it works (v1.6)

• Earn: Points are awarded from Shopify order events (via webhooks), based on eligible net merchandise value after discounts.
• Reverse: Refunds and cancellations reverse points proportionally based on prior order snapshots so points don’t drift.
• Redeem: Customers generate a real Shopify discount code (single-use) from the Customer Account dashboard. One active code per customer at a time.
• Expiry: Issued discount codes expire after the configured window. Points expire after the configured inactivity window (enforced by a scheduled job).

Customer experience

• Primary UI: Shopify Customer Account UI Extension (“Lions Creek Rewards” page in the customer account).
• Optional / legacy: Storefront App Proxy endpoints for backwards compatibility:
  • /loyalty (HTML route; used by older proxy-based flows)
  • /loyalty.json (JSON endpoint for proxy/debug tooling)

Operational endpoints

• Webhooks: /webhooks
• Expiry job: GET /jobs/expire (use X-Job-Token or Authorization: Bearer if JOB_TOKEN is set)
• Customer Account API: GET /api/customer/loyalty and POST /api/customer/redeem (requires customer account session token)

Setup checklist

1. Admin settings: Open the app in Shopify Admin → configure earn rate, redemption mapping (points → $ value), and optional exclusions (excluded collections/products and/or tags). The discount-scope collection handle is optional (blank = discount applies to all products).
2. Customer Account page: Ensure the Customer Account UI extension is deployed and enabled in the store’s customer account.
3. Webhooks: Confirm required webhooks are registered (orders paid, refunds, cancellations, and Shopify privacy topics). The app’s webhook handler is /webhooks.
4. Expiry job: Schedule a daily GET to /jobs/expire. If JOB_TOKEN is configured on the server, include X-Job-Token (or Bearer auth).

Common issues

• Redemption fails: Common causes are insufficient points, a points amount that isn’t in the configured redemption steps, or an overly-restrictive discount scope (if you set a discount-scope collection handle).
• “I already have a code”: The system enforces one active code at a time. Use the existing code before creating a new one.
• No points awarded: The order must have a customer (not guest). Points are earned on all products by default, unless excluded by configured excluded collections/products and/or tags.
• Code doesn’t apply at checkout: If you set a discount-scope collection handle, ensure the cart contains products from that collection and meets any minimum order requirement. If the discount scope is blank, the code applies to all products.