错误代码和异常
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 钱包”链接保存卡券时发生错误，系统会显示一条信息性错误消息，帮助您进行调试。这些消息只会向对关联的发卡机构帐号拥有“开发者”或“管理员”角色的用户显示。
以下是可能显示的错误消息类型的示例：
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-08-13。
[null,null,["最后更新时间 (UTC)：2024-08-13。"],[[["This page explains the various error codes returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException."],["Each error code is accompanied by a description, potential causes, and suggestions for resolution, such as data validation, permission checks, and resource verification."],["Before update requests (PATCH or PUT), it's crucial to perform a GET request to ensure the resource exists and you have the latest version to prevent conflicts."],["For 'Add to Google Wallet' links, web-based error messages are displayed to developers and admins to aid in debugging issues during pass saving."],["These messages provide insights into the problem, helping developers understand and resolve issues effectively."]]],[]]
