Apple Wallet
Apple Wallet lets users save passes like boarding passes, event tickets, and coupons from a website straight to their iPhone’s Wallet app. Once saved to Apple Wallet, users can access their cards anytime directly from their iPhone without opening multiple apps or searching through emails.
The add-on is available for iOS apps. This add-on will only work once you have purchased the app.
Benefits of Using Apple Wallet
Save in One Tap
Users save a card to their wallet with a single tap without any additional steps or apps.
Easier to Access
Once saved, the cards stay inside the user’s wallet app. Making it easier for them to find it anytime, even without opening the app again.
Faster Update
If something changes, like a loyalty card or ticket status, the saved card will be updated. So the user always sees the latest details.
Feels Like Part of the Phone
As Apple’s Wallet app opens, it feels like a natural part of the iPhone instead of something extra.
How the Pass Gets Ready Behind the Scenes
Before this add-on works perfectly, you need to set a few things on Apple’s side. Here’s a short process, you must know what’s happening.
-
Register an ID in the Apple Developer portal for each kind of pass, including loyalty cards or event tickets.
-
You will get a certificate from Apple that proves the pass is actually coming from your business.
-
You must design what the pass looks like, including the colors, logo, and barcode, including what fields it shows, such as seat number or points balance.
-
You fill in that design with each user’s own details. So, every user gets their own copy.
-
You have to sign in using the certificate that locks the pass and turns it into the final file. So, Apple Wallet can trust that it’s genuine.
-
You have to host that file somewhere you can reach, which is what this add-on uses to open Apple’s save screen for the user.
If any of these steps are skipped, the save screen either does not open at all or shows an error instead of adding the pass.
Before you begin, ensure that you already have an Apple Developer account, a Pass Type ID certificate, and pkpass files that are created and signed correctly. This add-on only handles the saving part inside your app. It cannot work until that setup is complete on Apple’s side.
Where to Find It in Your Dashboard
My Apps ➡️ Edit your app ➡️ Add-ons ➡️ Wallet ➡️ iOS
Steps to Set Up Apple Wallet in Your iOS App
Enable Apple Wallet
Turn the Apple Wallet toggle ON from your dashboard to activate the add-on inside your iOS app.
Automatically Add Pass Links Opened On Your Website
Turn this toggle ON to have pass links open and save automatically. Whenever a user opens a pkpass link inside your iOS app. It gets added to their Apple Wallet without any additional steps or manual setup.
Leave this toggle OFF if you want to trigger the save action yourself. For example, using your own Add to Apple Wallet button. In that case, you will need to call the function manually.
You can read our developer documentation by clicking here: Wallet Creating Passes iOS (opens in a new tab).
Enter Pass Type IDs
This is an ID that is set at the time of creating your Apple Wallet cards. You must add the pass type IDs in the field. So the app knows which cards belong to you.
If you have more than one type of card, like a loyalty card, gift card, event, or ticket, click on the +Add more button to add multiple pass type IDs.
Remove Pass Type ID
If you want to remove any of the pass type IDs, you have to simply click on the shown icon.
Save
Click on Save to apply changes, and the app rebuilds with Apple Wallet turned on.
If you require the technical knowledge about Apple Wallet functions, you can read our developer documentation here - Apple Wallet Functions (opens in a new tab)
Functions for Apple Wallet
You can use the following functions in code to control how Apple Wallet behaves inside your app.
isSupported checks whether the user's device has Apple Wallet available. Your team can use this before showing an Add to Wallet button, so it does not appear on a device that cannot use it.
addPasses saves one or more passes to the user's Apple Wallet. This is the main function behind this add-on and is used whenever a loyalty card, ticket, or coupon needs to be added.
getPasses returns the passes a user has already saved in their Apple Wallet. Your team can use this when the app needs to know what the user is already carrying, without asking them again.
checkPassExists checks if a specific pass is already saved in the user's wallet. This helps avoid the same pass getting added twice by mistake.
removePass removes an already saved pass from the user's Apple Wallet. This is useful when a coupon expires or an event gets cancelled and the pass should no longer be there.
replacePass replaces an already saved pass with an updated version. This is what your team would use for something like updating a loyalty card's points balance without asking the user to save it again.
Frequently Asked Questions
Q1. What if a card does not match any Pass Type IDs I have added?
A. It won’t work. You must ensure every Pass Type IDs to be added in the right field.
Q2. Why does saving a card fail even though everything looks right?
A. This usually means something was not set up correctly on the development side at the time of creating the card. Check the card set up double time to reduce these errors.
Q3. Does Webtonative create the card design for me?
A. No. You have to create and set up the card by yourself through Apple tools. Webtonative only ensures that it saves correctly to the user’s Apple Wallet app.
Q4. Can a card be updated after a user has already saved it?
A. Yes. If something updates in cards, you can send an updated version. It will automatically replace the older version of the card with an updated one in the user’s Apple Wallet.
Q5. Do I need to turn on “Automatically add pass links” if I already have my own Add to Apple Wallet button?
A. No. Keep it OFF and use the button instead. Turn it ON only if you want the save screen to open on its own when the user taps on the card link.