- 마지막 업데이트
STOVE 플랫폼이 지원하는 모바일·PC·웹 환경별 연동 범위와 흐름을 안내지원 플랫폼 안내
STOVE 플랫폼은 게임 서비스 환경에 따라 모바일, PC 온라인, 웹 세 가지 연동 방식을 지원해요. 환경에 따라 사용되는 SDK와 필수 연동 항목이 다르므로, 서비스 특성에 맞춰 연동 내용을 확인해 주세요.
모바일 게임 출시를 위해서는 사용자 인증, 과금, 프로모션, 알림 등 공통 기능의 구현이 필요해요. STOVE 플랫폼은 회원가입 및 인증, 결제 시스템(과금), 프로모션, 푸시 알림, 커뮤니티 등의 기능을 SDK 및 서버 API 형태로 제공하므로, 게임사는 직접 개발 없이 SDK 호출과 API 연동만으로 대부분의 기능을 구현할 수 있어요.
게임 엔진별 STOVE SDK와 STOVE 서버 API를 제공해요. SDK는 Unreal / Unity / Native 엔진을 지원하고, 서버 API는 Rest API / Event Callback API 형태로 제공돼요.
| 구분 | 형태 | 연동 항목 | 필수 여부 |
|---|---|---|---|
| 인증 | STOVE SDK | 회원가입, 인증(이메일·게스트·3rd-party 등), 내 정보 변경, 스토브 탈퇴 | 필수 |
| (Server) Access Token 유효성 검증 | 클라이언트에서 획득한 User Access Token을 서버에서 2차 검증 | 필수 | |
| (SDK/Server) 본인 인증 | 서버 이전, 신규 캐릭터 생성 등 특정 동선에서 휴대폰 등 본인 확인 기능 제공 | 선택 | |
| 결제 | STOVE SDK | 게임 내 유료 아이템 직접 구매 결제창 연동 | 필수 |
| 빌링 | (SDK) 비정상 환불 재결제 팝업 | 비정상 환불 유저 진입 시 스토브 재결제 상점 기능 연동 | 선택 |
| (Server) 결제 아이템 지급 처리 | 유저 결제 완료 후 빌링 미들웨어에서 유효성 검증, 게임 서버에 유료 아이템 지급 요청 | 필수 | |
| 프로모션 | STOVE SDK | 팝업, 쿠폰, 푸시 수신, 커뮤니티 연동 지원 | 필수 |
| (Server) 아이템박스 연동 | 스토브 쿠폰 및 웹 이벤트 참여 후 게임 서버에 보상 아이템(Itembox) 수신 처리 | 필수 | |
| 캐릭터 | (Server) 스토브 캐릭터 연동 | 게임에서 사용하는 캐릭터 정보를 플랫폼과 동기화하면 웹, 커뮤니티의 닉네임 노출 및 PC 빌링 RM 체크에 사용 | 필수 |
| 보안 | (SDK) 모바일 보안 모듈 | STOVE 모바일 보안 모듈을 통한 앱 변조 방지 및 비정상 접근·조작 차단 | 필수 |
모바일 연동은 다음 5단계 순서로 진행해요.
- SGP
- 개발사
- 개발사
STOVE 파트너스는 서비스 관리·운영에 사용되는 백오피스예요
앱 정보 등록부터 QA 환경 운영까지 파트너스를 통해 처리해요.
PC 연동은 게임이 STOVE 플랫폼에 입점하고 서비스되기까지의 전체 기술적 흐름을 다뤄요. 게임 클라이언트 및 서버와의 연동 항목, SDK 사용, 런처 설정, 인증, 결제, 부가 기능 등 전반적인 연동 절차와 주의사항이 포함돼요.
PC 환경에서 연동이 필요한 항목은 아래와 같아요.
| 대상 | 스토브 연동 항목 | 세부 내용 | 필수 여부 |
|---|---|---|---|
| 런처 | 실행 방식 | 스토브 런처를 통한 PC 게임 실행 | 별도 연동 불필요 |
| SDK | 게임 엔진 및 SDK 버전 | PC SDK 버전 (Unreal / Unity / Native) | 필수 |
| 인증 | (SDK) Access Token 조회 | 런처를 통해 전달받은 Game User Access Token 조회 | 필수 |
| (Server) Access Token 유효성 체크 | 2차 인증 런처를 통해 전달받은 User Access Token을 서버에서 2차 검증 | 필수 | |
| 빌링 | (SDK) 빌링 연동 방식 | 1) 직접 결제(게임 아이템 구매) 방식 게임에서 판매하는 아이템 직접 결제 (멀티플랫폼은 필수) 2) 게임 재화 플랫폼 이용 결제 방식 중 선택 게임의 2차 재화(게임캐시)를 플랫폼에서 관리하는 방식 | 필수 |
| (Server) 결제 아이템 지급 처리 | 유저 결제 완료 후 빌링 미들웨어에서 유효성 검증, 게임 서버에 유료 아이템 지급 요청 | 필수 | |
| 부가 기능 | (SDK) 선택적 셧다운 | (한국) 19세 미만 이용 게임은 요일별 특정 시간 이용 제한. 게임 중 셧다운 이벤트를 게임 서버로 전송 | 한국 필수 |
| (SDK) 과몰입 방지 | (한국) 게임 이용 시간 경과 내역을 1시간마다 안내 문구로 표시 (법 제12조의3 근거) | 한국 필수 | |
| (Server) 멤버십 | 회원 정보 조회, 회원 제재 정보 조회 | 선택 | |
| (Server) 캐릭터 | 게임에서 사용하는 캐릭터 정보를 플랫폼과 동기화하면 웹, 커뮤니티의 닉네임 노출 및 PC 빌링 RM 체크에 사용. 멀티플랫폼은 모바일 캐릭터 연동 서버 코드 재사용 가능 | 멀티플랫폼 필수 | |
| (Server) 아이템박스 연동 | 스토브 쿠폰 및 웹 이벤트 참여 후 게임 서버에 보상 아이템(Itembox) 수신 처리 | 필수 |
PC 연동은 다음 5단계 순서로 진행해요.
- SGP
- 개발사
- 개발사
멀티플랫폼 게임은 모바일 연동 자산을 재사용할 수 있어요
캐릭터 연동, 아이템박스 등 서버 API는 모바일과 PC가 공통 구조로 동작해요. 이미 모바일 연동이 완료된 게임이라면 PC 쪽에서는 런처·SDK 구간 중심으로 개발을 진행하면 돼요.
STOVE 플랫폼을 통해 웹 서비스(공식 홈페이지 등)를 연동하면 인증·게임 실행·회원·캐릭터·쿠폰·웹 로그 등 주요 기능을 웹에서 활용할 수 있어요. 웹 연동은 별도 SDK 없이 GNB 방식 또는 API 방식으로 제공되며, 서비스 특성에 맞춰 필요한 기능만 선택해 연동할 수 있어요.
웹 환경에서 연동이 필요한 항목은 아래와 같아요. 인증과 게임 실행은 필수 항목이며, 나머지는 서비스 특성에 따라 선택해요.
| 구분 | 형태 | 연동 항목 | 필수 여부 |
|---|---|---|---|
| 인증 | GNB 방식 / 로그인 URL 방식 | 웹에서 STOVE 인증 활용. GNB 방식은 빠른 연동이 가능하고, URL 방식은 자체 UI 구성에 적합 | 필수 |
| 게임 실행 | STOVE JS Service 방식 / API 방식 | 웹에서 런처 다운로드 및 실행. 런처 로그인 없이 웹 로그인 상태로 게임 실행 | 필수 |
| 회원 | (Server) 회원 정보 API | 사용자 인증 토큰 유효성 확인 및 회원 정보 조회 | 선택 |
| 캐릭터 | (Server) 캐릭터 API | 게임에서 사용하는 캐릭터 정보를 웹에 노출. STOVE 커뮤니티 등에 노출되는 메인 캐릭터 명 변경 | 선택 |
| 빌링 | (Server) 빌링 API | 로그인한 계정의 게임 캐시 잔액 정보 조회 | 선택 |
| 쿠폰 | (Server) 쿠폰 API | STOVE 플랫폼이 발행한 쿠폰을 웹에서 등록하여 인게임 보상(아이템·캐시 등) 지급. 직접 지급 방식 또는 아이템박스 수신 방식 중 선택 | 선택 |
| 웹 로그 | (Server) 웹 로그 API | 웹 상 이벤트 로그 적재. STOVE 지표(Stove Analytics)로 확인 | 선택 |
스토브 웹 서비스는 등록된 애플리케이션(앱) 정보를 기반으로 동작해요. 따라서 사전에 파트너스를 통해 서비스 별 정보를 등록해야 해요.
| 항목 | 설명 |
|---|---|
| 서비스 기본 정보 | GAME_ID, 런처 등 WEB 서비스 연동에 필요한 기본 정보 등록 |
| 약관 정보 | 게임 실행을 위해 필요한 약관 등록 (약관 타입·노출·내용 관리) |
| 쿠폰 발행 | 쿠폰 연동 시 파트너스를 통해 쿠폰 정책 및 발행 등록 |
등록정보를 확인하려면 먼저 파트너스 가입 및 메뉴 접근 권한이 부여되어 있어야 해요
파트너스 가입 및 권한 부여 방법은 입점 절차 안내에서 확인할 수 있어요.
웹 연동은 다음 5단계 순서로 진행해요. 기능별 연동은 서비스 특성에 따라 필요한 항목만 선택해요.