Mã lỗi và trường hợp ngoại lệ
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Phản hồi lỗi API
Bảng sau đây giải thích các mã lỗi có thể bị API Google Wallet trả về, nguyên nhân có thể xảy ra và giải pháp.
| Ngoại lệ |
Thông báo mẫu |
Đề xuất |
| 400 – BadRequestException |
Yêu cầu chứa đối số không hợp lệ. Mã tài nguyên không hợp lệ: {1234567891234567899 – ABCD1234567}. |
Kiểm tra cấu trúc dữ liệu cho loại, định dạng và độ dài và chuyển đối số đúng. |
| 403 – Quyền bị từ chốiException |
Quyền bị từ chối |
Đảm bảo email chính xác của Tài khoản dịch vụ là người dùng được uỷ quyền trong Bảng điều khiển Business Pay và Wallet của bạn. |
| 404 – NotFoundException |
Không tìm thấy đối tượng Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}. |
Hãy thực hiện lệnh GET trên mã đối tượng trước khi thử trước yêu cầu PATCH hoặc PUT để đảm bảo rằng bạn có một đối tượng cần cập nhật và đó là đối tượng mới nhất. |
| 404 – IssuerClassNotFoundException |
Không tìm thấy Lớp đối tượng Wallet {1234567891234567899.ABCD.1234567}. |
Khi cập nhật , hãy nhớ thực hiện yêu cầu GET trước yêu cầu PATCH hoặc PUT để đảm bảo bạn có một lớp để tham chiếu rằng đó là lớp mới nhất. Ngoài ra, hãy đảm bảo sử dụng đúng tải trọng (đối tượng và lớp) trong yêu cầu. |
| 409 - alreadyExistsException |
Lớp đối tượng Wallet {1234567891234567899.ABCD.1234567} đã tồn tại. |
Thực hiện lệnh GET trên mã lớp trước khi cố gắng tạo cùng một mã lớp. Nếu tài nguyên này tồn tại, bạn nên dùng PATCH hoặc PUT. |
Thông báo lỗi dựa trên nền tảng web
Nếu có sự cố khi bạn cố lưu thẻ và vé bằng đường liên kết "Thêm vào Google Wallet", bạn sẽ thấy một thông báo lỗi cho biết thông tin để giúp bạn khắc phục. Những thông báo này chỉ xuất hiện cho người dùng có vai trò "Nhà phát triển" hoặc "Quản trị viên" đối với tài khoản Nhà phát hành được liên kết.
Dưới đây là ví dụ về loại thông báo lỗi có thể hiển thị:
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThis page explains the different error codes that may be returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eThe table provides example error messages to help with troubleshooting, along with links to relevant documentation for further assistance.\u003c/p\u003e\n"],["\u003cp\u003eFor '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.\u003c/p\u003e\n"]]],["The Google Wallet API returns specific error codes: 400 (BadRequestException) indicates an invalid argument, requiring checks on data structure. 403 (PermissionDeniedException) means the service account lacks authorization. 404 (NotFoundException) signals a missing Wallet Object or Class, needing a GET request before PATCH/PUT actions. 409 (AlreadyExistsException) indicates an existing class, suggesting a GET request and potential PATCH/PUT instead of creating it again. Web errors are displayed to developers and admins.\n"],null,["# Error codes and exceptions\n\nAPI error responses\n-------------------\n\nThe following table explains error codes that mayn be returned by the Google Wallet API, their possible causes, and solutions.\n\n| Exception | Example Message | Suggestion |\n|------------------------------------|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 400 - BadRequestException | Request contains an invalid argument. Invalid resource ID: {1234567891234567899 - ABCD1234567}. | Check the data structure for type, format and length and pass the correct argument. |\n| 403 - PermissionDeniedException | Permission Denied | Ensure the correct [Service Account](https://developers.google.com/wallet/retail/loyalty-cards/web/prerequisites#4.-authorize-the-service-account) email is an authorized user within your Business Pay and Wallet Console. |\n| 404 - NotFoundException | Wallet Object {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} not found. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Object ID before trying before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have an object to update and that it's the latest. |\n| 404 - IssuerClassNotFoundException | Wallet Object Class {1234567891234567899.ABCD.1234567} not found. | When performing an update , ensure you do a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) request before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have a class to reference that it's the latest class. Also ensure the correct payload (object and class) is being used in the request correctly. |\n| 409 - AlreadyExistsException | Wallet Object Class {1234567891234567899.ABCD.1234567} already exists. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Class ID before trying to create the same Class ID. If the resource exists you may want to use [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT.](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) |\n\nWeb-based error messages\n------------------------\n\nIf something goes wrong when you attempt to save a pass using an 'Add to Google Wallet' link, you will be shown an informative error message to help you debug. These messages are only shown to users that have the 'Developer' or 'Admin' role for the associated Issuer account.\n\nHere is an example of the type of error message that might be displayed:"]]
