Apple Wallet Not Detecting My Pass (.pkpass) - How to Identify the Issue?

I'm trying to add a pass to Apple Wallet, but it isn't being detected when I attempt to add it. I've created the .pkpass file, and it contains the following files:

  • en.lproj/
  • icon.png
  • icon@2x .png
  • manifest.json
  • pass.json
  • signature
{
  "formatVersion": 1,
  "passTypeIdentifier": "pass.com.yourdomain.com",
  "serialNumber": "123456",
  "teamIdentifier": "5ZXXXXXX",
  "description": "This is an Event Pass",
  "eventTicket": {
    "primaryFields": [
      {
        "key": "event",
        "label": "EVENT",
        "value": "Concert"
      }
    ],
    "secondaryFields": [
      {
        "key": "location",
        "label": "LOCATION",
        "value": "Example Venue"
      },
      {
        "key": "date",
        "label": "DATE",
        "value": "2024-08-15"
      }
    ],
    "auxiliaryFields": [
      {
        "key": "time",
        "label": "TIME",
        "value": "7:00 PM"
      }
    ],
    "backFields": [
      {
        "key": "terms",
        "label": "TERMS & CONDITIONS",
        "value": "Non-refundable. Please arrive 30 minutes early."
      }
    ],
    "barcode": {
      "message": "1234567890",
      "format": "PKBarcodeFormatQR",
      "messageEncoding": "iso-8859-1"
    }
  },
  "organizationName": "ORGANIZATION NAME",
  "logoText": "Concert 2024",
  "foregroundColor": "rgb(255, 255, 255)",
  "backgroundColor": "rgb(0, 0, 0)",
  "eventTicketStrip": {
    "primaryFields": [
      {
        "key": "event",
        "label": "Event",
        "value": "Concert"
      }
    ]
  },
  "relevantDate": "2024-08-15T19:00:00Z"
}

What I've Done So Far:

  • Validated the Manifest: The SHA-1 hashes in the manifest.json match the actual files in the package.
  • Checked the pass.json: It seems to be correctly formatted, and all fields are populated.
  • Verified Pass Structure: The .pkpass file structure appears to be correct.
  • Validate with PKpass Validator: It's seems like all points are valid I put screenshot over here.

My Questions:

  • What could be preventing Apple Wallet from detecting this pass?
  • How can I verify if the signature is correctly applied?
  • Are there any recommended online tools or methods to debug this pass and identify what might be wrong?
  • I've tried using a few online validators, but the issue persists. Any guidance on how to resolve this would be greatly appreciated!

I know, I'm a little late, so I hope you solved somehow.

In case you didn't, first of all I see you are using "eventTicketStrip", which is not a valid type of pass. You should use "eventTicket" and then use the strip.png asset (+ @2x @3x) to let Wallet know the layout you want to be rendered.

Second, omitting icon@\3x.png on most recent iPhones, make a pass invalid, but it is perfect valid on Macs and older iPhones (I don't remember the last iPhone that used up to @2x). The website kind of lies. I mean, it is right, but it doesn't consider the device.

Third, always check for logs, if you have a Mac, through the Console.app in Application/Utilities, by connecting you phone via USB or network, giving the authorization as it should pop on your iPhone and then by filtering the logs (there will be a lot).

If you are opening the pkpass from another application, just filter by "Passkit".

If you are opening the pkpass via network or whatever, filtering by the process "passd" is fine.

Filtering by process means writing "passd" in the search box, pressing enter and then selecting the kind of parameter near "passd".

Hope this helps.

Alexander

Apple Wallet Not Detecting My Pass (.pkpass) - How to Identify the Issue?
 
 
Q