이 문서는 비즈니스 인증 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다.
비즈니스 인가 코드 발급시 발생할 수 있는 에러 목록입니다.
에러 | 설명 | 해결 방법 |
---|---|---|
KOE003 | 카카오 OAuth 서버에서 일시적인 오류가 발생한 경우 | 잠시 후 재요청합니다. 문제가 지속될 경우 데브톡으로 문의합니다. |
KOE005 | 테스트 앱에 팀원으로 등록되지 않은 사용자가 로그인을 시도한 경우 | [내 애플리케이션] > [팀 관리]에서 팀원을 추가합니다. 참고: 팀 관리 |
KOE008 | 비즈니스 인가 코드 요청에 잘못된 앱 타입을 사용한 경우 | REST API 키를 사용해 재요청합니다. 참고: 앱 키 |
KOE025 | 카카오비즈니스센터 가입을 완료하지 않은 카카오계정으로 비즈니스 인증을 요청 한 경우 | 카카오비즈니스센터 가입 후 재요청합니다. |
KOE026 | 서비스를 이용할 수 없는 상태의 카카오계정으로 비즈니스 인증을 요청한 경우 | 카카오계정 상태를 확인 후 필요한 절차를 수행합니다. |
KOE027 | 비즈니스 자산이 없는 카카오계정으로 비즈니스 인증을 요청한 경우 | 비즈니스 자산을 생성하거나, 비즈니스 자산이 존재하는 카카오계정으로 재요청합니다. |
KOE028 | 등록하지 않은 비즈니스 Redirect URI를 사용해 비즈니스 인가 코드를 요청한 경우 | [내 애플리케이션] > [비즈니스 인증]에서 비즈니스 Redirect URI를 새로 등록하거나, 등록된 값을 비즈니스 인가 코드 요청 redirect_uri 값으로 사용합니다. |
KOE101 | 잘못된 앱 키를 사용한 경우 | [내 애플리케이션] > [앱 키]에서 발급받은 앱 키를 올바르게 사용했는지 확인합니다. 참고: 앱 키 |
KOE123 | 비즈 앱이 아닌 앱으로 비즈니스 인가 코드를 요청한 경우 | [내 애플리케이션] > [비즈니스]에서 서비스 앱을 비즈 앱으로 전환합니다. |
KOE124 | 권한이 없는 앱으로 비즈니스 인가 코드를 요청한 경우 | 필요한 권한 획득 후 재요청합니다. |
KOE201 invalid_request |
지원하지 않는 응답 유형(response_type )을 포함해 비즈니스 인가 코드를 요청한 경우Unsupported response type: ${response_type} |
response_type 파라미터 값을 code 로 변경해 재요청합니다. |
KOE232 | 권한이 없거나 설정하지 않은 비즈니스 동의항목을 포함해 비즈니스 인가 코드를 요청한 경우 | 권한이 없는 동의항목을 제외하거나, [내 애플리케이션] > [비즈니스 인증] > [동의항목]에서 동의 필요 항목을 설정 후 재요청합니다. |
KOE233 | 지원하지 않는 파라미터로 비즈니스 인가 코드를 요청한 경우 | 비즈니스 인가 코드 받기 요청 규격에 맞춰 재요청합니다. |
KOE234 | 권한이 없거나 유효하지 않은 비즈니스 자산 정보를 포함해 비즈니스 인가 코드를 요청한 경우 | 권한이 있는 유효 비즈니스 자산으로 재요청합니다. |
KOE235 | 광고계정과 연결되지 않은 카카오톡 채널을 포함해 비즈니스 인가 코드를 요청한 경우 | 광고계정과 연결된 카카오톡 채널로 재요청합니다. |
KOE236 | 발급 가능한 비즈니스 토큰 개수를 초과한 경우 | [로그인] > [카카오계정 ID] > [계정 설정] > [비즈니스 인증 동의 관리]에서 불필요한 비즈니스 토큰을 삭제한 후 재요청합니다. |
access_denied | User denied access |
사용자가 비즈니스 인증을 취소했습니다. 비즈니스 인증 이전 또는 초기 화면으로 이동시키는 등의 조치가 필요합니다. |
access_denied | Not allowed under age 14 |
만 14세 미만 사용자가 이용할 수 없는 앱이거나, 만 14세 미만 사용자의 보호자 동의에 실패했습니다. 초기 화면으로 이동시키는 등의 조치가 필요합니다. |
비즈니스 토큰 발급시 발생할 수 있는 에러 목록입니다.
에러 | 설명 | 해결 방법 |
---|---|---|
KOE101 invalid_client |
잘못된 앱 키 타입을 사용하거나 앱 키에 오타가 있을 경우Not exist client_id ${CLIENT_ID} |
[내 애플리케이션] > [앱 키]에서 발급받은 앱 키를 올바르게 사용했는지 확인합니다. REST API 키를 사용해야 합니다. 참고: 앱 키 |
KOE114invalid_client |
비즈니스 인가 코드의 client_id 와 비즈니스 토큰 요청의 client_id 파라미터 값이 서로 다른 앱의 앱 키인 경우 |
동일한 앱에서 발급받은 비즈니스 인가 코드를 사용해 비즈니스 토큰을 재요청합니다. |
KOE303 invalid_grant |
비즈니스 인가 코드 요청과 비즈니스 토큰 요청 시 사용한 redirect_uri 가 서로 다른 경우Redirect URI mismatch. |
비즈니스 인가 코드 발급 요청 시 전달된 redirect_uri 와 동일한 redirect_uri 를 사용하여 비즈니스 토큰을 요청합니다. |
KOE310invalid_request unsupported_grant_type invalid_grant |
grant_type 파라미터를 포함하지 않았거나, 지원하지 않는 값을 사용하는 경우 |
앱에서 사용할 수 있는 grant_type 을 이용해 비즈니스 토큰을 재요청합니다. |
KOE320 invalid_grant |
동일한 비즈니스 인가 코드를 두 번 이상 사용하거나, 이미 만료된 비즈니스 인가 코드를 사용한 경우, 혹은 비즈니스 인가 코드를 찾을 수 없는 경우authorization code not found for code=${AUTHORIZATION_CODE} |
비즈니스 토큰 요청 시, 매번 새로운 비즈니스 인가 코드를 사용해야 합니다. 비즈니스 인가 코드를 다시 발급한 후, 새로 발급받은 값으로 비즈니스 토큰을 요청합니다. |
invalid_request | 잘못된 요청인 경우 | 요청 시 올바른 인자를 전달했는지 확인합니다. |