This feature is available in private preview mode and accessible only on selected workspaces. To get access, contact your account manager or Synerise Support.
## Generating a link to a wallet pass
To let a customer add a published pass to their Apple Wallet or Google Wallet, generate a link to it in one of the following ways:
- **In the wallet pass builder** - generate a generic link with no customer context, or use **Send to phone** to generate a personalized link for a specific customer. See [Sending the link to customers](#sending-the-link-to-customers) below.
- **With the `walletpasslink`/`walletpasslinkvar` Jinjava inserts** - if you're sending the link from an email, SMS, or push campaign, generate a personalized link directly in the message template. See [Wallet pass Jinjava inserts](/docs/campaign/wallet-passes/wallet-passes-jinjava-inserts#generating-a-personalized-link-to-applegoogle-wallet).
- **By calling the API directly** - request a link, optionally passing the customer's UUID, any parameters you want passed back in the [`walletPass.issued`](/docs/assets/events/event-reference/wallet-passes#walletpassissued) and [`walletPass.installed`](/docs/assets/events/event-reference/wallet-passes#walletpassinstalled) events, and an expiration date for the link. For the full request and response reference, [see the API reference](https://hub.synerise.com/api-reference/loyalty-and-engagement#tag/Wallet-passes/operation/createIssueLinkUsingPOST).
The returned link is permanent - you can embed it in customer communication or encode it as a QR code for the customer to scan. If you didn't provide a customer UUID when requesting the link, you can add one later by appending `&clientUuid=` to the returned URL; the pass is then generated for that specific customer.
## Anonymous vs. identified links
- If you generate the link without a customer UUID, it's a generic, anonymous link. When someone scans or opens it, Synerise creates a new anonymous profile for them, and all further events for that pass ([`walletPass.installed`](/docs/assets/events/event-reference/wallet-passes#walletpassinstalled), [`walletPass.updated`](/docs/assets/events/event-reference/wallet-passes#walletpassupdated), and so on) are attached to that new profile.
- If you generate the link with a specific customer's UUID - for example, for a customer you've already recognized - the pass is generated in that customer's context, so any dynamic field driven by their profile data (such as a points or cashback balance) renders with their actual values.
Referencing profile data in a dynamic field, for example `{{ customer.first_name }}`, never fails - Synerise always has a profile to render the pass against, since it creates the anonymous profile before generating the pass. On an anonymous link, though, that profile is brand new and has no attributes or activity history yet, so such fields typically render empty. We recommend always wrapping such fields in an `{% if %}` check with a fallback value for when the attribute is empty, rather than relying only on a [`default` filter](/developers/inserts/filter#default). On an identified link, the same field resolves to that customer's real data.
## Sending the link to customers
You can share the link with customers in several ways, for example:
- Embed it in a message sent through any communication channel - for example, email, SMS, WhatsApp, push notification, in-app message, dynamic content, or a landing page.
- Encode it as a QR code and print it at a physical point of sale - for example, on a receipt or a checkout display - for customers to scan in-store.
In the wallet pass builder, next to the generated link, use **Send to phone** to generate the link for a specific customer. You can then copy the link or scan its QR code yourself to test it, then distribute it to that customer through any of the channels above.