- 마지막 업데이트
게임 해지하기
스토브 가입
스토브 로그인
기기등록
게임진입
결제
기타설정
게임해지
스토브 탈퇴서비스 소개
이용자는 더 이상 플레이하지 않는 게임을 정리하고 싶을 때, 인게임에서 게임 해지(이용 해지)를 하거나 플랫폼에서 스토브 회원 탈퇴를 할 수 있어요. 게임 해지는 현재 게임과 연결된 정보(캐릭터·재화·월드 데이터 등)만 삭제하고 스토브 통합 계정은 그대로 유지되는 반면, 스토브 회원 탈퇴는 계정 자체를 삭제해요. 이 문서는 이용자가 인게임에서 게임 해지를 신청하고 취소하는 흐름을 중심으로 안내해요.
이용자가 해지를 신청하면, 게임사는 게임 해지 신청 API 하나만 호출하면 돼요. 이후 유예기간 경과 후 해지 완료 처리와 콜백 통지는 스토브가 담당해요. 게임 내 해지 버튼은 게임사가 구현하지만 실제 해지 기능은 스토브가 제공하며, 이용자는 스토브 웹의 게임 정보 화면이나 인게임 메뉴에서 해지를 신청할 수 있어요.
가입·해지 개념 구분
스토브 연동에서 '가입'과 '해지'는 스토브 계정 단위와 게임 단위로 나뉘어요. 이 문서가 다루는 게임 해지는 해당 게임만 정리하고 스토브 계정은 유지하는 반면, 스토브 탈퇴는 계정 자체를 삭제해 모든 게임 이용이 끝나요. 게임 가입(게임 이용약관 동의)의 반대 동작이 게임 해지라는 점을 기준으로 보면 이해하기 쉬워요.
| 구분 | 단위 | 의미 | 식별자 |
|---|---|---|---|
| 스토브 가입 | 스토브 계정 | 이메일·SNS로 스토브 계정 생성 | MemberNo 발급 |
| 게임 가입 | 게임 | 게임 진입 시 게임 이용약관 동의 | GUID 발급 |
| 게임 해지 | 게임 | 게임 이용 해지, 게임 데이터·캐릭터 삭제 (스토브 계정은 유지) | GUID 삭제 |
| 스토브 탈퇴 | 스토브 계정 | 스토브 계정 자체 삭제 (모든 게임 이용 해지) | MemberNo 삭제 |
이건 꼭 알아 두세요
ㆍ 게임 가입(게임 약관 동의)·로그인은 로그인하기 문서에서 확인하고, 게임 해지·스토브 탈퇴는 이 문서에서 안내해요.
ㆍ 게임 해지 프로세스의 '서비스 이용동의 해지' 단계는, 게임 가입 시 동의했던 게임 이용약관을 철회하는 동작이에요.
게임 해지 신청 프로세스
이용자가 인게임 또는 스토브 웹에서 해지를 신청하는 흐름이에요. 실수를 막기 위해 경고 안내와 컨펌 확인 단계를 반드시 포함해요.
게임 해지 신청 취소 프로세스
유예기간 중 이용자가 게임에 다시 접속하면 해지를 취소할 수 있어요. 취소하면 계정이 정상 상태로 돌아가 게임을 계속 이용할 수 있어요.
신청부터 완료까지 처리 흐름
해지 신청이 접수된 뒤 실제 완료까지, 게임사와 스토브가 나눠 처리하는 흐름이에요. 즉시 해지는 신청과 동시에 완료되고, 유예 해지는 유예기간 경과 후 스토브 배치 서버가 자동으로 완료 처리한 뒤 게임 서버로 결과를 전달해요.
이건 꼭 알아 두세요
· 게임 해지를 리세마라·계정 초기화 용도로 사용하지 마세요. 해지 시 GUID가 삭제되어 재가입하면 새 이용자로 처리돼요.
계정 초기화가 필요하면 스토브 캐릭터 삭제 API를 사용하고 담당자와 사전 협의해 주세요.
· 스토브 회원 탈퇴는 스토브가 직접 처리하므로, 게임사는 해지 완료 이벤트를 받아 인게임 데이터를 정리하면 돼요.
핵심개념
게임 해지를 연동하기 전, 아래 개념을 먼저 이해하면 이후 내용을 파악하기 쉬워요.
| 용어 | 내용 |
|---|---|
| 게임 해지 신청 | 이용자를 즉시 해지시키거나 해지 신청(유예) 상태로 만드는 기능. 게임사가 호출하는 유일한 해지 API 즉시 해지와 유예 해지를 구분해 호출 User Access Token 필요 (유효시간 6시간, 캐싱·서버 저장 금지, 호출 시점에 실시간 조회) |
| 유예기간 | 해지 신청 후 데이터가 삭제되기 전까지 이용자가 신청을 취소할 수 있는 기간. 게임별 0～30일 설정 0일이면 신청과 동시에 즉시 완료 유예 중 게임 접속 시 해지 진행 중 안내 화면 노출 |
| 해지 완료 배치 | 유예기간이 지난 해지 대상자를 스토브가 자동으로 완료 처리하는 배치. 게임사는 완료 처리를 직접 하지 않음 처리 시각: 한국 시간 기준 매일 00:00 |
| 해지 완료 콜백 | 해지 완료 시 스토브가 게임 서버로 결과를 전달하는 알림. 게임사는 이 알림을 받아 게임 데이터를 삭제 알림 수신을 위해 STOVE Event 기능 연동 필수 GUID 기반 게임 지원 (MemberNo 기반은 퍼블리싱 기술 담당자 확인 필요) |
| 해지 후 재가입 | 해지가 완료되면 GUID·캐릭터 정보가 삭제되어 복구할 수 없어요. 복구가 필요하면 유예기간 내 해지 취소로만 가능해요 해지 완료 후 동일 스토브 계정으로 재가입하면 신규 이용자로 처리 (GUID 기반 게임은 새 GUID 발급) |
이건 꼭 알아 두세요
GUID와 MemberNo는 스토브가 게임 이용자를 식별하는 번호 체계로, 게임 연동 방식에 따라 둘 중 하나를 사용해요.
· GUID — 기기·게임 단위로 발급. 해지 시 삭제되며 재가입하면 새 GUID 발급. STOVE Event 콜백 지원
· MemberNo — 스토브 계정 단위로 유지. 해지 후 재가입해도 동일 번호 유지. 콜백 미지원 (퍼블리싱 기술 담당자 확인 필요)
이용 시나리오
해지 신청 (즉시 해지)
이용자가 인게임 설정에서 해지를 요청하면 즉시 게임 데이터가 삭제돼요. 해지 후 복구가 불가능하므로 반드시 경고 안내와 컨펌 확인 단계를 제공해야 해요.
| 단계 | 처리 주체 | 내용 | 비고 |
|---|---|---|---|
| 1 | 이용자 → 게임 클라이언트 | 인게임 설정에서 해지 메뉴 진입 | 공통 |
| 2 | 게임 클라이언트 | 경고 안내 팝업 노출 (삭제 범위·복구 불가 안내) | 공통 |
| 3 | 게임 클라이언트 | 컨펌 확인 팝업 노출 (게임사가 직접 구현, 예: 캐릭터명 입력 등 의도적 행동 유도) | 공통 |
| 4 | 게임 서버 → 스토브 API | 게임 해지 신청 API를 즉시 해지로 호출, 스토브 즉시 완료 처리 | 즉시 흐름 |
| 5 | 스토브 API → 게임 서버 | 해지 완료 응답, 스토브 캐릭터·약관·제재·기기 정보 삭제 | 즉시 흐름 |
| 6 | 게임 서버 | 게임 DB 내 인게임 유저 데이터 삭제 처리 (스토브는 게임 DB 미관리) | 즉시 흐름 |
| 7 | 게임 클라이언트 | 해지 완료 후 자동 로그아웃 → 게임 접속 종료 또는 초기 화면 이동 | 즉시 흐름 |
이건 꼭 알아 두세요
게임 해지 신청 API에는 User Access Token을 실시간으로 조회해 전달해야 해요. 토큰을 캐싱하거나 서버에 저장해 쓰면 만료(6시간)로 오류가 발생할 수 있어요.
스토브 재화(cash)는 해지 완료 시 함께 삭제되며 복구가 불가능해요. 이용자에게 사전 안내가 필요해요.
해지 신청 (유예기간 존재)
해지를 신청해도 바로 삭제되지 않고, 유예기간 동안 이용자가 취소할 수 있어요. 유예기간은 게임별로 0～30일 설정할 수 있어요. 유예기간이 지나면 스토브가 자동으로 해지를 완료하고, 그 결과를 콜백으로 게임 서버에 알려줘요. 게임사는 이 콜백을 받아 게임 데이터를 정리하면 돼요.
해지 진행 중 안내 화면
유예기간 중 이용자가 게임에 다시 접속하면, 해지가 진행 중임을 알리고 취소를 안내하는 화면이 노출돼요. 이 안내 화면은 스토브가 이용 환경에 맞춰 팝업 형태로 제공하므로, 게임사는 별도로 화면을 구현하지 않아도 돼요.
유예기간 해지 신청 흐름
| 단계 | 처리 주체 | 내용 | 비고 |
|---|---|---|---|
| 1 | 이용자 → 게임 클라이언트 | 인게임 설정에서 해지 메뉴 진입 | 공통 |
| 2 | 게임 클라이언트 | 경고 안내 팝업 노출 (삭제 범위·유예기간 안내) | 공통 |
| 3 | 게임 클라이언트 | 컨펌 확인 팝업 노출 (게임사가 직접 구현, 예: 캐릭터명 입력 등 의도적 행동 유도) | 공통 |
| 4 | 게임 서버 → 스토브 API | 게임 해지 신청 API를 유예 해지로 호출 | 유예 흐름 |
| 5 | 스토브 API → 게임 서버 | 신청 성공·해지 예정 일자 응답, 인증 토큰 만료로 로그아웃 | 유예 흐름 |
| 6 | 이용자 → 게임 클라이언트 | 유예 중 재접속 시 해지 진행 중 안내 화면 노출, 취소 가능 | 유예 흐름 |
| 7 | 스토브 배치 서버 | 유예 경과 대상자 자동 완료 처리, 관련 정보 삭제 (한국 시간 00:00) | 유예 흐름 |
| 8 | 스토브 배치 서버 → 게임 서버 | 해지 완료 정보를 콜백으로 전달 (STOVE Event 연동 필수) | 유예 흐름 |
| 9 | 게임 서버 | 콜백 수신 후 게임 DB 데이터 삭제 (flag 변경 후 삭제 권장) | 유예 흐름 |
해지 취소 흐름
유예기간 내 이용자가 해지를 취소하면 게임을 정상적으로 다시 이용할 수 있어요.
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 이용자 → 게임 클라이언트 | 유예 중 게임 재접속(로그인) |
| 2 | 스토브 SDK | 해지 신청 상태 자동 조회 후 취소 UI 자동 노출, 이용자가 취소 선택 시 스토브에 취소 처리 (게임사 별도 구현 불필요) |
| 3 | 스토브 플랫폼 → 게임 서버 | 해지 취소(GAME_WITHDRAW_CANCEL) 이벤트 전달 (서버 간 동기화 목적) |
| 4 | 게임 서버 | 해지 취소 상태로 동기화 처리 → 이용자 정상 게임 진행 가능 |
이건 꼭 알아 두세요
- 유예기간 경과 후 해지 완료 정보를 받으려면 STOVE Event 기능을 반드시 연동해야 해요. 해지 완료 처리는 스토브 배치 서버가 자동으로 수행해요.
- 인게임 배치(공통 서버 동기화)가 아닌 개별 월드 서버로 운영하는 경우, 해지 취소에 대한 서버 간 동기화를 반드시 구현해야 해요.
- 해지가 완료되면 플랫폼 데이터(GUID·캐릭터 등)는 복구할 수 없어요. 복구가 필요한 이용자는 유예기간 내에 해지를 취소해야 해요.
스토브 회원 탈퇴
스토브 플랫폼 계정 자체를 삭제하는 흐름이에요. 해지 처리는 스토브가 직접 수행하며, 게임사는 스토브가 전달하는 해지 완료 이벤트를 받아 인게임 데이터를 정리하면 돼요.
스토브 회원 탈퇴 안내
이용자는 스토브 계정 관리 > 회원 탈퇴에서 해지를 신청할 수 있어요. 해지 안내·주의사항 확인, 본인확인, 해지 신청, 신청 완료까지 모든 화면과 처리는 스토브가 제공해요. 게임사는 해지 완료 이벤트를 받아 인게임 데이터를 정리하면 돼요.
해지 후 재가입 시 데이터 처리
해지 후 동일 계정이나 동일 기기로 재가입하면 이전 게임 데이터와의 연결이 끊겨요. 이를 미리 고려해 처리해야 해요.
| 상황 | 내용 |
|---|---|
| 동일 스토브 계정으로 게임 재시작 | 계정은 유지되나 캐릭터·재화·월드 데이터는 삭제, 신규 이용자로 시작 |
| GUID 기반 게임, 동일 기기 재가입 | 새 GUID 발급으로 이전 이용자와 구분 어려움 (지표 관리 필요 시 캐릭터 삭제 API 권장) |
| 스토브 회원 탈퇴 후 동일 이메일 재가입 | 새 MemberNo 발급, 이전 데이터와 연결 안 됨, 복구 불가 |
이건 꼭 알아 두세요
· 해지 완료 정보는 STOVE Event 콜백으로 전달돼요. (MemberNo 기반은 퍼블리싱 기술 담당자에게 문의)
· 개인정보는 법적 책임이 발생할 수 있어 반드시 삭제해야 해요.
연동개요
시작 전 결정 항목
해지 기능 연동을 시작하기 전, 아래 항목을 게임팀 내부에서 먼저 결정해 주세요.
| 결정 항목 | 선택지 및 내용 |
|---|---|
| ① 게임 해지 방식 | 즉시 해지 — 신청과 동시에 완료 (유예기간 0일) 유예기간 해지 — 신청 후 유예 상태 진입, 경과 시 자동 완료. 유예 기간(0～30일)과 해지 취소 흐름 구현 필요 |
| ② 이용자 식별 방식 | GUID 기반 — STOVE Event 콜백 사용 가능 MemberNo 기반 — STOVE Event 미지원. 퍼블리싱 기술 담당자에게 해지 처리 방식 사전 확인 필요 |
| ③ 게임 DB 삭제 시점 | 즉시 삭제 — 해지 완료 직후 게임 DB 데이터 삭제 flag 변경 후 배치 삭제 (권장) — flag 변경 후 점검 시간에 백업·완전 삭제. 개인정보 데이터는 반드시 삭제 |
| ④ GUID 재가입 시나리오 | GUID 기반 게임에서 해지 후 동일 기기로 재가입하면 새 GUID가 발급돼 이전 이용자와 구분이 어려워요. 지표 관리 불필요 — 기본 흐름 그대로 구현 지표 왜곡 방지 필요 — 스토브 캐릭터 삭제 API 활용 방식으로 해지 구현 검토 |
이건 꼭 알아 두세요
해지 완료 정보를 받는 STOVE Event 콜백은 GUID 기반 게임에서 지원돼요. MemberNo 기반 게임은 퍼블리싱 기술 담당자에게 해지 처리 방식을 사전 확인해 주세요.
역할 분담
해지 연동에서 스토브가 처리하는 영역과 게임사가 직접 구현하는 영역이에요.
스토브 플랫폼이 제공하는 것
게임사가 구현해야 하는 것환경 구분 안내
연동 테스트는 반드시 Sandbox(샌드박스) 환경에서 먼저 진행한 뒤, 검증이 완료된 후 Live 환경에 적용해요.
| 구분 | Sandbox (샌드박스) | Live (운영) |
|---|---|---|
| API Host | https://api.gate8.com | https://api.onstove.com |
| 용도 | 개발·QA 테스트 전용. 실 이용자 데이터에 영향을 주지 않아요. | 실제 서비스 환경. QA 완료 후 배포해요. |
체크리스트
게임 출시 전, 게임사가 직접 구현하거나 설정한 항목을 확인해요. 해지 신청 처리·유예 완료·콜백 발송은 스토브가 담당하므로 아래 항목만 점검하면 돼요.
| 구분 | 역할 | 점검 항목 |
|---|---|---|
| 필수 | 게임 클라이언트 | 해지 UI — 경고 안내 및 컨펌 확인 팝업 제공 확인
|
| 필수 | 게임 클라이언트 | 해지 완료 후 로그아웃 및 동선 처리 확인
|
| 필수 | 게임 서버 | 게임 해지 신청 API 연동 확인
|
| 필수 | 게임 서버 | 게임 DB 인게임 데이터 삭제 처리 구현 확인
|
| 필수 | 게임 서버 | 유예기간 해지 콜백 수신 및 취소 동기화 구현 확인
|
| 필수 | 게임 서버 | 스토브 회원 탈퇴 이벤트 수신 확인
|
| 권장 | 게임 서버 | GUID 기반 재가입 시 신규 이용자 처리 방식 확인
|