Joy Loyalty Devkit

Joy Loyalty Devkit is made for developers who want to go beyond the default widget and connect directly to Joy's loyalty engine.

There are two core toolsets:

1. REST API v2

Use this to integrate Joy with any external system—mobile apps, backend services, microservices, custom flows, or third-party platforms. With the API, you can:

• Fetch or update loyalty data (points, activities, rewards, tiers, referrals) from your own applications
• Sync Joy events with external systems like CRM, marketing automation, or custom dashboards
• Trigger loyalty logic from outside Shopify — mobile app events, POS extensions, or custom checkout flows
• Build your own admin tools or internal apps powered by Joy's reward engine

In short: API = expand Joy outside the storefront.

2. JavaScript SDK

This SDK is designed specifically for storefront developers (Online Store, Headless storefronts, Hydrogen, custom front-end builds). With it, you can:

• Render loyalty components with your own UI instead of Joy's default widget
• Use Joy's logic (reward fetching, points calculation, referral link generation) while keeping full control over layout and styling
• Trigger loyalty actions on the storefront using your own UX patterns
• Build inline experiences—embedded tier badges, checkout loyalty hints, custom reward banners, etc.

In short: JS SDK = build your own loyalty UI on top of Joy.