Help

How this loyalty app maps to Smile.io concepts and Saleor webhooks.

Getting started

  1. Install the app from the manifest URL in Saleor Dashboard → Apps.
  2. Configure earn rules, rewards, and VIP tiers under Program.
  3. Set NEXT_PUBLIC_LOYALTY_API_URL on the storefront.
  4. Customers earn points when orders are fully paid; refunds claw back proportionally.

Smile.io reference

  • Smile.io Help Center — program setup, VIP, referrals, analytics.
  • Ways to earn / redeem mirror Smile program tabs in this app's Program section.
  • Business Growth analytics are under Analytics with date range filters.
  • Klaviyo, POS, nudges, VIP entry rewards, and gift cards are configured under Settings and Program.

Webhooks

  • ORDER_FULLY_PAID — award purchase points, referral bonuses, mark LOYAL- vouchers used.
  • ORDER_REFUNDED — proportional point clawback.

Storefront

  • Floating launcher widget on all pages.
  • /account/loyalty — full loyalty hub.
  • Checkout panel for redeeming rewards at checkout.
  • Product page badge showing points earn estimate.