Skip to content
Returning.AIDocs

Embed Loyalty Widgets
in Minutes

Drop-in components with Access Key authentication, or embed scripts. Any framework, any backend.

Get StartedView on npm
index.html
1<rai-store-widget
2  community-id="YOUR_COMMUNITY_ID"
3  embed-token="TOKEN_FROM_YOUR_SERVER"
4  domain-key="PROD"
5  bundle-url="https://prod-widgets.returning.ai/store-widget/bundle/widget.js"
6  api-url="https://prod-widgets.returning.ai"
7  v2-api-url="https://api-v2.returning.ai"
8></rai-store-widget>
Time to first widget:
Embed script: ~5 minSDK + Access Key: ~15 min

Works with your stack

React
Next.js
Vue
Angular
Svelte
JavaScript

Built on Web Components - works in any framework

Two Ways to Integrate

Recommended

Widget SDK

Access Key authentication with bundle mode rendering. Server-verified identity, native DOM integration, and the best performance.

Learn more
No Backend

Embed Script

Paste a widget loader script tag into any HTML page. Zero build step, works everywhere, including static HTML and CMS pages. No backend required.

Learn more

See What You Can Build

yoursite.com/rewards

Electronics

4 items
FeaturediPhone 17 Pro Max

iPhone 17 Pro Max

Latest flagship with A19 chip

5 left
C45,000
PopulariPad Pro 14" M4

iPad Pro 14" M4

Liquid Retina XDR display

12 left
C28,000
LimitedAirPods Pro 3

AirPods Pro 3

Active noise cancellation

24 left
C8,500
ExclusiveApple Watch Ultra 3

Apple Watch Ultra 3

Titanium case, GPS + cellular

8 left
C22,000

Luxury Goods

2 items
ExclusiveRolex Submariner

Rolex Submariner

Oystersteel, black dial

2 left
C185,000
LimitedTag Heuer Monaco

Tag Heuer Monaco

Chronograph, blue dial

3 left
C95,000

Two Ways to Authenticate

No Backend Required

Attribute Auth

Pass user identity directly as HTML attributes. Ideal when you only have access to an HTML container or limited backend resources.

<script
  src=".../widget-loader.js"
  data-widget-id="YOUR_WIDGET_ID"
  data-email="user@example.com"
  data-user-id="USR-9a3f2b"
  data-firstname="Jane"
  data-tier="gold"
></script>

Stack attributes for stronger identity verification. Each additional field makes the identity harder to spoof. Custom fields from your platform add extra layers of security.

Learn more
Recommended

Access Key Embed

Your backend exchanges access credentials for a short-lived JWT. Inject the token as an attribute - no client-side secrets.

<rai-store-widget
  community-id="YOUR_COMMUNITY_ID"
  embed-token="TOKEN_FROM_YOUR_SERVER"
  domain-key="PROD"
  bundle-url="https://prod-widgets.returning.ai/store-widget/bundle/widget.js"
  api-url="https://prod-widgets.returning.ai"
  v2-api-url="https://api-v2.returning.ai"
></rai-store-widget>

Server-verified identity with bundle mode rendering. The recommended approach for any platform with backend access.

Learn more

Every Widget You Need

Store

Rewards marketplace with loyalty currency

<rai-store-widget>

Channel

Community hub with missions and quests

<rai-channel-widget>

Milestone

Achievement stages and unlock rewards

<rai-milestone-widget>

Social

Social media engagement tasks

<rai-social-widget>

Currency

Points balance and transaction history

<rai-currency-widget>

Referral

Invite links and referral rewards

<rai-referral-widget>

Custom

Flexible admin-configured widget

<rai-custom-widget>

Ready to Integrate?

Get your loyalty widgets live in under 10 minutes

Get Started