Apple Wallet Setup Guide

Complete guide to configuring Apple Wallet certificates for PassLoop

📋 Prerequisites

⚠️ Important: Apple Wallet integration requires a paid Apple Developer Program membership ($99/year USD).

What You'll Need

🔧 Step-by-Step Setup

Step 1: Create Pass Type ID

  1. Log in to Apple Developer Account
  2. Navigate to Certificates, Identifiers & Profiles
  3. Click Identifiers in the sidebar
  4. Click the + button to register a new identifier
  5. Select Pass Type IDs and click Continue
  6. Enter a description (e.g., "My Business Loyalty Passes")
  7. Enter an identifier in reverse domain format:
    pass.com.yourbusiness.loyalty
  8. Click Register

Step 2: Create Pass Type ID Certificate

  1. On your Mac, open Keychain Access
  2. From the menu: Keychain Access → Certificate Assistant → Request a Certificate from a Certificate Authority
  3. Enter your email address
  4. Enter a common name (e.g., "PassLoop Pass Certificate")
  5. Select "Saved to disk"
  6. Click Continue and save the .certSigningRequest file
  7. Return to Apple Developer Portal
  8. Click on your Pass Type ID
  9. Click Create Certificate
  10. Upload the .certSigningRequest file
  11. Download the generated certificate (.cer file)
  12. Double-click to install it in Keychain Access

Step 3: Export Certificate as .p12

  1. Open Keychain Access
  2. Select login keychain and My Certificates category
  3. Find your Pass Type ID certificate
  4. Expand the certificate to show the private key
  5. Right-click the certificate (not the key) and select Export
  6. Choose Personal Information Exchange (.p12) format
  7. Save with a name like PassTypeID.p12
  8. Create a strong password when prompted
  9. Remember this password - you'll need it in PassLoop

Step 4: Download WWDR Certificate

  1. Visit Apple Certificate Authority
  2. Download the Apple Worldwide Developer Relations Intermediate Certificate
  3. Look for "WWDR Certificate (Expiring 02/20/2030)" or latest version
  4. Double-click to install in Keychain Access
  5. In Keychain Access, find this certificate
  6. Right-click and Export as .pem format
  7. Save as WWDR.pem

Step 5: Find Your Team Identifier

  1. Go to Apple Developer Account
  2. Click on Membership in the sidebar
  3. Your Team ID is displayed (10 characters, e.g., "A1B2C3D4E5")
  4. Copy this value

Step 6: Upload to PassLoop

  1. Log in to your PassLoop account
  2. Go to Dashboard → Certificates tab
  3. Click Configure Apple Wallet
  4. Upload your .p12 certificate file
  5. Upload your WWDR.pem certificate file
  6. Enter your Team Identifier (e.g., A1B2C3D4E5)
  7. Enter your Pass Type Identifier (e.g., pass.com.yourbusiness.loyalty)
  8. Enter the password you created for the .p12 file
  9. Click Save Configuration
✅ Success! You're now ready to generate Apple Wallet passes.

🔧 Troubleshooting

Common Issues

"Cannot export private key"

Solution: Make sure you requested the certificate from the same Mac where you're trying to export it. The private key must be in the same keychain.

"Certificate is not valid"

Solution: Ensure you downloaded and installed the WWDR certificate. Check that it hasn't expired.

"Pass Type Identifier mismatch"

Solution: The identifier in PassLoop must exactly match the one registered in Apple Developer Portal (case-sensitive).

"Wrong password for .p12 file"

Solution: Re-export the certificate and create a new .p12 file with a new password.

"Certificate has expired"

Solution: Certificates expire after 1 year. Create a new certificate following the same steps.

Testing Your Configuration

  1. Create a simple test pass in PassLoop
  2. Download the .pkpass file
  3. Open it on an iOS device
  4. If it opens correctly, your configuration is working!

Need Help?

If you're still having issues, contact our support team at support@passloop.dev with:

📚 Additional Resources