API 错误响应
下表介绍了 Google Wallet API 可能会返回的错误代码、可能的原因以及解决方案。
| 异常 | 示例消息 | 建议 |
|---|---|---|
| 400 - BadRequestException | 请求中包含无效的参数。资源 ID 无效：{1234567891234567899 - ABCD1234567}。 | 检查数据结构的类型、格式和长度，并传递正确的参数。 |
| 403 - PermissionDeniedException | 权限遭拒 | 确保在 Business Pay 和钱包控制台内是正确的服务账号电子邮件地址是授权用户。 |
| 404 - NotFoundException | 找不到电子钱包对象 {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}。 | 先对对象 ID 执行 GET，然后再尝试发出 PATCH 或 PUT 请求，以确保您有一个对象要更新的对象，并且该对象是最新的对象。 |
| 404 - IssuerClassNotFoundException | 找不到电子钱包对象类 {1234567891234567899.ABCD.1234567}。 | 执行更新时，请确保在执行 PATCH 或 PUT 请求之前执行 GET 请求，以确保您有一个类来引用它是最新类。此外，还要确保请求中正确使用了正确的负载（对象和类）。 |
| 409 - AlreadyExistsException | 钱包对象类 {1234567891234567899.ABCD.1234567} 已存在。 | 请先对类 ID 执行 GET，然后再尝试创建相同的类 ID。如果资源存在，您可能需要使用 PATCH 或 PUT.。 |
基于 Web 的错误消息
如果您尝试使用“添加到 Google 钱包”链接保存卡券时发生错误，系统会显示一条信息性错误消息，帮助您进行调试。这些消息只会向对关联的发卡机构帐号拥有“开发者”或“管理员”角色的用户显示。
以下是可能显示的错误消息类型的示例：
