错误代码和异常
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-09-05。
[null,null,["最后更新时间 (UTC)：2024-09-05。"],[[["This page explains the different error codes that may be returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException."],["Each error code has an explanation for the possible causes and suggestions for solutions, focusing on data structure validation, service account authorization, object and class ID verification, and using appropriate HTTP methods like GET, PATCH, or PUT."],["The table provides example error messages to help with troubleshooting, along with links to relevant documentation for further assistance."],["For 'Add to Google Wallet' links, web-based error messages are displayed for users with 'Developer' or 'Admin' roles to assist with debugging, offering insights into the issue."]]],[]]
