- 마지막 업데이트
Glossary (용어 사전)
용어 사전 안내
스토브 개발자센터 문서에 등장하는 주요 용어를 한곳에 모았어요. 본문은 한글 가나다순·영문 알파벳순으로 정렬되어 있고, 우측 빠른 메뉴에서 글자별로 바로 이동할 수 있어요. 특정 영역의 용어만 살펴보고 싶다면 아래 카테고리 색인을 이용하세요.
인증·로그인
19
환경·플랫폼
12
이벤트·메시징
10
점검·업데이트
8
이건 꼭 알아 두세요 ㆍ 이 페이지의 용어는 스토브 개발자센터 문서 전반에서 공통으로 사용돼요. ㆍ 각 용어의 상세 동작과 연동 방법은 해당 기능의 이용 시나리오 또는 기능 별 가이드에서 확인할 수 있어요.
ㄱ
| 용어 | 설명 | 비고 |
|---|---|---|
| 간편인증 | 본인인증의 대조용 수단. CI 확인이 불가해 본인 여부 대조에만 사용 | 인증·로그인 |
| 게스트 | 가입 없이 기기 단위로 게임을 시작한 이용자. GUID만 발급되며 MemberNo 없음. 모바일 게임 전용 | 회원·계정 |
| 게임 프로필 | 커뮤니티에 캐릭터 닉네임·레벨을 노출하기 위한 별도 호출 API. 캐릭터 등록과 별개로 호출해야 반영 | 캐릭터·커뮤니티 |
| 게임 해지 (이용해지) | 특정 게임의 캐릭터·재화·월드 정보를 삭제하는 탈퇴. 스토브 계정은 유지되어 다른 게임은 계속 이용 가능 | 탈퇴 |
| 게임 해지 완료 API | 탈퇴 요청 API 호출 후 이어서 호출해야 게임 데이터가 실제 삭제됨. API Access Token 필요. 호출 순서 준수 필수 | 탈퇴 |
| 게임 해지 요청 API | 이용자가 탈퇴를 확인했을 때 먼저 호출하는 API. User Access Token 필요 | 탈퇴 |
| 게임 화이트리스트 | 점검 중에도 게임 서버 레벨에서 접근을 허용할 계정 목록. 게임 운영툴에 등록 | 점검·업데이트 |
| 결제 완료 알림 (Noti) | 결제 완료 후 빌링 미들웨어가 게임 서버로 전달하는 상품 지급 요청. 처리 실패 시 1~5분 간격으로 최대 100회 재전송 | 결제·빌링 |
| 계정 전환 | 로그인 화면에서 이메일 회원과 SNS(3rd party) 회원 계정을 서로 전환하는 기능. 멀티플랫폼 게임은 스토브 로그인 수단이 모두 적용되어 계정 간 전환 가능 | 회원·계정 |
| 구독 상품 | 지정 주기마다 자동 갱신되는 결제 상품. Google Play·Apple App Store 지원, SDK v2.6.0 이상 필요. 자동 갱신형만 지원 | 결제·빌링 |
| 기기 등록 | 이용자가 지정한 기기에서만 게임 접속·로그인을 허용하는 보안 기능. 정회원 전용 | 보안 |
ㄴ
| 용어 | 설명 | 비고 |
|---|---|---|
| 뉴스 팝업 | 공지·이벤트 배너를 한 화면에 모아 보여주는 팝업. 배너 클릭 시 랜딩 URL 또는 커뮤니티 페이지로 연결 | 이벤트·메시징 |
| 닉네임 중복 조회 | 캐릭터 닉네임 등록·수정 전 반드시 수행하는 중복 확인 절차. 플랫폼 내 닉네임 중복 불가 | 캐릭터·커뮤니티 |
ㄹ
| 용어 | 설명 | 비고 |
|---|---|---|
| 리소스 업데이트 | 앱 바이너리 업데이트 없이 CDN을 통해 게임 리소스만 패치하는 방식. 버전 관리와 판단은 CP사가 구현 | 점검·업데이트 |
ㅁ
| 용어 | 설명 | 비고 |
|---|---|---|
| 무결성 검증 | 실행파일·DLL 등의 위·변조 여부를 확인하는 보안 기능(보안 SDK 제공) | 보안 |
ㅂ
| 용어 | 설명 | 비고 |
|---|---|---|
| 보조 이메일 | 계정 보안을 위해 추가로 등록하는 이메일. 기기 등록·계정 보호 등에서 본인 확인 수단으로 활용. 1시간에 최대 5회 인증 요청 가능 | 인증·로그인 |
| 보호자 인증 | 미성년 이용자 가입 시 법정대리인 동의 확인 절차. 대한민국은 보호자 휴대폰 실명 인증, 글로벌은 보호자 이메일 인증 | 인증·로그인 |
| 본인 확인 | 이용자 본인 여부를 확인하는 스토브 서비스. 신원(실명)을 확인하는 본인인증과 휴대폰 번호 소유를 확인하는 휴대폰 점유인증을 함께 제공 | 인증·로그인 |
| 본인인증 | 대한민국 이용자에게 적용되는 실명 인증 절차. 휴대폰 인증(PASS 포함)·토스인증·간편인증 수단 사용. 웹·PC 경로 가입 시 필수 | 인증·로그인 |
| 비정상 환불 | 이용자가 아이템 수령 후 마켓을 통해 직접 결제를 취소한 경우. 스토브 빌링이 5분 주기로 환불 목록을 게임 서버에 전달 | 결제·빌링 |
ㅅ
| 용어 | 설명 | 비고 |
|---|---|---|
| 선택 업데이트 | 이용자가 업데이트 여부를 선택할 수 있는 방식. 접속 중 이용자는 Kick하지 않으며 다음 앱 실행 시 안내 | 점검·업데이트 |
| 수동 팝업 | 특정 UI 터치 또는 화면 진입 시 지정 위치(location)에 노출하는 팝업. 노출 시점을 CP사가 직접 제어 | 이벤트·메시징 |
| 스토브 PC 클라이언트 | 스토브가 제공하는 PC 게임 설치·실행·업데이트·점검 안내 프로그램 | 환경·플랫폼 |
| 스토브 계정 | 스토브 회원으로 가입한 계정. 회원당 최대 5개 생성 가능하며, 게임 이용 동의 시 GUID 발급 | 회원·계정 |
| 스토브 빌링 미들웨어 | 마켓 결제 처리·유효성 검증·알림 전달을 담당하는 스토브의 빌링 중계 서버 | 결제·빌링 |
| 스토브 이벤트 (Callback) | 탈퇴 상태 변경 시 스토브가 CP사 서버로 실시간 전달하는 Callback. 탈퇴 신청(GAME_WITHDRAW)·탈퇴 취소(GAME_WITHDRAW_CANCEL)·탈퇴 완료(GAME_WITHDRAW_COMPLETE)·스토브 회원 탈퇴(PLATFORM_WITHDRAW) | 탈퇴 |
| 스토브 플랫폼 닉네임 | 스토브 계정의 표시 이름. 게임 캐릭터 닉네임을 연동하지 않은 경우 커뮤니티 등에서 기본값으로 노출. 플랫폼 닉네임을 설정하지 않으면 'stove+숫자' 형식의 자동 발급 ID가 표시됨 | 캐릭터·커뮤니티 |
| 스토브 회원 탈퇴 | 스토브 계정 자체와 연결된 모든 게임 데이터를 삭제하는 탈퇴. 요청일 포함 15일 유예 후 30일에 최종 완료 | 탈퇴 |
ㅇ
| 용어 | 설명 | 비고 |
|---|---|---|
| 월드 | 게임의 서버 또는 채널을 구분하는 단위. 파트너스에 world_id로 사전 등록 필요 | 캐릭터·커뮤니티 |
| 유예기간 | 탈퇴 요청 후 실제 데이터가 삭제되기 전까지 이용자가 취소할 수 있는 기간. 유예 중에는 게임 접속 시 탈퇴 진행 중 안내 화면 노출 | 탈퇴 |
| 이메일 인증 | 가입 이메일 주소의 소유 여부를 확인하는 절차. 4자리 인증코드, 유효시간 10분. CP사가 on/off 설정 가능 (SDK 2.8.0 이상, 기본값 필수) | 인증·로그인 |
| 이용자 | 스토브 플랫폼과 게임 서비스를 이용하는 사람. 정회원과 게스트로 구분 | 회원·계정 |
| 이용자 Kick | 점검 또는 필수 업데이트 시 게임에 접속 중인 이용자를 강제 종료·재시작하는 처리. CP사가 구현 | 점검·업데이트 |
| 인게임 캡챠 | 게임 서버 진입·인게임 거래 등에 CP사가 직접 적용하는 캡챠. 노출 시점·대상·빈도를 CP사가 결정 | 보안 |
| 일회용 로그인 번호 | 스토브 앱 로그인 계정 기준으로 발급되는 8자리 숫자. PC 웹·PC 클라이언트에서 비밀번호 없이 로그인 가능. 유효시간 60초 | 인증·로그인 |
ㅈ
| 용어 | 설명 | 비고 |
|---|---|---|
| 자동 갱신형 구독 | 약정 주기마다 자동으로 결제·갱신되는 구독 상품. Google Play·Apple App Store에서 지원하며, 갱신 알림 수신을 위해 마켓별 서버 알림(Pub/Sub·App Store Connect) 설정 필요 | 결제·빌링 |
| 자동 팝업 | 인게임 진입 시 이용자 터치 없이 전면 팝업을 순차적으로 노출. 이벤트·광고 배너 용도 | 이벤트·메시징 |
| 점검 타입 (PC) | PC 게임 점검 종류. 정기·긴급·임시·사전 다운로드·이용불가(클라이언트) 5종. 타입에 따라 노출 위치와 방식이 달라짐 | 점검·업데이트 |
| 점유인증코드 | 휴대폰 점유인증 시 스토브 SMS API로 발송되는 6자리 인증번호 | 인증·로그인 |
| 정회원 | 이메일 또는 SNS 계정으로 정식 가입한 이용자. MemberNo 발급, 결제·기기 등록·쿠폰 등 전체 서비스 이용 가능 | 회원·계정 |
| 정회원 전환 | 게스트가 이메일 가입 또는 SNS 연동으로 정회원이 되는 절차. 기존 게스트 게임 데이터가 정회원 계정으로 연결 | 회원·계정 |
| 지정 PC | 미리 등록한 특정 PC에서만 로그인을 허용하는 보안 정책. 대한민국 가입 계정이 PC 런처로 로그인할 때 활성화 | 보안 |
| 직접 지급 방식 | 쿠폰 사용 처리 즉시 게임 서버로 보상 지급을 요청하는 방식 | 이벤트·메시징 |
ㅋ
| 용어 | 설명 | 비고 |
|---|---|---|
| 캐릭터 | 이용자 계정에 귀속된 게임 캐릭터. 닉네임·레벨·월드 정보를 스토브에 등록하면 플랫폼 전반의 서비스에서 활용 가능 | 캐릭터·커뮤니티 |
| 캡챠 레벨 | 캡챠의 난이도. 1(가장 낮음)부터 7(가장 높음)까지 7단계로 구성 | 보안 |
| 커뮤니티 웹뷰 | 스토브 커뮤니티 홈을 로그인 유지 상태로 노출하는 팝업. SDK 커뮤니티 인터페이스 사용 필수 | 이벤트·메시징 |
| 쿠폰 박스 방식 | 쿠폰을 이용자의 쿠폰박스에 등록한 후 별도 사용 단계에서 보상을 지급하는 방식 | 이벤트·메시징 |
| 쿠폰 팝업 | SDK 기반으로 인게임에서 직접 쿠폰 번호를 입력받는 팝업. Android 전용(iOS는 앱 외부 웹 처리), PC는 멀티플랫폼 게임 전용 | 이벤트·메시징 |
ㅌ
| 용어 | 설명 | 비고 |
|---|---|---|
| 통합 로그인 | 여러 로그인 수단을 한 화면에서 제공하는 로그인 UI(AuthUI.Login) | 인증·로그인 |
ㅍ
| 용어 | 설명 | 비고 |
|---|---|---|
| 파트너스 | 스토브가 제공하는 백오피스 운영툴. 회원·결제 기록 조회, 푸시 발송, 점검 설정 등 게임 서비스 관련 기능 제공 (Sandbox: partner.gate8.com / Live: partner.onstove.com) | 환경·플랫폼 |
| 플랫폼 캡챠 | 회원가입·로그인 등 스토브 플랫폼 인증 동선에 적용되는 캡챠. 위험 감지 시 자동 노출되며 CP사 연동 불필요 | 보안 |
| 플랫폼 화이트리스트 | 점검 중에도 SDK·런처 레벨에서 접근을 허용할 디바이스 목록. 파트너스에 디바이스 ID로 등록 | 점검·업데이트 |
| 필수 업데이트 | 반드시 업데이트해야 게임에 진입할 수 있는 방식. 접속 중인 미업데이트 이용자에게 Kick 적용 | 점검·업데이트 |
ㅎ
| 용어 | 설명 | 비고 |
|---|---|---|
| 휴대폰 점유인증 | 휴대폰 번호의 소유(점유) 여부를 확인하는 절차. 스토브 SMS로 6자리 인증번호 발송, 유효 3분. 실명 확인이 아니며 계정 단위로 전 게임에서 공통 사용. 재발송 1분 3회·1일 20회(동일 게임+번호 기준) | 인증·로그인 |
A
| 용어 | 설명 | 비고 |
|---|---|---|
| ACL | 스토브↔게임 서버 호출에 필요한 접근 제어 목록(Access Control List). Inbound/Outbound 방화벽 설정에 사용 | 보안 |
| API Access Token | 스토브 API 서버 호출과 서버 인증에 사용하는 토큰. 유효기간 30일. authorization 헤더에 포함하여 전달. 퍼블리싱 기술 담당자가 발급 | 인증·로그인 |
B
| 용어 | 설명 | 비고 |
|---|---|---|
| Base SDK | PC SDK의 코어(공통) 모듈. Base_Initialize 등 Base_* API로 초기화·기본 연동을 담당 | 환경·플랫폼 |
C
| 용어 | 설명 | 비고 |
|---|---|---|
| CI (연계정보) | 본인인증 시 생성되는 개인 식별 연계정보(Connecting Information). 동일인 여부 판별에 사용되며, 동일 CI로 스토브 계정을 최대 5개까지 보유 가능 | 회원·계정 |
| CP페이지 | 게임 공식 홈페이지(스토브 게임 페이지). PC 정기점검·사전 다운로드 안내가 노출되는 위치 중 하나 | 환경·플랫폼 |
| Captcha Key | 한 번의 캡챠 노출마다 발급되는 식별자. 캡챠 이미지와 함께 발급되며, 검증 시 이용자 입력 값과 함께 전달 | 보안 |
F
| 용어 | 설명 | 비고 |
|---|---|---|
| FCM / APNS / ADM | Android(FCM)·iOS(APNS)·Fire OS(ADM) 단말기에 푸시를 전달하는 각 플랫폼의 메시징 서비스 | 이벤트·메시징 |
G
| 용어 | 설명 | 비고 |
|---|---|---|
| GDS | 현재 접속한 이용자의 국가 정보(Global Domain Service). 스토브 SDK가 초기화 후 조회 | 환경·플랫폼 |
| GNB | 스토브 웹 상단의 글로벌 내비게이션 바. 웹 로그인·인증 진입 지점의 하나 | 환경·플랫폼 |
| GPG | Google Play Games 로그인 연동(Android) | 인증·로그인 |
| GUID | 게임별로 발급되는 이용자 고유 식별자. 게스트는 기기에 종속되며, 정회원 전환 시 MemberNo로 연결. MemberNo와 Game ID 조합 개념 | 회원·계정 |
I
| 용어 | 설명 | 비고 |
|---|---|---|
| IAP (In-App Purchase) | 모바일 인앱 결제. 각 마켓(Google Play·Apple App Store 등)의 결제 시스템을 통해 처리 | 결제·빌링 |
| ItemBox (아이템박스) | 쿠폰 사용 조건이 충족됐을 때 게임 서버로 아이템 지급 정보를 실시간 전달하는 스토브 중계 서버. AES256 암호화, 전송 실패 시 30초 간격 최대 5회 재전송 | 이벤트·메시징 |
L
| 용어 | 설명 | 비고 |
|---|---|---|
| Live (운영) | 실제 서비스 환경. QA 완료 후 배포. API Host: https://api.onstove.com | 환경·플랫폼 |
| LTS | SDK가 지원하는 언어·런타임의 장기 지원 버전(Long-Term Support). 예: Java 25 LTS | 환경·플랫폼 |
M
| 용어 | 설명 | 비고 |
|---|---|---|
| MemberNo | 정회원 가입 완료 시 스토브가 발급하는 플랫폼 고유 식별번호. 이용자 식별 기준값이며 계정 유지 시 불변 | 회원·계정 |
| Mobile SDK | 모바일 게임에 스토브 서비스를 연동하기 위한 SDK. 인증·결제·팝업·기기 등록 등 모듈 제공 | 환경·플랫폼 |
O
| 용어 | 설명 | 비고 |
|---|---|---|
| OAuth | 스토브 서버 인증을 위한 프로토콜. 로그인 후 발급받은 Authorization Code를 Access Token으로 교환 | 인증·로그인 |
| OOAP | 모바일 상품 구매 타입의 하나. 구독 상품의 갱신·만료일 변경 등에 사용(IAP_OOAP) | 결제·빌링 |
| OTP | 일회용 비밀번호 인증기를 이용한 2단계 인증(One-Time Password) | 보안 |
P
| 용어 | 설명 | 비고 |
|---|---|---|
| PASS | 통신사 기반 휴대폰 실명 인증 서비스. 본인인증 수단의 하나(토스인증과 함께) | 인증·로그인 |
| PC SDK | PC 게임에 스토브 서비스를 연동하기 위한 SDK(PC SDK 3.0). 코어 모듈인 Base SDK와 PC방 전용 PCBang SDK 등으로 구성 | 환경·플랫폼 |
| PG | 결제 대행사(Payment Gateway). 주요 결제수단은 2개 이상 PG로 연동되어 장애 시 대체 연결 | 결제·빌링 |
Q
| 용어 | 설명 | 비고 |
|---|---|---|
| QR 코드 로그인 | PC 웹·클라이언트의 QR 코드를 스토브 앱으로 스캔해 로그인하는 방식. 비밀번호·추가 인증 불필요. OTP 인증기 설정 완료 정회원 전용 | 인증·로그인 |
R
| 용어 | 설명 | 비고 |
|---|---|---|
| Refresh Token | User Access Token 재발급용 토큰. 유효시간 30일. 재발급 시 함께 갱신되어 로그인 유지에 사용 | 인증·로그인 |
S
| 용어 | 설명 | 비고 |
|---|---|---|
| Sandbox (샌드박스) | Live 환경 적용 전 테스트 환경. 개발·QA 테스트 전용이며 실 이용자에게 영향을 주지 않음. API Host: https://api.gate8.com | 환경·플랫폼 |
| SDI | 본인인증 Type2에서 CI를 단방향 암호화한 식별값. CI를 저장하지 않고 SDI만 전달하는 방식에 사용 | 인증·로그인 |
| SDK 점검 팝업 | 앱 최초 실행(initialize) 시 스토브 SDK가 자동으로 노출하는 점검 안내 팝업(모바일). 안내 목적이며 실제 접속 차단은 별도 구현 필요 | 점검·업데이트 |
| SNS 가입 | Google·Apple·Facebook·Naver·Line·Steam 등 외부 계정 인증을 통한 스토브 계정 생성 방식. 별도 비밀번호 불필요 | 인증·로그인 |
| SSO | 인게임에서 외부 브라우저로 스토브 로그인 상태를 이어주는 웹 연동(Single Sign-On) | 인증·로그인 |
| SUAT | 스토브 Web 인증(GNB·로그인 URL)에서 발급되는 Cookie 기반 Web Access Token. 게임 공식 홈페이지·이벤트 페이지 등에서 사용 | 인증·로그인 |
T
| 용어 | 설명 | 비고 |
|---|---|---|
| TID | 스토브 빌링이 결제 건마다 발급하는 고유 주문번호. 게임 서버에 저장해 중복 지급 방지에 사용 | 결제·빌링 |
| transaction_id | ItemBox 지급 요청 식별자. 게임 서버에 저장해 중복 지급 방지에 사용 | 이벤트·메시징 |
U
| 용어 | 설명 | 비고 |
|---|---|---|
| UDID / ADID | 모바일 기기 고유 식별자. 기기 등록 시 기기를 구분하는 기준값 | 보안 |
| User Access Token | 로그인 완료 후 발급되는 이용자 세션 인증 토큰. 유효시간 6시간. 만료 시 Refresh Token으로 자동 재발급. 캐싱 없이 실시간 조회 필수 | 인증·로그인 |
V
| 용어 | 설명 | 비고 |
|---|---|---|
| voided_tid | 재결제 시 원래 환불 건을 매칭하기 위해 전달되는 식별 필드 | 결제·빌링 |
W
| 용어 | 설명 | 비고 |
|---|---|---|
| world_id | 게임의 서버 또는 채널을 구분하는 단위. 캐릭터 등록 전 파트너스에 사전 등록 필요. 공백 포함 불가 | 환경·플랫폼 |
직접 문의하고 싶으신가요? stove.developers@smilegate.com