카카오톡 세션이 만료 되었거나 유효하지 않은 요청 입니다 - kakaotog sesyeon-i manlyo doeeossgeona yuhyohaji anh-eun yocheong ibnida

�� Customer Center

042.527.6782~4

목차 Show

카카오 고객센터 본문
카카오 로그인
문제 해결
인가 코드 관련 에러
액세스 토큰 관련 에러
OpenID Connect 관련 에러

�� ð��ȳ� Counseling time info

��  : �� 10�� ~ �� 6�� (�ްԽð� : 12�� ~ �� 1��)

�� : �� 10�� ~ �� 12�� / �޹�� : ��, �Ͽ��

�Ա� ��¾ȳ� Bank info

301-5402-8685-01

�� : �ڿ��(�ſ�)

�� ȳ� Today Delivery Guide

�� : 15�� Ա�Ȯ�� �� : �� 9:30�� Ա�Ȯ��

��(��ǰ)��̹�� 㰡 product��permission

�� ǰ �� (contents)�� ۱ǹ�

��98�� ǰ�� ȣ�ް� �ֽ��ϴ�.

�� ̹�� ǰ� �־�� մϴ�.

�� (��,��) å�� ϴ�.

카카오 고객센터 본문

회원

담당자가 2명 이상일 경우, 아래 방법을 참고하시어 담당자별 별도의 카카오 계정과 2단계 인증 정보를 설정하여 이용해 주시기 바랍니다.
1. 판매자센터에 접속이 필요한 담당자가 사용할 업무용(비즈니스용) 카카오 계정 생성
- 개인용으로 사용 중인 카카오 계정을 사용할 수는 있지만, 비즈니스 계정으로 설정되어 있는 상태에서는 카카오 계정 탈퇴가 제한됩니다.
☞ 카카오 계정 가입하기
2. 판매자 어드민 로그인 시 사용 중인 카카오 계정으로 카카오 비즈센터 로그인

☞ 카카오 비즈센터 이동
3. 카카오 비즈센터의 '멤버 관리'에서 '새로운 멤버 초대'를 통하여 담당자별 신규 생성 카카오 계정 초대
- 초대된 이메일로 초대 안내 메일이 발송됩니다.
4. 초대를 받은 분께 발송된 이메일에서 '초대 수락' 진행
- 초대 확인 및 수락은 카카오 비즈센터 메인화면에서도 진행할 수 있습니다.
- 초대 수락이 완료되면 비즈센터에서 파트너 상태가 'JOINED'로 변경됩니다.
5. 초대 수락이 완료된 카카오 계정으로 판매자센터에 로그인
- '배송관리 메뉴'를 선택하여 2단계 인증 정보를 각 개인의 정보로 새롭게 설정 후 이용해 주시기 바랍니다.
정보통신망법 제28조 및 방송통신위원회 가이드에 따라 정보통신서비스 제공자는 외부에서 개인정보를 처리할 수 있는 메뉴에 접근하려면 공인인증서 등 안전한 인증 수단을 적용해야 합니다.

위 정책에 따라 카카오 서비스 중 개인정보를 확인, 처리할 수 있는 메뉴는 카카오 계정 이메일 주소와 비밀번호를 입력하여 로그인을 했더라도 SMS(문자메시지) 또는 카카오톡으로 관리자 추가 인증을 거친 뒤 접근할 수 있습니다.
관리자 추가 인증은 전화번호, 문자메시지(SMS) 또는 카카오톡 인증 방식을 선택하여 등록할 수 있으며, 휴대폰을 확인할 수 없는 경우를 대비하여 미리 비상용 이메일 주소를 등록해야 합니다.
※ 비상용 이메일 주소는 카카오 계정 이메일 주소와 다른 이메일 주소로 등록해야 합니다.
관리자 추가 인증으로 'SMS 인증'을 선택하시면 등록된 휴대폰 번호로 인증번호가 포함된 SMS(문자메시지)를 발송합니다.
SMS(문자메시지)로 받은 인증번호를 입력하시면 인증이 완료됩니다.
※ 인증번호는 발송 후 5분 동안 유효합니다.
관리자 추가 인증으로 '카카오톡 인증'을 선택하시면 등록된 휴대폰 번호의 카카오톡 메시지로 인증번호를 발송합니다.
카카오톡 메시지로 받은 인증번호를 입력하시면 인증이 완료됩니다.
※ 인증번호는 발송 후 5분간 유효합니다.
※ 참고사항
카카오톡 인증은 관리자 추가 인증 시 등록했던 카카오톡과 동일한 카카오톡으로만 발송됩니다.
관리자 추가 인증 등록 후 휴대폰 번호를 변경했거나 기기변경으로 새로운 카카오 계정을 연결했을 경우, 등록한 '비상용 이메일 인증'을 통하여 관리자 추가 인증을 진행한 후 정보를 변경해 주시기 바랍니다.
등록된 카카오톡의 정보가 변경되면 이전에 카카오톡 인증을 선택하였더라도 비상용 이메일로 인증이 필요합니다.
이전에 등록했던 카카오톡을 탈퇴 후 재가입했거나 휴대폰 기기변경으로 인하여 기존 카카오 계정이 아닌 다른 이메일 주소로 로그인하였다면 카카오톡 인증 정보가 변경되어 등록된 인증 정보는 자동 만료됩니다.
비상용 이메일로 인증 후 휴대폰 번호, 인증 방식 등을 변경하여 이용해 주시기 바랍니다.
- 비즈계정센터 > 파트너 정보 조회 수정 > 내 정보 > 관리자 추가 인증 정보
관리자 추가 인증은 사전에 등록한 휴대폰 번호로 SMS(문자메시지) 또는 카카오톡 메시지를 수신하여 인증번호 입력 시 완료됩니다.
휴대폰을 확인할 수 없는 경우 미리 등록해 놓은 비상용 이메일을 통하여 인증번호를 확인할 수 있습니다.
- 관리자 추가 인증 인증번호 입력 페이지 > 팝업 하단 '인증번호를 받으실 수 없나요?' > 비상용 이메일 인증
관리자 추가 인증을 위하여 발송되는 SMS(문자메시지) 비용은 카카오에서 부담하며, 카카오톡 메시지는 무료입니다.
단, 카카오톡 이용 시 가입하신 통신사의 데이터 요금제가 적용되어 통화료가 부과될 수 있습니다.
아래와 같은 사유로 인하여 인증번호 수신이 어려울 수 있습니다.
- 등록된 휴대폰 번호가 현재 사용하는 휴대폰 번호와 일치하는지 확인해 주세요.
만약, 휴대폰 번호가 변경되었거나, 임시로 휴대폰을 확인할 수 없는 경우 미리 등록해 놓은 비상용 이메일로 인증번호를 받을 수 있습니다.
- 인증번호는 등록 시 선택한 방식에 따라 SMS(문자메시지) 또는 카카오톡 메시지로 발송됩니다.
SMS(문자메시지)로 인증번호가 수신되지 않았다면 카카오톡 메시지를 확인해 주세요.
- 일부 국가 또는 지역의 경우 통신사 사정에 따라 SMS(문자메시지)가 도착하기까지 다소 시간이 소요될 수 있습니다.
하루가 지나도 인증번호 수신이 되지 않을 시 고객센터로 문의해 주시기 바랍니다.
이미 등록한 관리자 추가 인증 정보는 관리자 추가 인증을 완료한 후 변경할 수 있습니다.
- 비즈계정센터 > 파트너 정보 조회 수정 > 내 정보 > 관리자 추가 인증 정보
비상용 이메일은 휴대폰 번호를 사용할 수 없을 경우를 대비하여 등록한 이메일 주소로, 카카오 계정(이메일)과 다른 이메일 주소로 등록해야 합니다.
카카오 계정 외 이메일 주소의 메일함에서 '[kakao] 비상용 이메일 등록 인증번호'를 조회해 보세요.
찾지 못하였을 경우 아래 사항을 최대한 입력하여 접수해 주시면 비상용 이메일 주소의 일부를 안내드릴 수 있습니다.
- 카카오 계정 이메일 주소
- 비즈계정센터 > 정보 관리 > 내 정보에 등록된 이름

- 비즈계정센터 > 정보 관리 > 내 정보에 등록된 연락처

- 관리자 추가 인증에 등록한 휴대폰 번호
만약, 기재해 주신 정보가 카카오 계정에 등록된 정보와 일치하지 않을 시 안내가 어렵습니다.
비상용 이메일 주소를 일부 안내드렸으나, 전체 메일 주소를 알지 못하는 경우 추가 서류 제출을 요청할 수 있습니다.

카카오 로그인

문제 해결

이 문서는 카카오 로그인 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다.

인가 코드 관련 에러

카카오 로그인 인가 코드 발급시 발생할 수 있는 에러 목록입니다.

Error Code Name	Description	Solution
KOE001	잘못된 요청인 경우	요청에 포함된 파라미터를 확인한 후 재요청합니다.
KOE002	잘못된 URL로 요청을 보내는 경우	요청을 보낸 URL을 확인한 후 재요청합니다.
KOE003	카카오 OAuth 서버에서 일시적인 오류가 발생한 경우	잠시 후 재요청합니다. 문제가 지속될 경우 데브톡으로 문의합니다.
KOE004	카카오 로그인이 비활성화되어 있는 경우	[내 애플리케이션] > [카카오 로그인]에서 카카오 로그인 기능을 활성화시킵니다.
KOE005	테스트앱에 팀원으로 등록되지 않은 사용자가 로그인을 시도한 경우	[내 애플리케이션] > [팀 관리]에 팀원 초대 기능을 사용해 팀원을 추가합니다.
KOE006	등록되지 않은 Redirect URI를 인가 코드 요청에 사용한 경우	[내 애플리케이션] > [카카오 로그인]에서 Redirect URI를 새로 등록하거나, 이미 등록된 Redirect URI를 인가 코드 요청 파라미터 `redirect_uri` 값으로 사용합니다.
KOE007	등록되지 않은 Logout Redirect URI를 로그아웃 요청에 사용한 경우	[내 애플리케이션] > [카카오 로그인] > [고급]에서 Logout Redirect URI를 새로 등록하거나, 이미 등록된 Logout Redirect URI를 로그아웃 요청 파라미터 `logout_redirect_uri` 값으로 사용합니다.
KOE008	인가 코드 요청 시 Admin Key를 사용한 경우	Admin Key가 아닌 개발 환경에 따른 올바른 타입의 앱 키(네이티브 앱 키, REST API 키, JavaScript 키 중 하나)를 사용해서 재요청합니다.
KOE101	잘못된 앱 키 타입을 사용하거나 앱 키에 오타가 있을 경우	[내 애플리케이션] > [앱 키]에서 발급 받은 앱 키를 올바르게 사용했는지 확인합니다.
KOE102 invalid_client	채널과 디벨로퍼스 앱이 연결되어 있지 않은 상태에서 인가 코드 요청에 `channel_public_id` 파라미터가 포함된 경우 Required PLUS_FRIENDS_ON_AGREEMENT_SUPPORTED permission	채널과 디벨로퍼스 앱을 연결한 후 재요청합니다.
KOE201 invalid_request	지원하지 않는 `response_type`을 인가 코드 요청에 포함하는 경우 Unsupported response type: {response_type}	`response_type` 파라미터 값이 `code`인지 확인한 후 재요청합니다.
KOE202 invalid_request	`response_type`이 `token`일 경우 Implicit grant Required OAUTH_IMPLICIT_GRANT_SUPPORTED permission	`response_type` 파라미터 값을 `code`로 수정하고 재요청합니다.
KOE203 invalid_request	동의 화면에서 필수 동의 항목에 동의하지 않은 경우 All required service terms must be approved. required:${Service Term IDs} agreed:${Service Term IDs}	비정상적 동의과정에서 보여지는 에러페이지로 해당 에러페이지가 보여지는 경우 데브톡으로 문의합니다.
KOE204 invalid_request	유효하지 않은 파라미터를 포함하는 경우 Invalid agreement_code: ${Agreement Code}	인가 코드 받기에서 사용할 수 있는 파라미터를 확인한 뒤 재요청합니다.
KOE205 invalid_scope	앱 설정에서 설정하지 않은 동의 항목을 scope 파라미터의 값으로 포함한 경우 Invalid scope: ${Scope}	[내 애플리케이션] > [카카오 로그인] > [동의항목]에서 설정하지 않은 동의항목을 제외하고 재요청합니다.
KOE207 invalid_request	필수 파라미터가 누락된 경우	REST API 가이드에서 필수 파라미터를 확인한 후, 해당 파라미터를 포함하여 재요청합니다.
access_denied	User denied access	사용자가 로그인을 취소한 것이므로, 초기 화면으로 이동시키는 등의 조치가 필요합니다.
access_denied	Not allowed under age 14	만 14세 미만 사용자의 보호자 동의에 실패한 것이므로, 초기 화면으로 이동시키는 등의 조치가 필요합니다.
login_required	카카오계정 인증 필요 `prompt=none`을 사용해 카카오톡으로 자동 로그인을 요청했으나, 카카오톡에 연결된 카카오계정이 없는 경우 user authentication required.	카카오톡에서 자동 로그인 기능을 사용할 수 없습니다. 일반적인 카카오 로그인을 통해 서비스에 로그인해야 합니다.
consent_required	동의 화면을 통한 사용자 동의 필요 `prompt=none`을 사용해 카카오톡으로 자동 로그인을 요청했으나, 사용자가 아직 서비스 앱에 카카오 로그인한 적 없거나 동의해야 할 동의 항목이 존재하는 경우 user consent required.	카카오톡에서 자동 로그인 기능을 사용할 수 없습니다. 일반적인 카카오 로그인을 통해 서비스에 로그인해야 합니다.
interaction_required	`prompt=none`을 사용해 카카오톡으로 자동 로그인을 요청했으나, 사용자 정보 추가 제공 등 기타 사용자 동작이 필요한 경우 need to collect additional personal information.	카카오톡에서 자동 로그인 기능을 사용할 수 없습니다. 일반적인 카카오 로그인을 통해 서비스에 로그인해야 합니다.
interaction_required	`prompt=none`을 사용해 카카오톡으로 자동 로그인을 요청했으나, 카카오계정 통합약관 동의가 필요한 사용자인 경우 have to agree to kakao's terms of service.	카카오톡에서 자동 로그인 기능을 사용할 수 없습니다. 일반적인 카카오 로그인을 통해 서비스에 로그인해야 합니다.
interaction_required	`prompt=none`을 사용해 카카오톡으로 자동 로그인을 요청했으나, 제재된 사용자인 경우 account has been restricted.	사용자가 카카오계정 제제 상태에 대한 안내 페이지를 볼 수 있도록, `prompt=none`을 제외하고 다시 인가 코드 받기를 요청합니다.

액세스 토큰 관련 에러

카카오 로그인 엑세스 토큰 발급시 발생할 수 있는 에러 목록입니다.

Error Code Name	Description	Solution
KOE101 invalid_client	잘못된 앱 키 타입을 사용하거나 앱 키에 오타가 있을 경우 Not exist client_id ${CLIENT_ID}	요청 시 카카오 로그인을 사용할 앱의 앱 키를 전달했는지 확인합니다. [내 애플리케이션] > [앱 키]에서 발급 받은 앱 키를 올바르게 사용했는지 확인합니다. Android, iOS SDK를 초기화할 때는 네이티브 앱 키를, JavaScript SDK를 초기화할 때는 JavaScript 키를, REST API를 호출할 때는 REST API 키를 사용해야 합니다.
KOE009 misconfigured	등록되지 않은 플랫폼에서 액세스 토큰을 요청 하는 경우 invalid android_key_hash or ios_bundle_id or web_site_url	플랫폼 등록을 참고하여 [내 애플리케이션] > [플랫폼]에서 Web, Android, iOS 플랫폼 설정이 올바른지 확인합니다.
KOE010 invalid_client	클라이언트 시크릿(Client secret) 기능을 사용하는 앱에서 토큰 요청 시 `client_secret` 값을 전달하지 않거나 정확하지 않은 값을 전달하는 경우 Bad client credentials	클라이언트 시크릿 기능을 활성화한 경우, `client_secret` 파라미터를 추가하지 않으면 OAuth 서버로부터 토큰을 발급받을 수 없습니다. [내 애플리케이션] > [카카오 로그인] > [보안]에서 생성한 클라이언트 시크릿 코드를 `client_secret` 파라미터로 전달합니다.
KOE303 invalid_grant	인가 코드 요청 시 사용한 `redirect_uri`와 액세스 토큰 요청 시 사용한 `redirect_uri`가 다른 경우 Redirect URI mismatch.	인가 코드 발급 요청 시 전달된 `redirect_uri`와 동일한 `redirect_uri`를 사용하여 엑세스 토큰을 요청합니다.
KOE319 invalid_grant	토큰 갱신 요청 시 리프레시 토큰을 전달하지 않는 경우 refresh token is blank	토큰 갱신 요청 시 발급받은 리프레시 토큰을 `refresh_token` 파라미터의 값으로 전달합니다.
KOE320 invalid_grant	동일한 인가 코드를 두 번 이상 사용하거나, 이미 만료된 인가 코드를 사용한 경우, 혹은 인가 코드를 찾을 수 없는 경우 authorization code not found for code=${AUTHORIZATION_CODE}	액세스 토큰 요청 시, 매번 새로운 인가 코드를 사용해야 합니다. 인가 코드를 다시 발급한 후, 새로 발급받은 인가 코드로 액세스 토큰을 요청합니다.
KOE322 invalid_grant	`refresh_token`을 찾을 수 없거나 이미 만료된 리프레시 토큰을 사용한 경우 expired_or_invalid_refresh_token	인가 코드를 사용하여 액세스 토큰과 리프레시 토큰을 새로 발급받습니다.
invalid_request	잘못된 요청인 경우	요청 시 올바른 인자를 전달했는지 확인합니다.

OpenID Connect 관련 에러

OpenID Connect를 사용하는 앱에서 ID 토큰 관련 요청 시 발생할 수 있는 에러 목록입니다.

Error Code Name	Description	Solution
KOE400 invalid_token	ID 토큰 값이 전달되지 않았거나 올바른 형식이 아닌 ID 토큰인 경우 invalid id_token format	올바른 ID 토큰 값으로 재요청합니다.
KOE401 invalid_token	ID 토큰을 발급한 인증 기관(`iss`)이 카카오 인증 서버(`kauth.kakao.com`)가 아닌 경우 invalid id_token issuer	올바른 ID 토큰 값으로 재요청합니다. 참고: 카카오 인증 서버가 발급한 ID 토큰의 `iss` 값은 `https://kauth.kakao.com`으로 고정이므로, `iss` 값이 다르다면 카카오 로그인을 통해 발급된 유효한 ID 토큰이 아닙니다.
KOE402 invalid_token	서명이 올바르지 않아 유효한 ID 토큰이 아닌 경우 invalid id_token	올바른 ID 토큰 값으로 재요청합니다. 참고: 카카오 인증 서버가 발급한 ID 토큰은 공개키를 사용해 서명의 유효성을 검증할 수 있습니다. ID 토큰 유효성 검증을 참고합니다.
KOE403 invalid_token	만료된 ID 토큰인 경우 id_token has expired	올바른 ID 토큰 값으로 재요청합니다. 참고: ID 토큰의 만료 시간은 함께 발급된 액세스 토큰과 동일합니다.

Android

다음은 Android SDK를 통해 카카오 로그인 구현 시 발생할 수 있는 에러 목록입니다.

AuthErrorCause

AuthErrorCause에 정의된 에러 목록으로, 카카오 로그인 요청 시 발생하는 에러

Error	Description	Solution
`InvalidRequest`	잘못된 파라미터를 전달했습니다.	요청 시 전달된 파라미터 값이 올바른지 확인합니다.
`InvalidClient`	잘못된 앱 키를 전달했습니다.	Android SDK 초기화 시 사용한 앱 키 값이 [내 애플리케이션] > [앱 키]의 네이티브 앱 키와 일치하는지 확인합니다.
`InvalidScope`	잘못된 동의 항목 ID를 전달했습니다.	`scopes` 파라미터에 전달된 동의 항목 ID가 올바른지 확인합니다.
`InvalidGrant`	리프레시 토큰이 만료되었거나 존재하지 않습니다.	카카오 로그인을 통해 토큰을 새로 발급받습니다.
`Misconfigured`	Android 플랫폼 설정이 올바르지 않습니다.	[내 애플리케이션] > [플랫폼] > [Android]의 패키지명, [카카오 로그인] 사용 여부 등 앱 설정이 올바른지 확인합니다.
`Unauthorized`	요청 권한이 없는 앱입니다.	카카오 로그인은 별도 권한 신청 없이도 사용할 수 있는 API이므로, 이 에러 응답을 받을 경우 데브톡으로 문의합니다.
`AccessDenied`	사용자가 동의 화면에서 로그인을 취소했습니다.	사용자가 로그인을 취소한 경우이므로, 로그인 이전 페이지로 이동하는 등 로그인 취소로 처리합니다.
`ServerError`	일시적인 서버 오류가 발생했습니다.	잠시 후 다시 요청합니다. 문제가 지속될 경우, 데브톡으로 문의합니다.
`Unknown`	알 수 없는 오류가 발생했습니다.	에러 로그를 보고 문제를 파악합니다. 해결이 어려울 때는 데브톡으로 문의합니다.

ClientErrorCause

ClientErrorCause에 정의된 에러 목록으로, Android SDK 내부에서 발생하는 클라이언트 에러

Error	Description	Solution
`NotSupported`	지원되지 않는 기능입니다. 카카오톡 또는 사용 가능한 브라우저 앱이 설치되어 있지 않은 경우에 발생합니다.	사용자 기기에 사용 가능한 브라우저가 있는지 확인 후 카카오 로그인을 요청하거나, 카카오 로그인을 이용할 수 없는 환경임을 사용자에게 안내합니다.
`Cancelled`	사용자가 요청을 취소했습니다.	사용자가 로그인을 취소한 경우이므로, 로그인 이전 페이지로 이동하는 등 로그인 취소로 처리합니다.
`TokenNotFound`	API 요청에 사용할 토큰이 없습니다. 카카오 로그인을 통해 발급받은 토큰이 필요한 API를 호출한 경우 발생합니다.	카카오 로그인을 통해 토큰 발급 후 해당 API를 호출하도록 수정합니다.
`BadParameter`	잘못된 파라미터를 전달했습니다.	요청 시 전달된 파라미터 값이 올바른지 확인합니다.
`IllegalState`	요청을 정상적으로 실행할 수 없는 상태입니다.	에러 로그를 보고 문제를 파악합니다. 해결이 어려울 때는 데브톡으로 문의합니다.
`Unknown`	알 수 없는 오류가 발생했습니다.	에러 로그를 보고 문제를 파악합니다. 해결이 어려울 때는 데브톡으로 문의합니다.