Background
Wallet Pass allows your customers to add a digital loyalty card to their Apple Wallet or Google Wallet. The pass displays their loyalty information and updates dynamically as they earn and redeem points.
How to Enable Wallet Pass
Wallet Pass is available for all marketing plans and is enabled as follows:
Go to Settings > Wallet Pass.
Click on the toggle that says Membership Wallet Pass.
Click Save Settings.
⚠️ Warning: Wallet Pass branding is not set up by default. Users are strongly recommended to configure branding before advertising or sharing any wallet pass links.
How to Upload Logos
To upload a logo, choose Select Image.
When your native file picker opens, select the logo and click Open.
To remove an image, select Remove Image.
How to Create a Wallet Pass Campaign
For steps on creating and sending Wallet Pass campaigns, see Wallet Pass.
Wallet Pass Download Buttons
To increase downloads of Wallet Pass, AIQ allows users to include wallet pass download buttons in a variety of places:
Mobile App
Signup forms (thank you page)
Ecommerce Menus (if using AIQ ecom)
Custom Embed
Mobile App buttons will dynamically show based on a user's OS (Apple or Android), but others will require a manual selection of both or one.
How to Show Download Buttons for Wallet Pass
Go to Settings > Wallet Pass.
Click on the Display Settings tab.
Turn on the toggles for the wallet pass download buttons you'd like to show.
For signup form download buttons, these are located in the dedicated builder:
Go to Customers > Signup Forms and create or edit a signup form.
Fill in the required fields for the Fields step and continue through steps until you reach the Extra step.
Click on the toggle that says Show Wallet Pass download button in the popup.
To enable the signup form download button toggle, the Membership Wallet Pass toggle at the top of Wallet Pass Settings must also be turned on.
ℹ️ Note: You can also use content blocks and macros to send download buttons via other marketing channel campaigns, such as email. Learn how to do so in Wallet Pass.
How to Embed Your Wallet Pass Download Elsewhere
AIQ offers a custom embed option for wallet pass. To set this up:
Upload the images to your website's image directory.
Create a new backend endpoint that calls our API (see our API documentation).
Add the HTML code to your site:
<!-- apple.png is from https://developer.apple.com/wallet/resources/ -->
<a download href="https://lab.alpineiq.com/.../getApplePass/...">
<img alt="Add to Apple Wallet" src="apple.png"/>
</a>
<!-- google.png is from https://developers.google.com/wallet/generic/resources/brand-guidelines -->
<a href="https://lab.alpineiq.com/.../getGooglePass/...">
<img alt="Add to Google Wallet" src="google.png"/>
</a>
Images
Icon: The image displayed in notifications on the lock screen.
Logo: The image displayed in the top left of the wallet pass.
Cover Photo: The banner image that shows below the brand name and logo.
ℹ️ Note: Google Wallet Pass does not have a separate option for Icons. Users will have to separately upload images for Apple and Google Wallet Pass.
Colors
Background Color: Controls the overall color scheme of the wallet pass.
Foreground Color: Determines the color of user-inputted text in fields. This is an Apple-only field.
Label Color: Determines the color of the rest of the text on the wallet pass, outside of user-submitted fields.
Text Color: Google uses Text Color to cover both Label Color and Foreground Color.
Change Brand Colors
To change brand colors, manually enter the hex code in the appropriate field.
Alternatively, click on the color swatch to open the color picker. Select the appropriate color and click anywhere outside the picker to close.
Text
Text fields will pull from Wallet Pass Settings if there are dedicated settings, otherwise pulling from other settings fields with the following already populated:
Organization Name
Logo Text: The text that appears to the right of your logo. Available for Apple Wallet Pass only.
Description: Used with VoiceOver (Apple) and TalkBack (Google) to make your pass accessible to blind and low-vision users. Keep description short and clear.
FAQs
How long do I have to wait to use Wallet Pass after turning it on?
No time at all. There is no approval period — you can start using macros and campaigns for Wallet Pass immediately after turning it on.
Do I have to change settings separately for both Apple and Google?
Yes. Settings for one wallet do not carry over to the other, so users must manually configure settings for Apple and Google separately.
Can I turn off Wallet Pass?
Not for end users. You can turn off the toggle, but existing users would keep their wallet pass. Turning off the toggle would also pause points updates for users. Before turning off Wallet Pass, AIQ recommends sending a campaign to users suggesting they remove the pass themselves to reduce confusion.
Can I delete a Wallet Pass from a customer's phone?
While customers can delete or uninstall a Wallet Pass on their own, AIQ does not have a way of uninstalling it for them or forcing them to uninstall.
Why didn't the wallet pass update when I changed the icon?
Apple caches images for efficiency and performance. Sometimes you need to force a cache refresh. Ways to do this include restarting the phone, force-quitting and reopening the Wallet app, or updating iOS.
How can I hide the logo text?
When the logo text field is blank, AIQ defaults to including the brand name to ensure there is always a value for the pass. To intentionally show a blank space for the logo text, simply include a space in the field ().
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.