Set up Apple Wallet certificates

Apple Wallet requires credentials that prove you can issue passes for your brand. Creating the certificate and its password is typically completed by a developer. You must upload a valid certificate before you can create pass links.

Create an Apple Pass Type ID certificate

After registering a Pass Type ID and creating the certificate in your Apple Developer account , you export it as a .p12 file using Keychain Access on a Mac. You can then add the .p12 and its password to your Airship wallet project.

If you already have a Pass Type ID, skip registering a new one and select the existing ID when creating the certificate.

Register a Pass Type ID

Register a Pass Type ID in your Apple Developer account:

1. Go to Certificates, Identifiers & Profiles.
2. Select Identifiers in the sidebar.
3. Select the add icon ().
4. Select Pass Type IDs from the list, and then Continue.
5. Enter a description and a unique identifier, and then select Continue.

   

6. Review the name and identifier, and then select Register.

Create the Pass Type ID certificate

Create the Pass Type ID certificate in your Apple Developer account:

1. Go to Certificates, Identifiers & Profiles.
2. Select Certificates in the sidebar.
3. Select the add icon ().
4. Under Services, select Pass Type ID Certificate, then Continue.
5. Select your Pass Type ID.
6. (Optional) Change the name of your certificate from the default.
7. Select Continue.
8. Follow Apple’s instructions to create a certificate signing request , then upload the .certSigningRequest file in the Developer console:
   1. Under Upload a Certificate Signing Request, select Choose.

      

   2. Select your .certSigningRequest file, then select Choose.
9. After completing the upload, select Continue.
10. Select Download to save your certificate as a .cer file.

Export the certificate as a .p12 file

Export the Pass Type ID certificate on your Mac:

1. Open your downloaded .cer file. It should open in the Keychain Access app.
2. Select My Certificates, then select your certificate from the list.
3. From the File menu, select Export Items….
   Note

   You must have My Certificates selected at export time. If another category is selected, the .p12 export fails because that view doesn’t include the certificate’s private key.

4. Save the file in the Personal Information Exchange (.p12) format.
5. Enter a password for the certificate when prompted.

Add a certificate to a wallet project

After you create a wallet project, use these steps to upload your certificate. That is usually a project you just created, but the same steps apply to any wallet project without a certificate.

Add a certificate:

1. Go to Settings, then Certificates.
2. Select Upload a new .p12.
3. Enter the certificate password.
4. Select Choose File and choose your p12 file.
5. Select Save.

Select a different certificate

After initial setup, you can point a project at a different certificate that is already uploaded to your project.

Designate which previously uploaded certificate should be used for a wallet project:

1. Go to Settings, then Certificates.
2. Select Select an existing .p12.
3. Select from the Certificate menu.
4. Select Save.

You can change a project’s certificate as often as needed.

Replace a certificate

Use this option when you need to upload a new certificate to your project, typically to replace an expiring certificate. The new certificate is validated upon upload to verify it has the same basename and Team ID as the original, so existing passes remain valid. If it is not a valid replacement, you are given the option to add it as a new certificate.

Replace a certificate:

1. Go to Settings, then Certificates.
2. Select Replace certificate.
3. Select Upload a new .p12.
4. Enter the certificate password.
5. Select Choose File and select your p12 file.
6. Select Save.