페이지 이동경로
  • 문서>
  • 비즈니스 인증>
  • 문제 해결

비즈니스 인증

문제 해결

이 문서는 비즈니스 인증 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다.

비즈니스 인가 코드 관련 에러

비즈니스 인가 코드 발급시 발생할 수 있는 에러 목록입니다.

에러 설명 해결 방법
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 키를 사용해야 합니다.

참고: 앱 키
KOE114
invalid_client
비즈니스 인가 코드의 client_id와 비즈니스 토큰 요청의 client_id 파라미터 값이 서로 다른 앱의 앱 키인 경우 동일한 앱에서 발급받은 비즈니스 인가 코드를 사용해 비즈니스 토큰을 재요청합니다.
KOE303
invalid_grant
비즈니스 인가 코드 요청과 비즈니스 토큰 요청 시 사용한 redirect_uri가 서로 다른 경우

Redirect URI mismatch.
비즈니스 인가 코드 발급 요청 시 전달된 redirect_uri와 동일한 redirect_uri를 사용하여 비즈니스 토큰을 요청합니다.
KOE310
invalid_request
unsupported_grant_type
invalid_grant
grant_type 파라미터를 포함하지 않았거나, 지원하지 않는 값을 사용하는 경우 앱에서 사용할 수 있는 grant_type을 이용해 비즈니스 토큰을 재요청합니다.
KOE320
invalid_grant
동일한 비즈니스 인가 코드를 두 번 이상 사용하거나, 이미 만료된 비즈니스 인가 코드를 사용한 경우, 혹은 비즈니스 인가 코드를 찾을 수 없는 경우

authorization code not found for code=${AUTHORIZATION_CODE}
비즈니스 토큰 요청 시, 매번 새로운 비즈니스 인가 코드를 사용해야 합니다. 비즈니스 인가 코드를 다시 발급한 후, 새로 발급받은 값으로 비즈니스 토큰을 요청합니다.
invalid_request 잘못된 요청인 경우 요청 시 올바른 인자를 전달했는지 확인합니다.