Developer Toolkit

import loyalty from 'mage'

REST API, JavaScript SDK, Metafields, and Webhooks. Everything you need to ship custom loyalty on any Shopify stack, including headless. Then let our infrastructure handle the scale.

99.99%

Uptime SLA

1M+

API calls / day

Mage developer toolkit showing CSS customization and live preview

Your tools. Your rules.

A FULL DEVELOPER EXPERIENCE

REST API

Full CRUD on loyalty data. Customers, points, tiers, rewards, referrals. Build exactly what your brand needs.

JavaScript SDK

Client-side loyalty data, loaded where you need it. Points, rewards, tier status — rendered your way, on any storefront.

Metafields

Loyalty data synced natively into Shopify. Build custom Liquid templates without API calls. No workarounds.

Webhooks & Flow

Real-time events — points earned, rewards redeemed, tiers upgraded. Send them into Shopify Flow or your own backend.

Code-first loyalty

Like to code? We built this for you.

SDK for speed. API for control. Pick your level of abstraction. Then ship loyalty experiences that no template could produce.

MageSDK.getCustomerDetails().then(function(resp) {
  if (!resp.success) return;
  const customer = resp.data.customer;

  renderWidget({
    points: customer.points,            // 450
    lifetime: customer.lifetimePoints,  // 1200
    redeemed: customer.redeemedPoints,  // 750
    tier: customer.tier.name,           // "Gold"
    referral: customer.referralUrl
  });
});

What you can build

Bespoke loyalty on any Shopify stack. No limitations.

Checkout extensions

Loyalty redemption, embedded natively in Shopify checkout. Customers pay with points. No redirects, no friction.

Custom portals

Build on-brand loyalty portals and account pages with our components and APIs. Total control over the experience.

CSS & code blocks

Customise fonts, colours, CSS, or inject your own code blocks. White-label everything. Make it yours.

Infrastructure at scale

1M+ API calls daily. 99.99% uptime. Built for Shopify Plus and headless stacks that don't tolerate downtime.

Frequently asked questions

REST API for full CRUD on loyalty data. JavaScript SDK for frontend rendering. Shopify Metafields for native Liquid access. Webhooks for real-time event streaming. Pick the layer that fits your architecture.

API keys from your Mage dashboard under Settings > API Keys (Growth plan and above). Include in the Authorization header — no Bearer prefix. Scoped as full access or read-only. All traffic encrypted over HTTPS.

Yes. REST API from any server — Hydrogen, Next.js, Remix, your own backend. JavaScript SDK client-side on any storefront. Framework-agnostic. If it can make an HTTP request, it works with Mage.

Signed POST requests for points.earned, points.redeemed, tier upgrades, and more. X-Webhook-Signature and X-Webhook-Timestamp headers for verification. Failed deliveries retried 3 times with exponential backoff. Configure under Settings > Webhooks.

Infrastructure handles 1M+ calls daily. Limits are generous and scale with your plan. Need more for a specific integration? Talk to us. We accommodate custom requirements.

Shared Slack channel with the engineers who build Mage. Code reviews for complex integrations. Real-time debugging. Not a help desk — a direct line to the team.

Loyalty data — points, tier, rewards — synced into Shopify Metafields automatically. Access it directly in Liquid templates. No API calls needed. Perfect for theme customisations and server-rendered pages.

Let's talk loyalty and retention.

Chat with us and see why brands looking for a modern loyalty platform choose Mage.