Glossary
Plain English definitions of every term you'll meet in Leal, from stamps and rewards to pass updates, agencies and custom domains.
The words Leal uses, in one place. Each term has its own heading, so you can link straight to it, for example /getting-started/glossary#customer-card.
Your store and team#
Store#
Your business in Leal. A store has its own name, logo, locations, team, customers, cards and plan. In some parts of the app (such as the Accounts page and the delete button) a store is called an "account" or "store/account". It's the same thing. See Store.
Account name#
The name your store was created with at sign up. It's shown to you and your team, for example on the Team members page and in the store switcher. Customers see the store name instead, if you've set one.
Store name#
The public name of your store. Customers see it on signup pages, in Apple Wallet and on unsubscribe pages. If you leave it empty, Leal uses the account name. See Store details.
Account ID#
The number shown next to your store name on the Store page. Tools like Zapier and Make ask for it, together with an API token, when you connect them.
Location#
A physical address where you serve customers. Leal adds your locations to wallet passes so phones can show the card when a customer is nearby, and uses them for location-based notifications. See Locations.
Geofence#
The area around a location that counts as "nearby". Leal uses a 100 metre area around each location's map pin.
Apple Maps place#
The listing for your business on Apple Maps, linked to a location. It lets Apple Wallet passes offer a Go to Location button that opens your shop in Maps.
Team member#
Anyone who can sign in to your store. Each team member has their own login. See Team members.
Owner#
The person who owns the store. There's one owner. The owner is always an admin, can't be removed from the team, and is the only person who can transfer ownership to someone else.
Admin#
A team member role with full control: billing, inviting and removing people, changing roles, renaming or deleting the store, and sending campaigns. In the mobile app, only admins can correct stamp balances or edit customers.
Member#
A team member without the admin role. Members use the store day to day: scanning, adding stamps, redeeming rewards and working with cards, posters and customers.
Invitation#
An email that asks someone to join your store's team. It stays pending until they accept it, and you can resend it, copy its link or cancel it.
Plan#
What your store pays for: Free or Pro. Free covers one card, one poster, one location and one reward per card. Pro removes those limits and adds features such as analytics, campaigns and a custom domain. See Billing and plans.
Cards and stamps#
Card#
The template for your loyalty stamp card: its design, stamp icon and how many stamps fill it. Also called a loyalty card. See Cards.
Stamp#
One unit of progress on a customer's card. Staff usually add one stamp per visit or purchase. Stamps can also come from welcome stamps, a connected point of sale, the API or referrals.
Stamps required#
How many stamps fill a card, from 1 to 21. See Stamps required and initial stamps.
Initial stamps#
Welcome stamps a customer gets the moment they join, to give them a head start.
Customer card#
One customer's own copy of a card, with their own stamp count. It's what goes into their wallet as a pass. A customer can hold one customer card for each of your cards.
Card code#
The short code that identifies a customer card. It's inside the QR code on the pass and printed under it, so staff can type it in if the camera won't read the screen.
Archived card#
A card you've retired. It stops taking new sign ups and its posters are switched off. You choose whether passes customers already have keep working or expire. An expired pass is marked as no longer valid in the customer's wallet. See Archiving a card.
Reward#
Something a customer can claim for a number of stamps, such as "Free coffee" for 9 stamps. Rewards belong to a card, and a card can have several on Pro. See Rewards.
Redemption#
The record of a customer claiming a reward. Redeeming takes the reward's stamps off their card and notes who processed it and when.
Stamp ledger#
The history of every change to a customer's stamps, shown as the stamp history on a customer's profile. Each entry shows how many stamps were added or removed and the balance afterwards, and has one of these types:
| Type | Meaning |
|---|---|
initial |
Welcome stamps on a new card |
scan |
A staff member scanned the card in store |
redeem |
Stamps spent on a reward |
adjust |
A manual correction, or stamps taken back for a refund at your point of sale |
api |
Added through the API, a point of sale or an automation |
referral |
A referral bonus, for inviting a friend or joining with a friend's invite |
Scan#
Reading a customer's pass QR code with the Leal app, to add stamps or redeem a reward. See Scanning.
Manual adjustment#
Setting a customer card's stamp count by hand from the customer's profile, for example to fix a mistake. It shows in the stamp ledger as an adjust entry. See Correcting stamps.
Skip notifications#
An option on a manual adjustment that updates the pass quietly, without running your notification rules. It's ticked by default.
Wallet passes#
Wallet pass#
The digital card in a customer's Apple Wallet or Google Wallet. It shows your design, their stamps and a QR code for staff to scan. Customers don't need to install an app to use it.
Pass update#
When Leal refreshes a pass that's already on a customer's phone, for example after a stamp is added or you change the card design. An update can carry a short message, which shows as a notification on the customer's lock screen.
Featured actions#
Apple's name for the buttons under an Apple Wallet pass on newer iPhones, such as Go to Location or a link to order online. You set them up under Buttons on the card's Details tab, and Google Wallet shows the same ones as links. See Buttons.
Hero image#
The large, nearly square picture on a Google Wallet pass, where the customer's stamps are drawn. It uses the image you upload on the card's Google Wallet tab, or your stamp strip background if you haven't uploaded one.
Square icon#
A square version of your logo. Apple Wallet uses it as the pass icon and Google Wallet as the logo. If you don't upload one, Leal uses your main logo.
Stamp strip#
The background band behind the stamps on an Apple Wallet store card and a Google Wallet pass.
Store card and Poster layouts#
The two Apple Wallet layouts. The store card is the classic pass. Poster is full bleed artwork on iOS 27, and iPhones on iOS 26 or earlier show the store card instead. See Apple Wallet passes.
Getting customers#
Customer#
A person who has joined your loyalty programme. Every customer has at least a first name and an email address or phone number. Each email and phone number can only belong to one customer in your store. See Customers.
Poster#
A printable sheet with a QR code that opens a signup page for one of your cards. A poster can be active (taking sign ups) or inactive (its QR code stops working, but the poster isn't deleted). See Posters.
Signup page#
The web page a customer sees after scanning a poster. They enter their details, tap Sign up and add the card to their wallet. Its address is the poster's signup link, which you can also share online.
Display#
A full screen version of a poster for a tablet, kiosk or TV, with its own link. See Digital displays.
Referral#
When a customer invites a friend with their personal link. The friend's bonus is pending until your team first adds stamps to the friend's card for a real visit. Then both customers get the bonus stamps the card offers. See Referrals.
This is different from Referrals in your own account menu, which is Leal's programme for recommending Leal to other business owners.
Unsubscribe#
A customer opting out of your marketing messages. It doesn't affect their card or stamps, and Leal leaves them out of every campaign automatically.
Marketing status#
Whether a customer receives campaigns: Subscribed or Unsubscribed. Only the customer can change it.
External ID#
A customer's ID in another system, such as Square, stored with the name of that system. Imports, Zaps and API calls use it to match the right customer.
Referral link#
A customer's personal invite link. Friends who sign up through it are linked to that customer as their referrer.
Referrer and friend#
The referrer is the customer who sends the invite. The friend is the new customer who joins through it.
Qualifying visit#
The first stamp added to the friend's card by a scan or through the API (including a point of sale). It turns a pending referral into a rewarded one, and both customers get their bonus.
Messages#
Notification rule#
An automatic message sent to customers through their wallet pass when something happens. There are three kinds: System (when a stamp is earned or a reward is redeemed), Location-based (when a customer is near one of your locations) and Automated (Pro triggers such as birthdays, stamp milestones and inactivity). See Notifications.
Campaign#
A message, or a short sequence of messages, sent to a group of customers by email, SMS or wallet push. A one-time campaign sends once. An always-live campaign keeps running and picks up customers as they start to match. Campaigns are a Pro feature. See Campaigns.
Send window#
The days and hours a campaign is allowed to send messages.
Sending domain#
The domain emails come from. Agencies can verify a sending domain so emails to their clients come from the agency's own address. For campaigns, a store can send from its own domain by connecting an email provider under Integrations.
Trigger#
The event that sends a notification, such as a stamp being earned, a birthday or a set number of days without a visit. See Notification triggers.
System notifications#
The two built in rules every store has: Stamp earned and Stamp redeemed. You can edit or switch them off, but not delete them. Keep them on, because they are also what refreshes a customer's pass after a scan.
Location-based notification#
A message stored inside an Apple Wallet pass that the iPhone shows on the lock screen when the customer is near one of your locations. See Location-based notifications.
Latest update#
The field on a pass that holds the most recent notification message. Changing it is what makes the phone show a notification.
One-time campaign#
A campaign that sends once, to everyone who matches its audience at the time it's sent.
Always-live campaign#
A campaign that stays on and enrols customers as they start to match its audience, until you pause it.
Re-enrol after#
The number of days before an always-live campaign can take the same customer through it again.
Audience#
The filters that decide who a campaign reaches. Unsubscribed customers are always left out. See Choosing an audience.
Step#
One message on one channel in a campaign, with its own timing. A campaign can have several steps.
Wallet push#
A campaign step that sends its message to the customer's installed wallet pass.
Built-in sender#
Leal's own email sending for campaigns. Emails come from an address on campaigns.getleal.com with your From name and reply-to address. See Sender settings.
Recipe#
A ready-made campaign, such as a welcome or win-back series, created as a draft for you to edit.
SMS segment#
The unit SMS providers charge by: 160 standard characters, or 70 if the message uses characters outside the standard set, such as emoji.
Analytics#
Signup rate#
Signups as a percentage of signup page views. See Metrics and charts.
Install rate#
Wallet installs as a percentage of signups.
Returning customer#
On the dashboard, a customer who collected a stamp in the last 30 days and either joined before that period or collected stamps more than once in it.
Anomaly#
A single day that is unusually high or low compared with what Leal expected. See Forecasts and signals.
Breakout#
A point where a number shifts to a new level and stays there.
Domains, integrations and developers#
Custom domain#
Your own web address, such as loyalty.yourstore.com, used instead of Leal's for signup pages, wallet pass links and display screens. It's a Pro feature. See Custom domains.
Integration#
A connection between Leal and another service, such as your point of sale or an automation tool. You manage them under Integrations. See Integrations.
API token#
A secret key that lets another program use the Leal API on behalf of your store. Creating a new token needs Pro. Treat it like a password. See API tokens.
Webhook#
A message Leal sends to another system's web address when something happens in your store, such as a customer signing up or earning a stamp. Creating a new webhook needs Pro. See Webhooks.
Point of sale integration#
A connection to Square, Clover or Shopify that gives stamps automatically when a customer with a profile on the sale pays. See Point of sale integrations.
Stamps per purchase#
The fixed number of stamps, from 1 to 100, that each qualifying till payment or Shopify order gives, whatever the amount.
Minimum purchase#
The smallest sale that earns stamps. On Square it's measured before tip. On Shopify it's the subtotal after discounts and before tax and shipping.
Webhook endpoint#
The web address you add on the Webhooks page to receive events.
Signing secret#
A secret for each webhook endpoint. Leal uses it to sign every request so the receiving system can check it really came from Leal.
Automation trigger and action#
In Zapier, Make or Pabbly Connect, the trigger is the Leal event that starts an automation and the action is the step it then performs. See Automation.
MCP#
Model Context Protocol, the standard that lets AI assistants such as Claude or ChatGPT work with your Leal store. See AI agents.
Agencies#
Agency#
A business that runs Leal stores for its clients, such as a marketing agency. Agencies have their own dashboard, team and billing. See Agency.
Client store#
A store that an agency runs for a client, with its own cards, customers and settings. Sometimes called a client account. The agency's staff can manage it, and its Pro plan can be paid by the agency.
Client visibility#
Agency settings that hide some pages, such as Integrations or Webhooks, from the agency's clients.
White label#
Running Leal under an agency's own brand and domain, so clients and their customers see the agency rather than Leal.
Pro credit#
Part of an agency lifetime deal. Each credit gives one store Pro with no recurring charge. Using a credit on a store can't be undone.
Agency team#
An agency's own staff, with the role Owner, Admin or Member. Admins can open every client store. Members can open only the stores assigned to them. See Your agency team.
Sign-up approval#
A store created by signing up on an agency's custom domain stays on Free limits, and off the agency's bill, until an agency admin approves it. See Approving sign-ups.
Powered by Leal#
The small Leal credit on signup pages and wallet passes. Agencies can remove it.
Branded web app#
An installable web app with the agency's name, icon and colours, which clients use instead of the Leal iOS and Android apps. See The branded web app.
Email sending domain#
An agency's verified domain that account, invitation and customer emails come from. Campaign emails aren't included. See Email sending.
Move to Agency#
Cancels a store's own Pro subscription straight away and adds the store to the agency's bill.
Still stuck?
Our team answers every message. Contact support