Apple Wallet pass configuration for iOS

Configure your Pass Type ID signing certificate so Pushwoosh can sign and update Apple Wallet passes (.pkpass) for your app. This is a one-time setup. Once a valid certificate is in place, the Apple Wallet pass builder unlocks for the application.

Create the certificate

Important

The certificate is stored per application. Configure it for each application that issues passes.

1. Register a Pass Type ID. In the Apple Developer Portal, go to Certificates, Identifiers & Profiles → Identifiers, click +, select Pass Type IDs, and enter a reverse-DNS identifier such as pass.com.yourcompany.passtype.

2. Generate a certificate signing request (CSR) in Keychain Access. You will upload this file in the next step.

3. Create the certificate. Open your Pass Type ID in the Apple Developer Portal and click Create Certificate. Select Pass Type ID Certificate, upload your CSR file, and download the resulting .cer file. Double-click it to add it to Keychain Access. See Create a certificate in Apple documentation.

4. Export the certificate as .p12 from Keychain Access. In the My Certificates section, find your Pass Type ID certificate, right-click it, and select Export. Choose .p12 format and set an export password. You need this file and password in Pushwoosh.

Configure the certificate in the Control Panel

1. Go to Settings → Configure platforms in the Control Panel.
2. Under MOBILE PLATFORMS, find iOS and click SET UP PASSKIT.

3. Click the attachment icon next to PASS TYPE ID CERTIFICATE FILE (.P12) and select your .p12 file.
4. In PRIVATE KEY PASSWORD, enter the password you set when you exported the .p12 file from Keychain Access.
5. Click Configure.

Keep the certificate current

Pass Type ID certificates expire (Apple issues them with a limited validity period). When a certificate is close to expiry, renew it in your Apple Developer account, export a new .p12, and upload it again on Configure platforms → SET UP PASSKIT.

If the configured certificate has expired, Pushwoosh can no longer sign passes. Creating and updating passes will fail until you upload a current certificate. Replace it before it lapses to avoid interrupting live passes.