错误代码和异常

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 钱包”链接保存卡券时发生错误，系统会显示一条信息性错误消息，帮助您进行调试。这些消息只会向对关联的发卡机构帐号拥有“开发者”或“管理员”角色的用户显示。

以下是可能显示的错误消息类型的示例：

示例错误消息