Overview

Paid only once Klaviyo shows their SMS consent as subscribed: with double opt-in on in Klaviyo (Settings → SMS), that means they replied Y to the confirmation text, so the number is real and theirs. Once per customer and once per phone number across all accounts (the number is stored only as a one-way hash). Customers tap "I've replied Y: check now" in the Rewards button; a Klaviyo flow on Subscribed to SMS marketing with a Webhook action (POST …/hooks/klaviyo/sms, body {"email": "{{ person.email }}"}) pays them without the tap. The Klaviyo private key needs Profiles read access. Like social points, these never unlock a starter reward on their own.

Each customer's share link is …/r/their-code. It sends the friend to stimz.com with their discount code already applied, and the order carries that code, which is how the referrer gets credited. The friend's code is created in Shopify the first time the link is used.

Products or Collections: only the matching items in an order earn the multiplier; the rest of the basket earns the normal rate ("double pointz on Spikz this weekend"). Items in the order or £ spent: the whole order earns it once it clears the threshold ("2+ items = double pointz", "spend £30, earn 3×"), and the Rewardz panel shows a progress bar against the bag. Starts and ends are UK times (the clocks changing is handled); an offer runs from its start up to its end. Whatever applies to an item, the biggest multiplier wins: offers, the stamp card's double and the starter reward's double are never multiplied together. A collection's product list is read from Shopify when you save and every few hours while the offer is on, so a product added to a smart collection is picked up; "Refresh product lists" does it now. The multiplier is applied when the order is paid, and a refund takes back what that item earned.

For members who join after this is switched on; never imported Rivo members, Stimfluencers or the holdout group. When an order of at least the unlock amount takes them to the first number of points, those points come off by themselves and become a one-use code locked to them (it shows under Ready to use and fires Starter reward in Klaviyo with the code), and, if that was their first order, their next paid order earns the bonus points. The second works the same way, once, on the next 500 points they collect (their first 300 are already spent, so it takes about £100 of shopping, or £50 on a double-points order). Then it is the normal rewards. While they shop, the points bar works out what the bag would unlock and updates as they add things ("Add £12.50 more to unlock £5 off your next order + double pointz"); put <div data-stz-nudge></div> in the bag drawer or cart page for the same line with a progress bar. The unlock amount is what stops welcome, social and birthday points alone from unlocking one: at £20, the first order is £20 with all four socials and £35 without. Referral points unlock one straight away, because they come from a friend's real order. If the order that unlocked a code is refunded before the code is used, and they would no longer have reached it, the code is switched off in Shopify and the points go back.

Every paid order at or over the minimum adds a stamp. The order that fills the card makes a one-use code for the voucher value, locked to that customer: it shows under Ready to use in the widget and on the rewards page, and fires Stamp card voucher in Klaviyo (with the code) so a flow can email it. A new card starts straight away. A cancelled or refunded order loses its stamp; a voucher already made is never taken back. Only orders placed after it is first switched on count.

When a card reaches the gift stamp, the customer gets a one-use code, locked to them and with no end date, for one free unit of the gift product with any order. If the product is out of stock at that moment, the code is £ off instead, so nobody is sent a code that cannot be used. It shows under Ready to use and fires Stamp card gift in Klaviyo. One gift per card; a refund that takes the card back below the gift stamp does not take the gift back.

{program} {per_pound} {signup} {referral} {birthday} {wait} (birthday wait days) {expiry} (a sentence about expiry, written for you).

Quiet mode always hides the points bar, review pop-ups, Clikz pop-ups and bag rescue, Klaviyo sign-up pop-ups and flyouts (except one the customer asked for), and the "add one of these" suggestions in the bag, and stops animation. It is saved on the device and, when signed in, on the account (stimz_quiet_mode in Klaviyo). The spend reminder fires Spend reminder reached in Klaviyo once per calendar month, on the order that takes a customer to or past the amount they chose.

Shopify no longer lets non-Plus shops run Google's opt-in on the thank-you page, so the order confirmation email links to stimz.com/apps/rewards/gcr, which shows Google's opt-in for that order. Paste this into Settings → Notifications → Order confirmation, where you want the link:

<p><a href="https://stimz.com/apps/rewards/gcr?o={{ id }}&e={{ email | url_encode }}">Help other people find us: get Google's short survey about this order</a></p>

At the Rivo import as much of every balance as makes whole £5s is cashed at Rivo's rate (500 = £5) into vouchers of the sizes above: 1,449 is £10 of vouchers, and the 449 left moves across as 225 pointz (half the number, an odd one rounded up: a pointz is now 2p, so the £ stays the same). Customers pick any mix in the Rewards button or on the rewards page: four £5s need four orders of £25, one £20 needs one order of £100. Every voucher is a one-use code locked to them, combining with product and shipping discounts but never another basket discount. Start the 30 days (after the import and the Points Logs file) sets everyone's pointz clock from their real last activity; anyone quiet for 6 months gets 30 days' notice ending on the deadline, and the "Points expiring soon" email (09) tells them, with their vouchers to pick. On the deadline, anyone who has not picked gets all £5s, unless their clock ended that day: then the vouchers go with their pointz. Picking counts as activity.

Customers who are new after this is switched on are put in one of two groups at random. The holdout group sees no points bar, no Rewards button and no points on product cards, and their Klaviyo profile carries stimz_holdout = true: add "stimz_holdout is not true" to every programme flow's profile filter. They still earn and keep every point and can open the rewards page, but get no starter rewards.