오류 코드 및 예외

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 월렛에 추가' 링크를 사용하여 패스를 저장하려고 할 때 문제가 발생하면 디버그하는 데 도움이 되는 정보 제공 오류 메시지가 표시됩니다. 이러한 메시지는 연결된 발급기관 계정에 '개발자' 또는 '관리자' 역할이 있는 사용자에게만 표시됩니다.

다음은 표시될 수 있는 오류 메시지 유형의 예입니다.

오류 메시지 예시