Displaying Apple Wallet Passes in Your iOS App

For a portion of your users, you may find it useful to let them access their wallet pass without ever leaving your app. With Apple Wallet passes, you can store “pass files” are stored on the customer’s disk as a zipped package with a .pkpass file extension and then retrieve them with your app.

You can find more information on the pkpass file type in Apple's developer documentation.

Using User Agents

A User Agent is an industry standard identifier, when used in an HTTP request, helps the application receiving the request understand more about the requester. In the webspace, the User Agent may identify which web browser an end user is using to view a webpage. Read more about user agents here.

In the app space, the User Agent in the HTTP request helps to carry information about the app being used.

When trying to display a pkpass file within your app, you must have your User Agent match this regex when hitting the Vibes SmartLink:

User Agent Details

/CFNetwork.+Darwin/

An example user agent that would be detected by the regex above:

Example User Agent

AppName/1.6 CFNetwork/485.13.9 Darwin/11.0.0

Inserting a .pkpass Into Your App

Every app is different, so you will need to test and fine tune to deliver your desired user experience. For more information on interacting with passes from within your app, please refer to Apple’s guidelines. Apple strongly recommends that passes be functional with or without your app, and that you update the passes/inspect pass details via an API call. For Vibes passes, you would use the Wallet Manager Campaign API.

For more help, please contact your Customer Success representative.