Returning.AIDocs

Embed Loyalty Widgets
in Minutes

Drop-in components, iframe embeds, or server-side proxy. Any framework, any backend.

Get StartedView on npm
index.html
1<rai-store-widget
2  widget-id="YOUR_WIDGET_ID"
3  api-url="YOUR_API_URL"
4  widget-url="YOUR_WIDGET_URL"
5  data-email="user@example.com"
6  data-userId="USR-9a3f2b"
7></rai-store-widget>
Time to first widget:
Attribute auth: ~10 minToken auth: ~30 minFull server proxy: ~1 hour

Works with your stack

React
Next.js
Vue
Angular
Svelte
JavaScript

Built on Web Components - works in any framework

Three Ways to Integrate

Fastest

Widget SDK

Drop-in Web Components that render natively in any framework. The fastest path to a live loyalty widget.

Learn more
Most Compatible

Iframe Embed

Embed a fully hosted widget via iframe. Zero build step, works everywhere, including static HTML and CMS pages.

Learn more
Most Control

Server Proxy

Proxy the widget API through your own backend for full control over caching, auth, and data flow.

Learn more

See What You Can Build

yoursite.com/rewards

Electronics

4 items
Featured

iPhone 17 Pro Max

Latest flagship with A19 chip

5 left
C45,000
Popular

iPad Pro 14" M4

Liquid Retina XDR display

12 left
C28,000
Limited

AirPods Pro 3

Active noise cancellation

24 left
C8,500
Exclusive

Apple Watch Ultra 3

Titanium case, GPS + cellular

8 left
C22,000

Luxury Goods

2 items
Exclusive

Rolex Submariner

Oystersteel, black dial

2 left
C185,000
Limited

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.

<rai-store-widget
  widget-id="YOUR_WIDGET_ID"
  api-url="YOUR_API_URL"
  widget-url="YOUR_WIDGET_URL"
  data-email="user@example.com"
  data-userId="USR-9a3f2b"
  data-firstname="Jane"
  data-tier="gold"
></rai-store-widget>

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
Server-Verified

Token Auth

Your backend calls Returning.AI's signin endpoint and gets a short-lived JWT. The API key never touches the client.

<rai-store-widget
  widget-id="YOUR_WIDGET_ID"
  auth-url="/api/widget-auth"
></rai-store-widget>
// Your backend endpoint
const { token } = await fetch(
  signinUrl,
  {
    headers: {
      "returningai-api-key": API_KEY,
      "email": user.email,
    },
  }
).then(r => r.json());
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>

Mini Games

Spin-the-wheel and scratch cards

<rai-minigame-widget>

Ready to Integrate?

Get your loyalty widgets live in under 10 minutes

Get Started