# 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](https://docs.getleal.com/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](https://docs.getleal.com/store/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](https://docs.getleal.com/store/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](https://docs.getleal.com/store/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](https://docs.getleal.com/store/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](https://docs.getleal.com/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](https://docs.getleal.com/cards/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](https://docs.getleal.com/cards/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](https://docs.getleal.com/cards/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](https://docs.getleal.com/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](https://docs.getleal.com/scanning/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](https://docs.getleal.com/cards/card-details#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](https://docs.getleal.com/cards/wallet-passes/apple-wallet).

## 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](https://docs.getleal.com/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](https://docs.getleal.com/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](https://docs.getleal.com/posters/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](https://docs.getleal.com/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](https://docs.getleal.com/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](https://docs.getleal.com/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](https://docs.getleal.com/notifications/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](https://docs.getleal.com/notifications/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](https://docs.getleal.com/campaigns/audiences).

### 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](https://docs.getleal.com/campaigns/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](https://docs.getleal.com/analytics/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](https://docs.getleal.com/analytics/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](https://docs.getleal.com/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](https://docs.getleal.com/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](https://docs.getleal.com/integrations/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](https://docs.getleal.com/integrations/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](https://docs.getleal.com/integrations/point-of-sale).

### 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](https://docs.getleal.com/integrations/automation).

### MCP

Model Context Protocol, the standard that lets AI assistants such as Claude or ChatGPT work with your Leal store. See [AI agents](https://docs.getleal.com/integrations/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](https://docs.getleal.com/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](https://docs.getleal.com/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](https://docs.getleal.com/agency/clients/sign-up-approvals).

### 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](https://docs.getleal.com/agency/white-label/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](https://docs.getleal.com/agency/domains/email-sending).

### Move to Agency

Cancels a store's own Pro subscription straight away and adds the store to the agency's bill.
