Documentation

How your customers participate

How your customers sign up, earn and redeem in Xtarly — varying based on the channel your plan offers.

Your customers participate in your loyalty program through one of three channels, depending on your plan. This section describes each experience and when it applies.

The three customer channels

ChannelPlans that offer itWhat the customer downloads
Wallet cardWallet, Shared, Branded, PremiumNothing — they add a pass to Apple Wallet or Google Wallet (pre-installed apps).
Shared marketplace appSharedThe "Xtarly Rewards" app from App Store / Play Store.
Dedicated appBranded, PremiumYour own branded app from App Store / Play Store.

Customers on plans with a mobile app can also use the wallet card — they are complementary channels, not exclusive. The customer chooses which one they prefer.

Channel 1 — Wallet Card (Apple/Google Wallet)

Applies to every paid plan. It's the only channel on the Wallet plan and optional on the rest.

How the customer enrolls

The customer scans your Enrollment QR or opens your public link.
Lands on your Enrollment Page and fills out the form.
Taps Add to Apple Wallet or Add to Google Wallet (based on their phone).
The pass saves to their wallet, ready to show at checkout.

How they identify themselves at checkout

  1. Open Apple Wallet or Google Wallet.
  2. Tap your business card — shows a QR code.
  3. The cashier scans it with Xtarly Cashier.

The card updates automatically with the new balance after each transaction. For design details, see Wallet Card Design.

Where they check their rewards and coupons

Every card carries a personal link to the My card portal: there the customer sees their balance, which rewards they can redeem, their live coupons, your menu and your locations — with nothing to install and no account to create.

Channel 2 — Xtarly Rewards marketplace app (Shared plan)

Customers download the Xtarly Rewards marketplace app, a multi-brand app where many businesses coexist. Your program lives inside the app alongside other brands.

How the customer enrolls

The customer downloads Xtarly Rewards from App Store / Google Play.
Creates their account or signs in (email + password, Google or Apple).
Scans your Enrollment QR or searches for your business in the app.
Joins your program with one tap.

How they identify themselves at checkout

They open the app, tap your business, show the personal QR. The cashier scans it with Xtarly Cashier.

You need a logo and a cover image to appear in the app

The app is a directory of brands: your business shows up with its logo and its cover image, and both are required to be listed. If either is missing, your program keeps working normally (QR, wallet card, register) but your business isn't listed in the directory until you upload them, so no card ever looks half-finished.

In the directory, each business card says what it has active: “4 rewards”, “1 coupon” or “4 rewards and 1 coupon”. Only what is above zero is mentioned. Birthday coupons and coupons for chosen customers are not counted, because they are not for everyone.

If your account goes on pause

When a subscription falls behind, your business shows in the app with a Paused badge: your customers see their saved balance and a message explaining they can't earn or redeem there for now — their stamps and points are still on their account, nothing is lost.

On that screen they get a button, “I want them back”. When they tap it:

  • We email you — on the first customer who asks, and again when it reaches five — with the link to reactivate your account.
  • They see how many other customers already asked.
  • When you reactivate, they get a notification that you're back.

Channel 3 — Dedicated app (Branded and Premium plans)

Customers download your own app with your brand. The Xtarly brand is nowhere to be seen.

How the customer enrolls

The customer downloads your app from App Store / Google Play (you share the link, or it appears after scanning your Enrollment QR).
Creates their account or signs in.
Is automatically enrolled in your program (it's the only brand living in that app).

How they identify themselves at checkout

Open your app, tap the personal QR on screen. The cashier scans it with Xtarly Cashier.

Mobile app features

The following pages (Home Screen, QR Code, Rewards, History, Profile) describe the mobile app features in detail.

These pages apply only to plans that include a mobile app — Shared, Branded or Premium. If you're on the Wallet plan, the customer experience lives in Apple/Google Wallet — see Wallet Card Design.