Making Passes Available to Users

Adding passes to Wallet makes it easy for people to view and use them. If people choose not to add a pass to Wallet, you can ensure that the pass is available when it's needed by tagging it with descriptive information (see Displaying Passes).

Adding Passes to Wallet

Automatically add new passes to Wallet. Anytime a user action results in a new pass—like when checking into a flight, purchasing an event ticket, or registering for a store reward program—your app should immediately ask for permission to add the pass to Wallet. Generally, this should occur when the user reaches a confirmation page, and without the user needing to click an Add to Wallet button.

Suggest adding passes that were created outside of your app. After a user creates a pass using your website or another device, suggest adding it to Wallet the next time the user opens your app. If the user declines to add the pass, don’t ask them again.

Add related passes to Wallet as a group. If your app generates multiple passes, such as boarding passes for a multi-connection flight, add all passes at the same time so the user doesn’t need to add each one individually.

Make it easy for people to quickly add passes that aren’t already in Wallet. A pass may not exist in Wallet if the user previously declined to add it, if they removed it from Wallet, or if they generated the pass outside of your app—such as on your website. When a pass doesn’t exist in Wallet, display an Add to Wallet button wherever the corresponding pass information appears in your app. This button should be discoverable with minimal navigation. For developer guidance, see addPasses(_:withCompletionHandler:).

Let people jump to their passes in Wallet. When a pass exists in Wallet, display a link to View in Wallet wherever the corresponding information appears in your app.

Displaying Passes

Enable passes to appear in the appropriate context. Whenever possible, passes should automatically appear so people don’t need to manually locate them. When you tag a pass with date, time, and location information—it’s best to provide all three—the system automatically displays the pass when the user needs it, like the moment of purchase or when checking into an event.