Getting Started

SimplyClub is a loyalty platform that adds member benefits, points, and rewards to any online store — without rebuilding your storefront. The drop-in renders inside your existing site, your cart syncs to SimplyClub in real time, and after checkout a webhook finalizes the loyalty event so points and benefits land in the member's account.

This page is the map. Read it once and you'll know which of the other docs you need.

What you need before you start

1. A PoiId — your Point-of-Interest ID. Every install begins with it; nothing else will work without one.
2. The ability to add a <script> tag to your storefront — either through a Shopify app block, a WordPress plugin, your theme, or your custom site's HTML.
3. A backend (or platform integration) that can fire an HTTPS request to SimplyClub after each order is paid. On Shopify this is automatic if you install our app.

What's a PoiId?

A PoiId identifies your store inside SimplyClub. It's how the drop-in knows which loyalty program to load, which benefits to show, and which account to attribute purchases to. One PoiId per store.

You don't generate it yourself — it's issued by SimplyClub during onboarding. Contact SimplyClub support to get yours before you continue. None of the install paths below will work until you have it.

Pick your install path

If you maintain more than one storefront and want SimplyClub on all of them, run through the install once per store with each store's own PoiId.

How the pieces fit together

┌────────────────────┐      ┌──────────────────┐     ┌────────────────┐
│ Storefront (drop-in)│ ──▶ │ Cart attribute /  │ ──▶ │ Order webhook  │
│  user picks benefit│      │  order metadata   │     │   to SimplyClub │
└────────────────────┘      └──────────────────┘     └────────────────┘
        ▲                                                       │
        │              ─────  loyalty finalized  ─────          │
        └───────────────────────────────────────────────────────┘

1. The drop-in lives in your storefront. When a customer picks a benefit, it issues a transaction code (sc_transaction_code) and asks you to attach it to the cart.
2. Your storefront persists that code onto the order — on Shopify this happens via cart attributes; on other platforms you store it however you store cart state.
3. After checkout, an order webhook fires from your platform (or your backend) to SimplyClub's server. SimplyClub looks up the session by sc_transaction_code, applies the benefit, and accrues points.

The order webhook is what closes the loop. Skip it and customers will see benefits but nothing will be recorded.

After install — the second half

Installing the drop-in only handles the storefront. To finalize loyalty after checkout, you also need the order webhook:

The Shopify path uses topic-and-domain HTTP headers and Shopify's signed delivery; the generic path uses a flat JSON body with sc_transaction_code as the credential. Pick the one that matches your install.

Optional: embed the join CTA

If you want a lightweight call-to-action (e.g. "Join the club" inside your cart drawer) separate from the main drop-in, use the Membership CTA Web Component. It's a single custom element that drops into any page.

Recommended order of operations

1. Get your PoiId from SimplyClub support.
2. Follow the install guide for your platform.
3. Open your storefront and confirm the drop-in loads (modal opens, no console errors).
4. Wire the order webhook for your platform.
5. Place a test order end-to-end and confirm SimplyClub records the loyalty event.
6. (Optional) Add the Membership CTA Web Component in places where you want a focused join/upgrade prompt.

Need help?

If you get stuck at any step — most often the PoiId, a missing sc_transaction_code, or a webhook that isn't firing — contact SimplyClub support with your PoiId and the order ID you were testing.