- 마지막 업데이트
에러 코드 통합
에러 코드 통합 안내
스토브 플랫폼을 연동할 때 마주칠 수 있는 에러 코드를 서비스별로 확인할 수 있어요. Mobile SDK·PC 클라이언트·PC SDK에서 반환되는 코드가 각각 어떤 상황에서 발생하고, 이용자에게 어떤 메시지로 노출되는지 함께 볼 수 있어요. 연동이나 QA 과정에서 특정 코드를 만났을 때 원인을 빠르게 파악하고, 이용자 안내 문구를 확인하는 용도로 활용 가능해요.
노출 대상 표기 예시
ㆍ 이용자 일반 이용자에게 노출되는 메시지·팝업이에요.
ㆍ 개발자 QA 혹은 개발 담당자에게만 노출되고 일반 이용자에게는 노출되지 않아요.
Mobile SDK
모바일 SDK를 통한 로그인·인증·계정 처리 과정에서 반환되는 에러 코드예요. 발생은 플랫폼에서, 노출은 게임 앱(모바일)에서 이뤄져요.
| 코드 | 상황 설명 | 이용자 메시지 | 노출 대상 |
|---|---|---|---|
| 1002 1003 1005 1007 1008 1009 1010 |
스토브 앱간인증 실패 | 로그인 정보가 유효하지 않습니다. 다시 로그인해 주세요. |
이용자 |
| 10101 | 현재 패스워드 오류 | 입력하신 비밀번호가 일치하지 않습니다. 다시 한번 입력해 주세요. 확인 |
이용자 |
| 10124 | 이메일 플랫폼 가입 요청 | 이미 가입된 이메일입니다. 해당 이메일로 로그인하시거나 다른 이메일로 가입해 주세요. 로그인하기다른 이메일로 가입 |
이용자 |
| 10140 | 이미 사용중인 이메일 | 이미 가입된 이메일입니다. 해당 이메일로 로그인하시거나 다른 이메일로 가입해 주세요. 다른 이메일로 가입로그인하기 |
이용자 |
| 10171 | 패스워드 변경 실패 | 입력하신 비밀번호가 일치하지 않습니다. 다시 한번 입력해 주세요. 확인 |
이용자 |
| 10184 | 이메일인증 - 포맷 에러 문구 | 아이디가 이메일 형식인 계정만 변경할 수 있습니다. 확인 |
이용자 |
| 10200 | 패스워드 변경 - 동일 패스워드 변경 | 현재 사용 중인 비밀번호에요. 다른 비밀번호로 등록해 주세요. 확인 |
이용자 |
| 30302 | 구글 로그인 | ㆍ Google play의 사용이 중지되었습니다. 업데이트 삭제 및 재설치 후 다시 시도하세요. ㆍ Google play 인증 오류입니다. 계정 로그인 정보를 확인하세요. ㆍ Google play가 설치되지 않았거나, 최신버전이 아닙니다. ㆍ Google play 업데이트가 진행 중입니다. 업데이트 완료 후에 다시 시도하세요. |
이용자 |
| 40000 | 필수 파라미터 누락인 경우 | 요청을 처리하는 중에 문제가 발생했어요. 다시 시도해 주세요. 닫기 |
개발자 |
| 40101 40103 40104 40301 40303 40304 41005 41006 44062 44063 90001 |
토큰 오류 | 로그인 정보가 유효하지 않습니다. 다시 로그인해 주세요. |
이용자 |
| 41001 | client_id 또는 application_key가 잘못된 경우 | 잘못된 인증키입니다. 닫기 |
개발자 |
| 41002 | game_no 또는 game_id가 잘못된 경우 | 잘못된 게임 ID입니다. 닫기 |
개발자 |
| 41003 | 유저 Id 길이 체크 (모바일 4~47) | 사용자 ID는 최소 4자리 이상 입력해야 합니다. 닫기 |
이용자 |
| 41004 | 유저 Password 패턴 체크 | 비밀번호는 안전을 위해 영문, 숫자, 특수기호가 조합된 8~64자 이내의 문자로 생성해 주세요. 확인 |
이용자 |
| 41007 | 등록된 정보가 없기에 회원 가입이 필요할 경우 | 계정 또는 비밀번호를 다시 확인해 주세요. 확인 |
이용자 |
| 43000 | 유저 Id가 없거나 Password가 틀린 경우 | 계정 또는 비밀번호를 다시 확인해 주세요. 확인 |
이용자 |
| 43100 | 비밀번호 15회 오류로 로그인 제재 걸린 경우 | 로그인 시도가 계속 실패하여 로그인이 차단되었습니다. 닫기 |
이용자 |
| 43101 | 로그인 제재 (운영자 제재) | 접속 제한 계정입니다. 자세한 사항은 STOVE 웹사이트 로그인 후 확인이 가능합니다. 확인STOVE 바로 가기 |
이용자 |
| 43102 | 로그인 제재 (운영자 제재) | 로그인 시도가 계속 실패하여 로그인이 차단되었습니다. 자세한 사항은 STOVE 웹사이트 로그인 후 확인이 가능합니다. 확인STOVE 바로 가기 |
이용자 |
| 43103 | 중복 로그인 제재 | 중복 로그인 제재 계정입니다. 자세한 사항은 STOVE 웹사이트 로그인 후 확인이 가능합니다. 확인STOVE 바로 가기 |
이용자 |
| 43104 | 게임 제재 (모바일) | 서비스 이용 제한 상세 내용 및 제한기간 내용 확인고객센터 문의하기 |
이용자 |
| 43106 | 이메일 미인증 계정 로그인 잠금 | 로그인 시도가 계속 실패하여 일정 시간 로그인이 제한됩니다. 자세한 사항은 고객센터로 문의해 주시기 바랍니다. 닫기 |
이용자 |
| 43200 | 이메일인증 - 사용중인 이메일 시도 | 이미 사용 중인 이메일이에요. 다른 이메일 주소로 인증해 주세요. 확인 |
이용자 |
| 44000 | 휴면 계정 (미인증) | 회원정책 변경에 따라 최초 1회 본인확인이 필요합니다. 자세한 사항은 STOVE 웹사이트 로그인 후 확인이 가능합니다. 닫기 |
이용자 |
| 44000 | 휴면 계정 (본인인증) | 오랫 동안 접속하지 않아 계정 정보 보호를 위해 접속이 제한되었습니다. 계정을 다시 활성화하시겠습니까? 활성화취소 |
이용자 |
| 44001 | 탈퇴요청 상태인 경우 | 탈퇴 신청일 : "날짜" 탈퇴 신청일로부터 15일 이내 탈퇴 신청 취소 시 정상적인 서비스 이용이 가능합니다. 탈퇴취소닫기 |
이용자 |
| 44002 | 탈퇴요청 후 15일 이후부터 탈퇴완료까지 | 탈퇴 신청이 완료되어 삭제될 예정입니다. STOVE 서비스 이용을 원하시는 경우 다른 계정으로 로그인하시거나 회원 가입 후 이용해 주세요. 확인 |
이용자 |
| 44004 | 해외 로그인 차단 | 해외 로그인 차단 계정입니다. 자세한 사항은 STOVE 웹사이트 로그인 후 확인이 가능합니다. 확인STOVE 바로 가기 |
이용자 |
| 44007 | 원격 로그아웃으로 자동로그인 불가한 경우 | 원격 로그아웃 되었습니다. 다시 로그인해 주세요. 닫기 |
이용자 |
| 44008 | 계정 연결로 게스트 자동로그인 불가한 경우 | STOVE 정회원 계정으로 연결이 완료되었습니다. 해당 계정으로 로그인 시도해 주세요. 닫기 |
이용자 |
| 44009 | 비밀번호 변경으로 자동로그인 불가한 경우 | 비밀번호가 변경되었습니다. 다시 로그인해 주세요. 닫기 |
이용자 |
| 44010 | 유효하지 않은 Refresh Token으로 호출했을 경우 | 로그인 정보가 유효하지 않습니다. 다시 로그인해 주세요. 닫기 |
이용자 |
| 45000 | 정회원 연결된 guid | 해당 계정에 이미 게임 플레이 정보가 존재하여 연결할 수 없습니다. 다른 계정에 연결해 주세요. 확인 |
이용자 |
| 45004 | 다른 guid와 연결된 채널 유저 (main provider) | 이 계정은 게임 이용 이력이 있어 연결할 수 없어요. 다른 계정을 선택해 주세요. 확인 |
이용자 |
| 45005 | 이미 존재하는 guid를 생성할 경우 | 이미 가입한 회원입니다. | 이용자 |
| 45006 | guid가 존재하지 않을 경우 | 가입한 회원 정보가 없거나, 찾을 수 없습니다. | 이용자 |
| 45011 | 다른 guid와 연결된 채널 유저 (sub provider) | 다른 계정(%s)에 연결된 계정입니다. 연결 해제를 먼저 해 주세요. 확인 |
이용자 |
| 46001 | 아동 보호자 동의 완료 버튼 (세션 만료) | 인증 시간이 지났어요. 처음부터 다시 시도해 주세요. |
이용자 |
| 46003 | 이메일인증 - 메일 발송 제한 | 메일 발송 횟수를 모두 사용했어요. 1 시간 뒤에 다시 시도해 주세요. 확인 |
이용자 |
| 46005 | 보호자 이메일 인증 토큰이 없거나, 보호자 이메일 인증이 되지 않음 | 요청을 처리하는 중에 문제가 발생했어요. 다시 시도해 주세요. |
이용자 |
| 46006 | 보호자 동의를 받을 필요 없는 유저에게 보호자 동의를 요청한 경우 | 중복된 요청입니다. | 이용자 |
| 46007 | 이메일인증 - 이미 인증된 메일 | 이미 이메일 인증이 완료되었어요. 확인 |
이용자 |
| 46207 | 이메일인증 - 잘못된 인증 세션 | 인증이 완료되었는지 확인할 수 없어요. 인증 상태를 다시 확인해 볼게요. 확인 |
이용자 |
| 46350 | 보호자 이메일 중복 허용 수 초과 | 보호자의 이메일과 같은 이메일로는 가입할 수 없어요. | 이용자 |
| 46600 | 보호자 이메일과 가입하려는 이메일이 같음 | 이 이메일은 이미 5개 아동 계정에 등록되어 있어요. | 이용자 |
| 49104 | 요청 거부 (단기 제재) | 비정상적인 로그인 시도가 감지되었습니다. 잠시 후에 다시 시도해 주세요. | 이용자 |
| 49500 49501 |
운영자 제재 IP | 접속이 허용되지 않은 IP입니다. 고객센터에 문의해 주세요. 확인STOVE 바로 가기 |
이용자 |
| 49600 | 제재 Device | 정상적인 기기에서만 이용 가능합니다. 오류가 계속된다면 고객센터로 문의해 주세요. 닫기 |
이용자 |
| 49701 | 캡챠 - 유효하지 않은 캡챠 Key | 문자를 새로 고침 후 다시 입력해 주세요. | 이용자 |
| 49702 | 캡챠 - 문자 오입력 | 문자를 다시 확인 후 입력해 주세요. | 이용자 |
| 49703 | 캡챠 - 타임 아웃 | 인증 시간이 지났어요. 처음부터 다시 시도해 주세요. |
이용자 |
| 70819 | 게임 탈퇴 - 해지 유예 상태를 이미 취소한 유저 | 탈퇴 유예 기간이 지나 계정이 삭제되었어요. 확인 |
이용자 |
| 406710 | 게임해지 조회 - 게임 이용을 해지한 아이디 | 게임 탈퇴가 진행 중이에요. 처리 완료 예정 : %s 탈퇴를 취소하시면 게임을 계속 이용하실 수 있어요. 탈퇴취소취소 |
이용자 |
PC 클라이언트
게임 실행 단계에서 스토브 플랫폼이 판단해 PC 클라이언트에 노출하는 에러 코드예요.
이 표의 코드는 모두 이용자에게 메시지로 노출되며, 에러 코드 숫자 자체는 표시하지 않아요.
| 코드 | 상황 설명 | 이용자 메시지 | 노출 대상 |
|---|---|---|---|
| 400000 | 잘못된 요청 (파라미터 오류 등) | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해 주세요 확인 |
이용자 |
| 401401 | 인증 실패 | _게임명_ 게임 실행 권한이 없습니다. 확인 |
이용자 |
| 403201 | 제재 - 게임 실행 제재 | 이용 제한 안내✕ 요청하신 서비스는 아래의 사유로 이용이 제한되었습니다. 이용 제한 또는 이의 제기 관련 문의는 고객센터를 이용해 주세요 제한 사유_제한사유_ 제한 기간_제한 기간_ 상세 내용_ 내용 _ 닫기고객센터 |
이용자 |
| 403202 | 제재 - 선택적 본인인증 제재 | 이용 제한 안내✕ 요청하신 서비스는 아래의 사유로 이용이 제한되었습니다. 이용 제한 또는 이의 제기 관련 문의는 고객센터를 이용해 주세요 제한 사유_제한사유_ 제한 기간_제한 기간_ 상세 내용_ 내용 _ 닫기본인 확인 |
이용자 |
| 403300 | 스토어 게임 예외 발생 — value 값에 따라 처리 필요 | value 값(95000~95010)에 따라 처리가 달라져요. | 이용자 |
| 403401 | 테스트 게임 실행권한 없음 | _게임명_ 게임 실행 권한이 없습니다. 확인 |
개발자 |
| 403500 | 환불 내역이 있음 | 모바일 마켓(Google, Apple 등)에서 환불하신 상품으로 인하여 일시적으로 게임 이용이 제한 되었습니다. 환불하신 마켓의 모바일 게임에 접속하여 해당 상품을 재결제 하신 후 게임을 이용하실 수 있습니다. 닫기고객센터 문의 |
이용자 |
| 404000 | 게임정보 조회 실패 | 게임 정보 확인에 실패하였습니다. 재시도 후. 오류가 계속될 경우 도움말을 확인해 주세요 닫기도움말 보기 도움이 더 필요하신가요? ▼ |
이용자 |
| 404001 | 게임 client key가 유효하지 않음 | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해 주세요 확인 |
이용자 |
| 404200 | 약관조회 실패 - 약관 등록여부 확인 필요 | 해당 게임의 서비스 이용 약관을 확인할 수 없습니다. 다시 시도해 주세요. 닫기고객센터 도움이 더 필요하신가요? ▼ |
이용자 |
| 406101 | 사전 다운로드 기간 | 사전 다운로드 기간입니다. 공식 홈페이지에서 정식 오픈일정을 확인해주세요. |
이용자 |
| 406102 | 클라이언트 이용불가 기간 | 지금은 게임을 이용할 수 없습니다. 잠시 후 다시 시도해 주세요. 확인 |
이용자 |
| 406202 | 실행가능 국가 아님 (전시) | _게임명_ 해당 국가에서는 실행할 수 없습니다. 확인 |
이용자 |
| 406203 | 실행가능 국가 아님 (판권) | _게임명_ 해당 국가에서는 실행할 수 없습니다. 확인 |
이용자 |
| 406300 | 생년월일 확인 필요 | 게임 이용을 위해 연령 확인이 필요합니다. 생년월일 년 월 일 - 셀렉트박스 입력하신 연령 정보에 관련된 모든 책임은 본인에게 있습니다. 닫기확인 |
이용자 |
| 406301 | 게임 이용 가능한 연령이 아님 | 게임 이용 가능한 연령이 아닙니다. 확인 |
이용자 |
| 406302 | 본인인증 필요 | 본인인증이 필요합니다. 인증을 진행해주세요. 닫기확인 |
이용자 |
| 406303 | 보호자 동의 필요 | 보호자 동의가 필요한 아이디입니다. 보호자 동의를 진행해주세요. 닫기확인 |
이용자 |
| 406304 | 이메일 인증 필요 | 이메일 인증이 필요합니다. 인증을 진행해 주세요. 닫기확인 |
이용자 |
| 406400 | 서비스 이용 약관 동의 필요 | 약관동의페이지 노출 | 이용자 |
| 406701 | 게임이용 해지상태(로아) - 게임플레이를 위해서는 이용해지 취소 필요 | 게임 이용을 해지한 아이디입니다. 게임을 플레이하려면 이용 해지를 취소해야 합니다. _게임명_ 게임 이용 해지를 취소하시겠습니까? 닫기취소 |
이용자 |
| 406710 | 게임이용 해지상태 - 게임플레이를 위해서는 이용해지 취소 필요 | 게임 탈퇴가 진행중입니다. 탈퇴 완료 예정 _탈퇴일시 표시_ 탈퇴 취소를 누르면 탈퇴가 철회되며, 바로 게임 플레이가 가능합니다. 닫기탈퇴 취소 |
이용자 |
| 407001 | PC/Mobile간 동일 계정 플레이를 위해 애플로그인이 아닌 다른 로그인 수단으로 전환 필요 | SNS 계정으로 로그인하셨네요! 해당 게임은 PC와 모바일에서 같은 SNS 계정으로 로그인해도 자동으로 연결되지 않아요. PC에서만 이용하기 모바일에서 하던 기록은 이어지지 않고, PC에서 새로 시작하게 돼요. PC와 모바일 모두 이용하기 SNS 계정을 다른 계정으로 전환하면 PC와 모바일에서 같은 캐릭터로 플레이할 수 있어요. 나중에 결정할게요. (지금 게임 플레이 하지 않음) |
이용자 |
| 407002 | 이미 게임세션이 연결되어있는 상태 (중복 로그인) | 이 계정으로 다른 PC에서 게임 실행 중입니다. 다른 PC의 실행을 종료하고 이 PC에서 실행할까요? 다른 PC에서 계속 실행이 PC에서 실행 |
이용자 |
| 500000 | game-checker 내부 오류 | 일시적으로 문제가 발생했습니다. 다시 시도해주세요. 재시도 후 오류가 계속될 경우 도움말을 확인해 주세요. 닫기도움말 보기 도움이 더 필요하신가요? ▼ |
이용자 |
| 500001 | 연동중인 외부 API 호출 오류 | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해 주세요 확인 |
이용자 |
| 500002 | 연동중인 외부 API 호출 문제로 서킷브레이커 발동 시 오류 | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해 주세요 확인 |
이용자 |
| 503100 | 게임 점검 중 | 점검중이므로 게임을 실행할 수 없습니다. 점검시간 종료 후 다시 시도해주세요. 확인 |
이용자 |
PC SDK
PC SDK는 숫자 코드가 아닌 문자열 상수로 에러를 반환해요. 발생은 플랫폼에서, 노출은 게임에서 이뤄져요.
| 에러 코드 | 상황 설명 | 이용자 메시지 | 노출 대상 |
|---|---|---|---|
| 19 (공통) INVALID_ACCESS_TOKEN | 유효하지 않은 토큰 사용, 게임 재시작 필요 | 로그인 세션이 만료되었습니다. 게임 종료 후 다시 실행해 주세요. 확인 |
이용자 |
| 22 (공통) HTTP_ERROR | 스토브 플랫폼과 HTTP 통신 오류로 기능 호출 실패 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 23 (공통) RESPONSE_ERROR | 응답에 잘못된 값 포함 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 24 (공통) RESPONSE_INVALID_CODE | 응답에서 응답 코드를 찾을 수 없음 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 25 (공통) RESPONSE_VALUE_IS_NULL | 응답 값 전체가 비어 있음 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 26 (공통) RESPONSE_INVALID_VALUE_FORMAT | 응답 값 포맷 오류 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 86 (Base) RENEW_TOKEN_MAX_RETRY_COUNT_EXCEEDED | 토큰 자동 갱신 재시도 횟수 초과, 게임 재시작 시 해결 | 네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. 확인 |
이용자 |
| 253 (공통) UNMANAGED_EXCEPTION | 예상치 못한 알 수 없는 예외 발생 | 일시적으로 문제가 발생했습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 254 (공통) MANAGED_EXCEPTION | 내부에서 예상된 예외 발생 | 일시적으로 문제가 발생했습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 85 (IAP) PARAMETER_LENGTH_EXCEEDED | StartPurchase 매개변수 길이 초과 | 결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 86 (IAP) INVALID_JSON_STRING | StartPurchase extraData JSON 형식 오류 | 결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 88 (IAP) INVALID_ORDER_PRODUCT_INFORMATION | StartPurchase 상품 수량·금액 값 오류 | 결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 87 (IAP) WEBVIEW_CREATE_COOKIE_FAIL | 결제 웹뷰 Cookie 설정 실패 | 페이지를 불러올 수 없습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 87 (View) NO_POPUP_DATA | 팝업 데이터·설정 없음, 파트너스 설정 확인 필요 | 팝업 설정 정보가 존재하지 않아 표시할 창이 없습니다. 확인 |
개발자 |
| 84 (IAP) WEBVIEW_CLOSED_BEFORE_PURCHASE | 구매 완료 전 결제 웹뷰 닫힘, 오류 아님 | 구매가 정상적으로 완료되지 않았습니다. 다시 시도해 주세요. 확인 |
이용자 |
| 86 (View) WEBVIEW_CREATE_COOKIE_FAIL | 약관 동의 웹뷰 Cookie 설정 실패 | 구매를 위해서는 약관 동의가 필요합니다. 현재 약관 동의 화면을 불러오지 못했습니다. 다시 시도해 주세요. 확인 |
이용자 |
같은 코드가 서비스마다 다르게 쓰일 수 있어요
ㆍ 40101: Mobile SDK에서는 토큰 오류 그룹, PC 클라이언트/서버 인증에서는 액세스 토큰 관련으로 의미가 달라요.
ㆍ 41002·44000·49500·49701·49702·406710·WEBVIEW_CREATE_COOKIE_FAIL 등도 서비스·상황에 따라 상황 설명이 달라요.
ㆍ 코드만으로 판단하지 말고 반드시 발생 서비스와 상황 설명을 함께 확인해 주세요.
직접 문의하고 싶으신가요? stove.developers@smilegate.com