For Developers: API-First Architecture

Loyalty Reimagined

The next-generation platform for customer retention. Wire up checkout webhooks so shoppers earn points on every purchase, then layer AI-powered loyalty that scales with your business.

View Demo
admin.acme-inc.com/dashboard

Dashboard Overview

Real-time insights into your loyalty program

+12%
2,847
Active Members
+8%
$24.5K
Revenue Influenced
+15%
1,203
Rewards Claimed
AI Sales Suggestions
NEW
Add-on suggestions active
Best-value redemptions
Mission challenges
Drop matching enabled
Implementation

Add the widget to your site

The Perkly widget is a single JavaScript file served from your deployment. It reads widget.js, resolves your workspace, loads settings from the API, and renders the floating launcher + panel. Replace placeholders with your production origin and workspace slug.

  1. 1

    Get your workspace slug

    In the admin, open your workspace—the slug appears in the URL /admin/[slug]/… and on the Widget page where the embed snippet is generated. That value is what data-workspace must use.
  2. 2

    Include the script on storefront pages

    Add the embed once in your layout, template, or tag manager so widget.js loads on pages where shoppers should see rewards. The script must be served from your Perkly app origin (the same host that serves /api/widget/…), e.g. https://app.perkly.com.
  3. 3

    Optional: workspace in the page URL

    For testing, the widget also reads ?workspace= or ?w= from the current page URL if you need a quick check without embedding.
  4. 4

    Customize in admin

    Colors, font, and button position come from Widget settings—they apply after the next load of /api/widget/settings.
Recommended embed (dynamic loader)
<!-- Load widget.js from your perkly deployment (same origin as your workspace). -->
<script>
  (function () {
    var s = document.createElement("script");
    s.src = "https://YOUR_PERKLY_ORIGIN/widget.js";
    s.setAttribute("data-workspace", "YOUR_WORKSPACE_SLUG");
    s.async = true;
    document.head.appendChild(s);
  })();
</script>
Alternative (static tag)
<!-- Alternative: single script tag -->
<script
  src="https://YOUR_PERKLY_ORIGIN/widget.js"
  data-workspace="YOUR_WORKSPACE_SLUG"
  async
></script>

JavaScript API (advanced)

After the widget loads, window.PerklyWidget exposes helpers such as close, showLogin, showSignup, logout, viewRewards, and viewTiers for custom flows (e.g. opening the panel from your own buttons).

The interactive Widget demo page lets you change workspace and email and copy a full snippet. The demo store shows the widget in a storefront context.

Future-Proof Loyalty

Engineered for modern commerce—embed the widget, POST order webhooks to credit points per dollar, and run the program from one place.

NEW

AI Sales Suggestions

Intelligent recommendations that drive revenue. Add-ons, best-value redemptions, missions, and personalized drops.

Smart Tiers

Dynamic tier progression based on spend, visits, or custom actions.

Instant Rewards

Real-time reward distribution via email, SMS, or in-app notifications.

Precision Targeting

AI-driven segments to deliver the right perk to the right customer.

AI-Powered Revenue Engine

Drive Revenue with AI Suggestions

Automatically surface the right offers at the right time. Increase AOV, reduce point hoarding, and boost engagement with intelligent recommendations.

Add-On Suggestions

Raise AOV by suggesting items to unlock free delivery or bonus points

+15% AOV

Best-Value Redemptions

Reduce point hoarding by highlighting high-value reward opportunities

40% more redemptions

Mission Suggestions

Increase frequency with personalized challenges and tier progression goals

+25% frequency

Drop Matching

Boost excitement by matching new drops to past purchase patterns

3x engagement

Analytics Dashboard

Track revenue influenced, conversion rates, and top-performing suggestion types

Full Attribution

See exactly which suggestions led to purchases with click and view attribution

Performance Insights

Understand what works for each tier, segment, and send window

Data-Driven
Growth

Stop guessing. Start growing. perkly provides the analytics you need to understand customer behavior, AI suggestion performance, and ROI.

AI-powered suggestion engine
Real-time engagement tracking
Automated retention campaigns
Revenue attribution & analytics
Customizable reward logic
API-first architecture
10K+
Active Users
40%
Retention Lift
2M+
Rewards Sent
99.9%
Uptime
For merchants

Rewards & coupon codes

How Perkly issues codes, how that differs from checkout webhooks, and what you still configure in your store.

  • Earning points vs redeeming. The checkout webhook awards points from completed orders (per your points-per-dollar setting). It does not create discounts or reward claims. Customers redeem in the embedded widget when you offer redeemable rewards; automatic reward types follow the rules you set in admin.
  • Generated codes. When a reward uses generated coupons, each successful redemption gets a unique code on that claim. Another shopper gets a different code.
  • Static codes. When you set a single store discount string on a reward, every claim can show the same code. Treat it like any shared promo: set usage limits in Shopify, WooCommerce, or your platform (e.g. once per customer, capped redemptions).
  • Single-use at checkout. Whether a code can only be applied once at checkout is enforced by your store's discount settings, not by hiding the code in the widget. Configure discount rules to match how you want the offer to behave.
  • Deeper options (for example, creating native single-use discounts via your platform's API) are possible as integrations evolve; today, rely on unique generated codes plus your store's discount settings.
Operations & trust

Statistics, exports & customer data

perkly is built so your team can measure what matters, move data when you need it, and stay clear on who is responsible for end-customer privacy—whether you integrate via API or use the admin.

Statistics

  • Workspace-level metrics for members, engagement, redemptions, and program health—so you can tune rewards and AI suggestions with evidence.
  • Reporting views that help attribute outcomes to campaigns, tiers, and suggestion types instead of guessing from raw event noise.
  • Checkout webhooks award points when orders complete (configurable points per dollar), so balances stay current without manual imports—then customers redeem in the widget or you use automatic reward types for things like welcome credit.
  • Designed to complement your stack: use the dashboard for operators and APIs or webhooks where you already run analytics.

Exports

  • Export tabular reports for finance, ops, and partners—CSV-friendly outputs you can drop into spreadsheets or your warehouse.
  • Use exports for reconciliation, month-end close, and sharing snapshots with stakeholders who do not log into the admin.
  • Pair exports with API access when you need automated pipelines, scheduled jobs, or custom transformations on your side.

User privacy & data

  • Your customers are your customers: merchants typically act as the data controller for shopper data; perkly processes it to deliver loyalty, rewards, and integrations you configure.
  • We treat security seriously—access controls, encryption in transit, and sensible defaults so only authorized workspace users reach program data.
  • Honor privacy choices and regional requirements in coordination with your policies. See our Privacy Policy for details on processing, and use your workflows for end-user requests.

Ready to Launch?

Join the future of customer loyalty. Setup takes less than 5 minutes.

Admin Login

Works with

WooCommerce logo
WooCommerce
Dutchie logo
Dutchie
Shopify logo
Shopify
BigCommerce logo
BigCommerce
Stripe logo
Stripe
Square logo
Square

Connect your store with a checkout webhook so every paid order adds points automatically; use the widget and admin APIs for redemption, tiers, and AI suggestions on top.