For Apple, Voyado uses a certificate and private key that are exclusively used for issuing Wallet passes. These do not grant access to your Apple account or any other Apple services. The recommended approach is to create a dedicated certificate and key pair that is used solely for Wallet passes.
Create the account using an authorized company signatory. This will speed up the process with Apple.
Prerequisites
Before starting, make sure you have the following in place:
- An active Apple Developer Account ($99/year) — register at developer.apple.com
- Access to Certificates, Identifiers & Profiles in your Apple Developer account
Configuration
You'll be doing the configuration in the Customer Engagement Config Hub. You'll find it in Customer Engagement at Administration > Config Hub > Marketing & Communications > Wallet.
1. Team identifier
Your 10-character Team ID links your Apple Developer account to Voyado Customer Engagement.
Where to find it:
- Log into developer.apple.com.
- Navigate to Account > Membership Details.
- Copy the Team ID value.
In Config Hub:
- Paste your Team ID into the Team Identifier field.
- Click Save.
2. Pass Type ID
The Pass Type ID identifies the specific pass type used for your wallet passes.
How to create one:
- In your Apple Developer account, navigate to Certificates, Identifiers & Profiles > Identifiers.
- Click + and select Pass Type IDs.
- Enter a description and unique identifier. By convention the indentifier follows the format
pass.com.yourcompany.yourapp. - Click Register.
In Config Hub:
- Paste your Pass Type ID into the Pass Type ID field.
- Click Save.
3. Certificate signing request (CSR)
A CSR is required to generate your Apple certificate. Customer Engagement generates the CSR for you.
- In Config Hub, click Generate CSR under Certificate Signing Request.
- Download the generated
.csrfile. - Go to your Apple Developer account and navigate to Certificates > Create Certificate.
- Select Pass Type ID Certificate as the certificate type.
- Upload the
.csrfile you downloaded from Config Hub. - Download the resulting
.cercertificate file from Apple.
.cer file ready — you will upload it in the next step.4. Certificate
Upload the .cer file you received from Apple after submitting the CSR.
- In Config Hub, choose your file and click Upload.
- Click Save.
5. APNs key ID
The APNs (Apple Push Notification service) Key ID enables push updates to be delivered to Apple Wallet passes, for example when a member's points balance or voucher changes.
Where to find it:
- In your Apple Developer account, navigate to Keys.
- Select your APNs key, or create a new one if you don't have one. Set the same key to be used in both Sandbox and Production.
- Copy the Key ID.
In Config Hub:
- Paste the Key ID into the APNs Key ID field.
- Click Save.
6. APNs key
Upload the .p8 key file associated with your APNs Key ID.
Where to find it:
- The
.p8file is downloaded when you first create the APNs key in your Apple Developer account. - The file can only be downloaded once. If you have lost it, you must create a new APNs key in your Apple Developer account and repeat this step with the new key and Key ID.
In Config Hub:
- In Config Hub, choose your file and click Upload.
- Click Save.