Key concepts
Understand the key concepts behind The Wallet Crew: tenant, pass template, pass, and environment.
The Wallet Crew is built around a small set of concepts that appear throughout the platform. Understanding them once makes every other page faster to navigate.
Payment cards such as Apple Pay and Google Pay are out of scope here. The Wallet Crew manages wallet passes such as loyalty cards, tickets, offers, and gift cards — not payment instruments.
Real-world examples
A retail Brand may run one tenant, one loyalty template, and millions of customer passes.
A ticketing Brand may use one ticket template per event family, then issue one pass per attendee.
An international group may keep one tenant per country when teams, credentials, and data must stay separate.
Tenant
A tenant is the isolated workspace for one Brand or wallet program inside The Wallet Crew. Everything configured there lives inside that tenant: wallet designs, passes, data, and team access.
A simple way to think about it is a private building, not a shared open space. What exists in one tenant does not mix with another tenant.
Most Brands have one tenant. Some groups run several tenants when separate brands, countries, or programs must stay independent, with their own Apple and Google credentials, their own data, and their own teams.
A tenant is not a folder or a sub-account inside a shared workspace. Each tenant is a fully isolated environment. There is no cross-tenant data access by design.
Pass template
A pass template is the model for one kind of wallet pass. It defines which wallet platform is targeted, how the pass looks, which fields appear, which barcode format is used, and how personalisation works.
The easiest analogy is a blueprint. The template defines the rules once, then The Wallet Crew reuses those rules every time a new pass is created from it.
A template is not a pass. It does not belong to one customer. It is the reusable definition behind many passes.
One Brand can use several templates at the same time. A loyalty card, a gift card, and an event ticket each usually need their own template.
Pass
A pass is one wallet card, ticket, or voucher issued to one customer. It is created from a template and linked to Brand systems, such as a CRM, loyalty engine, POS, or ticketing platform.
If the template is the blueprint, the pass is the finished item in the customer’s wallet. One template can create thousands or millions of individual passes.
Passes move through a lifecycle:
Created — the pass exists on the platform.
Installed — the customer added it to Apple Wallet or Google Wallet.
Updated — the pass content changed, such as a points balance, status, or message.
Uninstalled — the customer removed it from the wallet.
Created and installed are two different moments. A pass can exist before a customer saves it to the wallet.
The Wallet Crew does not store customer personal data by default. Passes are usually linked through stable identifiers, such as a CRM ID or loyalty number, while core customer data stays in Brand systems.
Environment
Environments separate testing from live operations. In practice, The Wallet Crew provides QA for testing and production for real customers.
QA is the rehearsal stage. Production is the live stage. QA mirrors production closely so testing reflects real conditions before launch.
These environments are fully isolated. A pass created in QA never appears in production, and production credentials or live data are not shared into QA.
Configuration can be copied between environments when needed. A third environment, dev, exists for internal engineering use only and is not accessible to customers.
What comes next
To understand what the platform can track after issuance, see Monitoring.
To start configuring a first template, see Card design (colors, images, and fields).
For a deeper technical model, start with Structure and the Developers area.
FAQ
Can one template create many passes?
Yes. That is the normal model. A template is reused to issue many individual passes that share the same structure and design.
Mis à jour