使用jPasskit：如何检查Apple Wallet中是否已存在指定会员卡凭证？

Apple出于隐私保护，没有提供直接查询用户Wallet内凭证的接口，所以得通过服务端记录+PassKit Webhook回调的方式实现你的需求，结合jPasskit的具体实现步骤如下：

1. 给每张凭证分配全局唯一标识 #

创建Pass时，必须通过jPasskit设置唯一的serialNumber，这个字段是Pass的核心唯一标识，建议结合用户ID和会员卡类型生成（比如USER_001_MEMBER_2024），同时把「用户ID+serialNumber+状态」的对应关系存在你的数据库里。

示例代码：

PKPass pass = new PKPass();
// 生成唯一序列号，确保同一用户同类型会员卡不会重复
pass.setSerialNumber(String.format("USER_%s_MEMBER_%s", userId, cardTypeCode));
// 其他Pass配置（如logo、会员信息等）...

2. 配置PassKit Webhook回调 #

启用PassKit的推送服务，当用户添加/删除Pass时，Apple会主动向你的服务端发送回调请求，这是你更新凭证状态的关键：

• 在创建Pass时，通过jPasskit设置Web服务相关参数：

  PKWebService webService = new PKWebService();
  // 你的服务端回调接口地址
  webService.setWebServiceURL(new URL("https://your-server.com/passkit/callback"));
  // 用于Apple请求验证的安全令牌，自己生成一个随机强字符串即可
  webService.setAuthenticationToken("your-32-byte-secure-token");
  pass.setWebService(webService);
  

• 服务端实现回调接口，处理Apple的请求：
  • 收到POST请求：表示用户已添加该Pass，把数据库中对应记录的状态更新为「已添加」。
  • 收到DELETE请求：表示用户已移除该Pass，更新状态为「已移除」。

3. 实现重复创建校验逻辑 #

用户尝试创建新会员卡时，先查你的数据库：

• 如果存在该用户对应会员卡类型、且状态为「已添加」的记录，直接返回错误，禁止重复创建。
• 如果状态是「已移除」或者无对应记录，则允许创建新Pass，并同步更新数据库的状态记录。

4. 关键注意事项 #

• serialNumber必须全局唯一，不能重复，否则会导致Pass状态混乱。
• 回调接口必须验证Apple的请求签名，防止伪造请求，jPasskit提供了PKSignatureVerifier工具类可以直接用。
• 考虑网络异常：如果Apple的回调请求失败，后续可以通过Pass的更新机制触发同步，但核心依赖还是初始的回调状态记录。

内容的提问来源于stack exchange，提问作者DechQ