API 오류 응답
다음 표에는 Google Wallet API에서 반환할 수 있는 오류 코드와 가능한 원인, 해결 방법이 설명되어 있습니다.
예외 | 예시 메시지 | 추천 |
---|---|---|
400 - BadRequestException | 요청에 잘못된 인수가 포함되어 있습니다. 잘못된 리소스 ID: {1234567891234567899 - ABCD1234567} | 데이터 구조의 유형, 형식, 길이를 확인하고 올바른 인수를 전달합니다. |
403 - PermissionDeniedException | 승인 거부됨 | 올바른 서비스 계정 이메일이 Business Pay 및 월렛 콘솔 내의 승인된 사용자인지 확인합니다. |
404 - NotFoundException - | 월렛 객체 {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}를 찾을 수 없습니다. | PATCH 또는 PUT 요청 전에 시도하기 전에 객체 ID에 GET을 수행하여 업데이트할 객체가 있는지, 최신 객체인지 확인합니다. |
404 - IssuerClassNotFoundException | 월렛 객체 클래스 {1234567891234567899.ABCD.1234567}을(를) 찾을 수 없습니다. | 업데이트를 실행할 때 PATCH 또는 PUT 요청 전에 GET 요청을 실행하여 최신 클래스임을 참조할 클래스가 있는지 확인합니다. 또한 올바른 페이로드 (객체 및 클래스)가 요청에서 올바르게 사용되고 있는지 확인합니다. |
409 - AlreadyExistsException | 월렛 객체 클래스 {1234567891234567899.ABCD.1234567}이(가) 이미 존재합니다. | 동일한 클래스 ID를 만들기 전에 클래스 ID에 GET을 실행합니다. 리소스가 있으면 PATCH 또는 PUT.을 사용할 수 있습니다. |
웹 기반 오류 메시지
'Google 월렛에 추가' 링크를 사용하여 패스를 저장하려고 할 때 문제가 발생하면 디버그하는 데 도움이 되는 정보 제공 오류 메시지가 표시됩니다. 이러한 메시지는 연결된 발급기관 계정에 '개발자' 또는 '관리자' 역할이 있는 사용자에게만 표시됩니다.
다음은 표시될 수 있는 오류 메시지 유형의 예입니다.
![오류 메시지 예시](https://developers-dot-devsite-v2-prod.appspot.com/static/wallet/images/web-error-message.png?authuser=7&hl=ko)