Skip to main content

Apple Wallet

Before you can issue passes on Apple Wallet, you need to create a Pass Type ID and generate a certificate from your Apple Developer account. This certificate is what identifies your organisation as the legitimate issuer of passes on iOS devices.

info

You will need a Mac to complete this setup. Generating the certificate requires the Keychain Access application, which is only available on macOS.

Prerequisites​

  • An Apple Developer Program account of type "Organization" (99$/year). Individual accounts are not supported for pass issuance.
  • A Mac with Keychain Access available.
  • Administrator access to your Apple Developer account.

Step 1 - Create a Pass Type ID​

The Pass Type ID is a unique identifier that will be associated with all passes issued under your organisation.

Loyalty template

  • In the Identifiers section, click the (+) button.

Loyalty template

  • Select Pass Type IDs and click Continue.

Pass type ids

  • Fill in the form:
    • Description: a human-readable name for your programme (e.g. Loyalty Programme – My Brand).
    • Identifier: a unique ID starting with pass. (e.g. pass.com.yourbrand.loyalty).

Form to fill

  • Click Continue, then Register.
tip

Choose your Pass Type ID carefully — it cannot be changed after creation. Use a naming convention that reflects your brand and programme type, especially if you plan to create multiple Pass Type IDs.

Step 2 - Generate the certificate (.p12)​

The certificate is the file you will upload into Actito. It proves that you are authorised to issue passes under your Pass Type ID.

Generate a Certificate Signing Request on your Mac​

  • Open Keychain Access on your Mac.
  • From the menu bar, go to Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.

Keychain access

  • Fill in your email address, select Save to disk, and click Continue.
  • Save the .certSigningRequest file to your desktop.

Create the certificate on the Apple Developer Portal​

  • In your Apple Developer account, go to Certificates and click (+).

Loyalty template

  • Select Pass Type ID Certificate and click Continue.

Loyalty template

  • Select the Pass Type ID you created in Step 1.

Pass type ID

  • Upload the .certSigningRequest file you just generated and click Continue.

Upload the file

  • Download the .cer certificate file generated by Apple.

Download the file

  • Double-click the .cer file to add it to your Mac's Keychain.

Add it to the keychain

Export the certificate as .p12​

  • Open Keychain Access and locate the certificate you just added.
  • Right-click on it and select Export.

Loyalty template

  • Choose .p12 as the file format and click Save.
  • Set a strong password to protect the file.
warning

Keep both the .p12 file and its password in a safe place. You will need them to configure Apple Wallet in Actito, and to renew your certificate when it expires.

Step 3 - Upload the certificate to Actito​

Once your .p12 certificate is ready, go to Hub > Wallet > Configuration in Actito and click Update Apple Wallet Certificate:

  • Pass type ID certificate: upload your .p12 file.
  • Password: enter the password you defined when exporting the certificate.

Upload in Actito

tip

Apple certificates expire periodically. Make sure to renew your certificate in your Apple Developer account before it expires and update it in Actito — failing to do so will prevent passes from being issued or updated.

NFC (Optional)​

If you want to enable NFC-based contactless interactions on your Apple Wallet passes, an additional entitlement is required from Apple. This is a separate request submitted via developer.apple.com/contact/passkit/nfc-certificate.

Once granted, additional NFC settings can be configured in Actito by copy/pasting the public encryption key.

NFC configuration

Was this page helpful?