Skip to content
스토브
마지막 업데이트

실제 적용 흐름이 궁금하신가요?

이용 시나리오 / 게임 해지하기

게임 해지

이해하기


게임 해지(이용해지)는 이용자가 특정 게임의 인게임 데이터를 삭제하는 기능이에요.
스토브 플랫폼 통합 계정은 유지되며, 해당 게임과 연결된 캐릭터, 재화, 월드 내 모든 정보만 삭제돼요.
스토브에서 게임 해지는 해당 게임의 이용약관 동의를 철회하는 것과 같은 의미예요. 이 가이드와 SDK·API에서 '약관 철회'로 표기된 기능은 게임 해지를 뜻하며, 게임 서버가 호출하는 게임 해지 신청 API도 약관 동의(agree)를 삭제하는 API예요.

항목 내용
삭제 범위 해당 게임의 캐릭터, 재화, 월드 내 모든 정보
스토브 계정 유지됨 (다른 게임 이용 가능)
진입 경로 인게임 설정 화면
유예기간 게임별 0~30일 설정 (0일이면 즉시 해지)
ㆍ즉시/유예 여부는 게임 해지 신청 API의 delete_yn 파라미터로 결정 — 즉시 해지(0일)는 Y(기본값), 유예기간 해지는 N
ㆍ유예 일수는 API로 전달하지 않고 게임별 설정값을 따르며, 유예 종료 예정일은 API 응답으로 전달

스토브 계정 유지
게임 해지는 해당 게임과 연결된 스토브 계정(게스트, 정회원)의 인게임 정보만 삭제해요.
스토브 플랫폼 통합 계정은 유지되며, 다른 게임 이용에는 영향이 없어요.


처리 방식

게임 해지는 이용자의 실수를 방지하기 위해 경고 안내와 컨펌 확인 기능을 반드시 제공해야 해요.
해지 처리 흐름은 유예기간 설정 여부에 따라 달라져요.

처리 방식 설명 특이사항
해지 신청 (즉시 해지) 이용자가 해지 신청 시, 스토브 게임 해지 신청 API 호출 해지 완료 시 복구 불가
해지 신청 (유예기간 존재) 이용자가 해지 신청 시, 스토브 게임 해지 신청 API 호출 (delete_yn=N 파라미터로 유예 해지 선택, 유예 일수는 게임별 설정값 적용) 유예기간 중 취소 가능. 완료 콜백 수신 후 데이터 삭제

유예기간 해지 처리 방식
① 유예기간이 지나면 스토브가 자동으로 해지를 완료 처리해요.
② 해지가 완료되면 스토브에서 해지 관련 이벤트를 전달해요.



해지 상태 알림

처리 방식별 이벤트 (일반 게임 공통 콜백)

처리 방식발생 이벤트
즉시 해지 (유예 일수 0, delete_yn=Y)GAME_WITHDRAW_COMPLETE
유예 해지 신청GAME_WITHDRAW
유예 중 취소GAME_WITHDRAW_CANCEL
유예 종료 후 완료GAME_WITHDRAW_COMPLETE

즉시 해지는 선행 신청 이벤트 없이 완료 이벤트만 전달해요.

스토브 플랫폼은 게임 해지 상태가 변경될 때 CP사(개발사) 서버로 실시간 이벤트를 전달해요.
CP사는 Callback API를 구현하여 이벤트를 수신하고, 운영 정책에 맞게 처리해야 해요.

이벤트 정보 이벤트 발생 상황 CP사 측 대응 가이드
게임 해지
GAME_WITHDRAW
이용자가 게임 해지를 신청한 경우 게임 서버의 이용자 상태를 해지 신청 상태로 업데이트, 세션 종료
게임 해지 신청 취소
GAME_WITHDRAW_CANCEL
이용자가 게임 해지 신청을 취소한 경우 게임 서버의 이용자 상태를 정상 이용 가능 상태로 업데이트 (해지 신청 중 → 정상)
게임 해지 완료
GAME_WITHDRAW_COMPLETE
이용자가 게임 해지를 완료한 경우
이용자가 플랫폼 회원 탈퇴를 완료한 경우 — 탈퇴 시 이용자가 가입된 모든 게임이 해지 처리돼요. 이용자가 직접 가입 절차를 거치지 않고 자동으로 가입된 게임도 포함되므로, 게임 서버에 가입·해지 신청 이력이 없는 이용자의 이벤트도 전달될 수 있어요.
게임 서버의 이용자 상태를 해지 완료로 업데이트, 세션 종료
데이터 삭제는 즉시 처리하지 않고 배치 등 운영 정책에 따라 수행
스토브 회원 탈퇴 신청
PLATFORM_WITHDRAW
이용자가 스토브 플랫폼 회원 탈퇴를 신청한 경우 이용자 로그아웃 및 게임 재시작 처리

적용 대상 및 제한 사항
ㆍ본 스토브 이벤트 기능은 GUID 기반 서비스 게임만 지원해요.
ㆍMember_no 기반 게임은 기술 담당자를 통해 사전에 확인이 필요해요.
ㆍ전체 이벤트 목록과 Callback API 구현 방법은 스토브 이벤트 가이드를 참고해 주세요. 이벤트 종류와 관계없이 하나의 Callback API로 수신하고 event_reason 값으로 분기 처리해요.



스토브 회원 탈퇴 연동

스토브 회원 탈퇴는 이용자가 스토브 플랫폼 전체 계정을 삭제하는 기능이에요.
특정 게임의 데이터만 삭제하는 게임 해지와 달리, 스토브 계정에 연결된 모든 게임의 데이터와 계정 자체가 삭제돼요. 탈퇴 신청부터 완료까지 모든 화면과 처리는 스토브가 제공하며, 게임사는 탈퇴 신청 시 이용자를 로그아웃 처리하고, 탈퇴가 완료되면 가입된 게임별로 전달되는 GAME_WITHDRAW_COMPLETE를 받아 게임 해지 완료와 동일하게 인게임 데이터를 정리하면 돼요.
이용자는 인게임 메뉴(SDK AuthUI.Withdraw) 또는 스토브 계정 관리 > 회원 탈퇴에서 탈퇴를 신청할 수 있어요. 인게임 메뉴에서 신청하면 SDK가 탈퇴 신청과 로그아웃을 처리하므로 게임사가 별도 서버 기능을 구현할 필요는 없고, 게임은 시작 화면으로 이동해 재로그인을 유도하면 돼요. 다만 이용자가 스토브 웹에서 직접 신청할 수도 있으므로 PLATFORM_WITHDRAW 이벤트 수신 처리는 필요해요. 인게임 메뉴 연동 방법은 인게임 메뉴 가이드를 참고해 주세요.

항목 게임 해지 스토브 회원 탈퇴
삭제 범위 해당 게임의 캐릭터·재화·월드 내 정보 연결된 모든 게임의 데이터 + 스토브 계정 자체
스토브 계정 유지 삭제
진입 경로 인게임 설정 화면 (게임사 구현) 인게임 메뉴(SDK AuthUI.Withdraw) 또는 스토브 계정 관리 > 회원 탈퇴 (화면·처리는 스토브 제공)
유예기간 게임별 0~30일 설정 스토브 정책에 따라 자동 처리 — 신청일로부터 30일 뒤 탈퇴 완료 (철회 가능한 유예기간 15일 + 철회 불가 기간 15일)
게임사 처리 해지 신청 연동(SDK), 이벤트 수신, 데이터 삭제 신청 이벤트 수신 후 로그아웃, 완료 이벤트 수신 후 데이터 삭제

탈퇴 단계별 게임사 대응

회원 탈퇴는 신청 → 유예 → 완료 순서로 진행돼요. 단계별로 게임사가 받는 알림과 해야 할 일이 달라요.

단계 시점 게임사가 받는 알림 게임사 대응
① 탈퇴 신청 이용자가 인게임 메뉴 또는 스토브 계정 관리에서 신청한 즉시 STOVE Event PLATFORM_WITHDRAW (실시간) 해당 이용자 로그아웃 및 게임 재시작 처리
② 유예 (철회 가능) 유예기간 중 이용자가 철회한 경우 없음 별도 처리 불필요. 이용자가 재로그인하면 정상 이용
③ 탈퇴 완료 유예기간 경과 후 스토브 배치 처리 가입된 게임별 STOVE Event GAME_WITHDRAW_COMPLETE (선행 GAME_WITHDRAW 없이 전달) 게임 해지 완료와 동일 처리. 인게임 DB flag 처리 후 백업·삭제

탈퇴 완료 처리

회원 탈퇴가 완료되면 스토브가 그 이용자가 가입한 게임을 모두 해지 처리하고, 게임별로 GAME_WITHDRAW_COMPLETE를 전달해요. 이용자가 직접 게임 해지를 완료했을 때와 같은 이벤트이므로, 별도 구현 없이 게임 해지 완료 처리 로직으로 데이터를 정리하면 돼요. 이 경우 선행 GAME_WITHDRAW 없이 완료 이벤트만 도착하니, 신청 이력 유무와 관계없이 처리해 주세요.

탈퇴 완료 이용자 데이터 처리
ㆍ즉시 삭제하지 않아도 돼요. 인게임 DB에 flag를 먼저 변경한 뒤, 점검 시 데이터를 백업하고 삭제하는 방식을 권장해요.
ㆍ이용자의 개인 정보를 수집하고 있다면 법적 책임이 발생할 수 있으므로 삭제가 꼭 필요해요.
ㆍSTOVE 이벤트는 GUID 기반 서비스에서만 지원해요. Member_no 기반 서비스는 기술 담당자에게 별도 안내를 요청해 주세요.

연동 가이드


사전 준비

항목 내용
User Access Token 확인 게임 해지 요청 API에 이용자의 User Access Token 전달
ㆍ로그인 후 SDK로 획득, 캐싱 없이 실시간 조회
이용자 식별 방식 해지 신청 API는 Authorization의 Game User Access Token과 service_id로 이용자를 식별해요. member_no Query·Body 입력 항목은 없으며, 공통 콜백의 target_users는 GUID 목록이에요.
유예기간 정책 결정 즉시 해지 또는 유예기간 해지 방식을 게임별로 선택
ㆍ유예 일수는 게임별로 설정하며 퍼블리싱 기술 담당자와 협의 (SG 퍼블리싱 게임은 보통 14일 적용)
ㆍ유예 종료 시점은 해지 신청 API 응답의 해지 예정일자(withdraw_dt, unix-ms)를 기준으로 게임 서버에서 동기화

기본 연동 구조

  • 클라이언트: 해지 UI 및 경고 안내 제공
    • 인게임 설정 화면에 해지 버튼을 배치해요.

  • 해지 요청 전 경고 안내 및 컨펌 확인 팝업을 반드시 제공해야 해요.


  • 해지 처리 완료 시 자동으로 로그아웃되므로, 이후 동선(예: 게임 종료 또는 초기 화면 이동)을 처리해야 해요.
UI 유형 설명
경고 안내 팝업 "해지하면 모든 정보가 삭제되며, 복구할 수 없습니다." 등 해지 결과를 명확히 안내
컨펌 확인 팝업 게임사가 직접 구현하며, 캐릭터명 입력 등 의도적 행동을 유도해 실수 해지를 방지
유예기간 안내 팝업 (선택) 유예기간 적용 시 "해지 후 N일 이내에 해지를 취소할 수 있습니다." 등을 안내



  • 서버: 게임 해지 처리
    • 게임 해지 신청 API를 호출해 해지가 완료돼도 스토브 플랫폼 계정은 유지돼요.
    • 요청 시 전달한 Game User Access Token과 게임 아이디로 식별된 이용자의 스토브 캐릭터 정보가 전체 월드에 걸쳐 모두 삭제돼요.
    • 게임 DB에 기록된 게임 내 정보는 게임에서 직접 유지·삭제해야 해요.
    • 스토브 재화(cash) 시스템을 사용하는 경우, 캐릭터가 보유한 재화(cash)도 함께 삭제되니 주의가 필요해요.

GUID 기반 게임 해지 구현 시 주의
이후 이용자가 동일 기기에서 재가입할 경우 신규로 GUID가 발급되어 동일 이용자로 구분이 어려워요.
약관 동의와 GUID를 유지하고 캐릭터 정보만 삭제하려면 게임 캐릭터 삭제 API(DELETE /game/v5.1/character?character_no={캐릭터 고유 번호})를 사용해 주세요.



  • 유예기간 설정 및 데이터 삭제 방법
    • 게임 해지 유예기간은 각 게임별 자체 정책으로 관리해요. 유예 일수는 API로 전달하지 않고 게임별로 설정한 값이 적용되므로, 원하는 유예 일수는 퍼블리싱 기술 담당자와 협의해 주세요. 게임 서버는 해지 신청 API 응답의 해지 예정일자(withdraw_dt)를 기준으로 유예 종료 시점을 관리하면 돼요.
      • 해지 처리 기간 내 게임 진입 시 (PC 예시)

  • 해지 처리 기간 내 게임 진입 시 (Mobile 예시)

인게임 데이터 삭제 권장 방식
인게임 DB에 flag를 먼저 변경한 뒤, 점검 시 데이터를 백업하고 삭제하는 방식을 권장해요.

개발하기


모바일 SDK 연동

Mobile SDK는 인증 동선에서 해지 취소 기능을 챙기고 있어요

  • 게임 해지 신청/완료는 게임 서버 ↔ STOVE 서버 간 REST API/이벤트로 처리되며, Mobile SDK는 관여하지 않아요. 자세한 내용은 서버 연동 가이드를 참고해 주세요.
  • 해지 취소만 Mobile SDK가 담당해요. 유예기간 중 이용자가 게임을 다시 켜고 SDK 로그인을 진행하면, 취소 UI가 자동으로 노출돼요.
  • 게임 클라이언트는 별도 SDK 함수 호출 없이 평소처럼 AuthUI.Login만 호출하면 돼요.

동작 흐름

유예기간 중 이용자가 다시 게임을 켜고 로그인하면, Mobile SDK가 STOVE에서 해지 신청 상태를 자동 조회해 취소 UI를 띄워요. 이용자가 취소를 선택하면 STOVE에서 신청 상태가 해제되고, 게임 서버는 GAME_WITHDRAW_CANCEL 이벤트로 동기화 처리만 하면 돼요.


게임 측 구현 사항

영역 해야 할 일
게임 클라이언트 평소처럼 AuthUI.Login만 호출하면 돼요. 취소 UI 노출/처리/이후 로그인 흐름은 Mobile SDK가 자동으로 담당해요.
게임 서버 GAME_WITHDRAW_CANCEL 이벤트 수신부 구현 후, 수신 시점에 해지 신청 상태 해제

개별 월드 운영 시 서버 간 동기화에 유의해요
공통 서버를 통한 동기화 형태가 아닌, 개별 월드를 통해 운영하는 경우에는 GAME_WITHDRAW_CANCEL 이벤트 수신 시 서버 간 동기화 처리를 반드시 구현해야 해요.


참고

  • AuthUI.Login의 전체 호출 흐름은 로그인 가이드를 참고해 주세요.
  • 게임 서버가 호출하는 게임 해지 신청 API(REST), 해지 완료 처리(STOVE 자동), GAME_WITHDRAW* 이벤트 명세는 서버 연동 가이드를 참고해 주세요.



PC SDK 연동

PCSDK IAPSDK가 제공하는 게임 해지 API(IAP_WithdrawGame)를 사용하면 게임 클라이언트에서 STOVE 게임 해지 팝업을 띄울 수 있어요. 이용자가 팝업에서 게임 해지에 동의하면 STOVE가 게임 해지를 처리해요.

스팀런처로 실행한 경우에는 동작하지 않아요. 그러므로 스팀런처를 통해 실행중이라면 호출하지 않아야해요.

현재 로스트아크M 한정으로 제공되는 기능이에요.
2025년 11월 12일 기준, 게임 해지 API는 로스트아크M 한정으로 기능이 제공되는 상태예요. 다른 게임에서 호출하면 정상 동작하지 않을 수 있어요. 향후 전체 게임에 사용 가능하도록 개선 중이며, 전체 사용 가능해지면 본 안내는 제거될 예정이에요.

게임 해지 ≠ STOVE 회원 탈퇴
본 API는 게임 단위 해지만 처리해요. STOVE 통합 회원 탈퇴는 STOVE 웹 페이지에서 별도로 진행돼요.


사전 준비

  • Base_RestartAppIfNecessaryAsync 콜백의 restartAppIfNecessary == false 분기에서 Base_InitializeEx를 호출해 Base 초기화를 완료해요. 이어서 IAP_Initialize(shopKey)(부모 창 지정이 필요하면 IAP_InitializeWithWndInfo(shopKey, mainWndHandle))로 IAP 모듈을 초기화해요. 초기화가 완료된 뒤에 게임 해지 API를 호출해야 해요.
  • 게임 루프에서 콜백 실행 함수(Base_RunCallback())가 주기적으로 호출돼야 비동기 콜백(해지 결과 콜백, 팝업 종료 콜백)이 동작해요.
  • 게임 해지가 성공하면 SDK 내부 이용자 토큰이 만료돼요. 이후 흐름을 SDK 호출 없이 게임 종료 안내 → 프로세스 종료까지 처리하도록 미리 설계해야 해요.

개발 흐름

  1. 옵션 구성: 해지 흐름 파라미터(StovePCWithdrawGameOption)에 WebView 모드(Internal/External)와 위치·크기를 설정해요. 위치를 정중앙으로 두고 싶으면 PosX/PosY를 -1로 지정해요.
  2. API 호출: 게임 클라이언트가 게임 해지 API(IAP_WithdrawGame)를 호출해 게임 해지 팝업을 띄워요.
  3. 결과 콜백 처리: 해지 결과 콜백으로 gameWithdrawal == true면 해지가 진행된 것으로 처리해요.
  4. 팝업 종료 콜백 처리: 팝업 종료 콜백으로 이용자가 팝업을 닫은 시점을 받아 게임 종료 안내 UI를 노출해요.
  5. 게임 종료 처리: 게임 해지가 완료되면 SDK 토큰이 만료되므로 추가 SDK 호출 없이 이용자에게 결과만 안내한 뒤 게임 프로세스를 종료해요.

트러블슈팅

상황원인해결 방법
게임 해지 API를 호출했는데 팝업이 뜨지 않거나 정상 동작하지 않아요본 API는 현재 로스트아크M 한정으로 기능이 제공돼요. 다른 게임에서 호출하면 STOVE 백엔드에서 처리되지 않아요.본 게임이 기능 적용 대상인지 퍼블리싱 기술 담당자에게 확인하고, 비대상 게임이면 호출 흐름을 비활성화해야 해요. 향후 전체 게임 지원 시점에 다시 활성화하면 문제없어요.
초기화 직후 호출했더니 실패해요Base_RestartAppIfNecessaryAsync는 비동기이며 콜백은 Base_RunCallback 호출 시 디스패치돼요. 콜백의 restartAppIfNecessary == false 분기에서 Base_InitializeEx를 호출해야 초기화가 완료돼요. 이 순서가 완료되기 전에 게임 해지 API를 호출하면 실패해요.Base_RestartAppIfNecessaryAsync 콜백 → Base_InitializeEx → IAP_Initialize 성공 이후에 게임 해지 API를 호출해야 해요. 부팅 시퀀스에서 초기화 완료 여부를 플래그로 확인하면 문제없어요.
게임 해지 후 게임을 계속 진행하니 SDK API가 인증 오류를 반환해요게임 해지 API 성공 시 SDK 내부 이용자 토큰이 만료돼요. 이후 SDK API 호출은 보장되지 않아요.결과 콜백에서 gameWithdrawal == true이면 추가 SDK 호출을 하지 말고, 팝업 종료 콜백까지 받은 뒤 이용자 안내 → 게임 종료로 흐름을 마무리해야 해요.
결과 콜백 또는 팝업 종료 콜백이 호출되지 않아요게임 클라이언트 메인 루프에서 콜백 실행 함수(Base_RunCallback())가 호출되지 않으면 PC SDK가 결과를 게임 클라이언트에 전달할 수 없어요.메인 루프에서 매 프레임 또는 일정 주기로 콜백 실행 함수를 호출해야 해요.

시퀀스 다이어그램


샘플 코드

cpp
#include "IAPSDK.h"

using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

void IAP_WithdrawGame_Example()
{
    StovePCWithdrawGameOption Option;
    Option.SetWebviewMode(WebViewMode::INTERNAL);
    // 정중앙 배치를 원할 경우 PosX/PosY를 -1로 지정
    Option.SetWebviewRect(0, 0, 800, 600);

    IAP_WithdrawGame(&Option,
        [](CallbackResult CallbackResult, bool GameWithdrawal)
        {
            if (CallbackResult.GetResult().IsSuccessful() && GameWithdrawal)
            {
                // 게임 해지 성공 처리
            }
        },
        [](CallbackResult CallbackResult)
        {
            // 팝업 종료 후 결과 안내 + 게임 종료
        }
    );
}

서버 연동

개발 흐름 - 즉시 해지 처리

  1. 이용자가 게임 클라이언트에서 해지 신청을 해요.
  2. 게임 클라이언트가 게임 서버에 요청을 보낼 때 Game User Access Token을 같이 전달해요.
  3. 게임 서버는 처리 중 상태만 기록하고 원본 데이터는 유지해요.
  4. 게임 서버가 DELETE /stove-terms/v3.0/agree?service_id={게임id}를 호출해 해지 요청을 보내요.
    이때 게임 서버는 게임 클라이언트에서 전달받은 Game User Access Token을 같이 보내 주세요.
  5. STOVE가 해지를 완료하고 데이터를 삭제해요.
  6. STOVE가 게임 서버로 성공 응답을 반환해요.
  7. 게임 서버는 해지 완료를 확인한 뒤 로컬 상태를 갱신하고 데이터를 정리하며, 게임 클라이언트의 접속을 종료해요.

API 실패·통신 오류 시에는 원본 데이터를 유지하고, 처리 결과를 확인한 뒤 후속 처리해 주세요.

개발 흐름 - 유예기간의 해지 처리

  1. 이용자가 게임 클라이언트에서 해지 신청을 해요.
  2. 게임 클라이언트가 게임 서버에 요청을 보낼 때 Game User Access Token을 같이 전달해요.
  3. 게임 서버 내 이용자 정보를 해지 신청 상태로 변경해요. (트랜잭션으로 제어해요)
  4. 게임 서버가 DELETE /stove-terms/v3.0/agree?service_id={게임id}&delete_yn=N를 호출해 해지 요청을 보내요.
    이때 게임 서버는 게임 클라이언트에서 전달받은 Game User Access Token을 같이 보내 주세요.
  5. STOVE가 해지 신청을 처리해요.
  6. STOVE가 게임 서버로 해지 예정일자와 성공 응답을 반환해요.
  7. 이용자의 해지 신청이 완료되었으므로 게임 클라이언트에서 접속을 종료해요.
  • 유예기간을 두고 이용자 해지 처리

트러블슈팅

응답 code 별 처리 방안이에요. 상세 응답 코드·메시지 스펙은 API & SDK 레퍼런스 메뉴를 참고하세요.

응답 code상황처리 방안
70800파라미터의 service_id 값을 잘못 입력한 경우자신의 게임에 맞는 값을 입력해주세요.
70806parameter의 service_id 값을 잘못 입력한 경우자신의 게임에 맞는 값을 입력해주세요.
70816STOVE 서버 내부의 오류일시적 오류일 수 있으니 재시도 후, 지속되면 기술 담당자를 통해서 문의주세요.
70820이미 해지 신청 중인 이용자인 경우중복 해지 신청할 수 없습니다.
70825게임 가입(이용 동의)이 되지 않은 이용자인 경우게임 가입이 되지 않았기 때문에 해지 신청을 할 수 없습니다.
70853STOVE 서버 내부의 오류일시적 오류일 수 있으니 재시도 후, 지속되면 기술 담당자를 통해서 문의주세요.
70854STOVE 서버 내부의 오류일시적 오류일 수 있으니 재시도 후, 지속되면 기술 담당자를 통해서 문의주세요.
70870request header에 caller-id를 누락한 경우request header에 caller-id key 값을 넣어주세요.
70899파라미터 값이 유효하지 않을 경우올바른 파라미터 값을 입력해주세요.



샘플 코드

게임 서버에서 게임 해지 신청 API (DELETE /stove-terms/v3.0/agree?service_id={게임id})를 호출하는 예제예요.

Base URL은 환경(Live/Sandbox)에 맞춰 교체해 주세요
운영 환경에서는 하드코딩 대신 환경 변수(예: STOVE_API_BASE_URL)나 프레임워크 설정 파일로 분리해 환경별로 주입하는 것을 권장해요.

Game User Access Token 은 매 요청마다 발급된 토큰을 사용하세요
토큰을 로그/저장소에 남기지 마시고, 즉시 폐기되는 변수로만 다뤄주세요. 즉시 해지(delete_yn=Y, 기본값)와 유예 상태(delete_yn=N)는 같은 호출의 쿼리 파라미터로만 달라져요.

java
// Java 25 LTS — java.net.http.HttpClient + Jackson(ObjectMapper)
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.util.UUID;

ObjectMapper mapper = new ObjectMapper();
String baseUrl = "https://api.onstove.com";
String serviceId = "STOVE_EPIC7";
String callerId = serviceId + "_SERVER";
String callerDetail = UUID.randomUUID().toString();

try (HttpClient client = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(5))
        .build()) {

    // 유예 처리(철회 예정 상태)는 URL 끝에 &delete_yn=N 추가
    URI uri = URI.create(baseUrl + "/stove-terms/v3.0/agree?service_id=" + serviceId);

    HttpRequest req = HttpRequest.newBuilder(uri)
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer " + gameUserAccessToken)
            .header("caller-id", callerId)
            .header("caller-detail", callerDetail)
            .DELETE()
            .build();
    HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
    JsonNode data = mapper.readTree(res.body());
    if (data.path("code").asInt() != 0) {
        // 트러블슈팅 표 참고 (70800 / 70816 / 70820 / 70825 / 70899 등)
        throw new IllegalStateException("withdraw failed: " + data.path("code"));
    }
    long withdrawDt = data.path("value").path("withdraw_dt").asLong(0L);
    if (withdrawDt > 0) {
        // 유예기간 모드 — withdrawDt 는 unix-ms 탈퇴 예정 일자. 안내 후 게임 세션 종료
    } else {
        // 즉시 철회 완료 — 게임 세션 종료
    }
}

자주 묻는 질문



Q1. 게임 해지는 어떤 방식으로 요청하나요?
A. 스토브 게임 해지 신청 API를 호출하면 돼요.
즉시 해지와 유예기간 해지는 API 파라미터(delete_yn)로 구분해요.
유예기간을 두는 경우, 스토브가 유예기간 종료 후 자동으로 해지를 완료 처리하고 해지 관련 이벤트를 전달해요.
Q2. 게임 해지 신청 API로 해지하면 어떤 데이터가 삭제되나요?
A. 스토브 캐릭터 정보(전체 월드 내 모든 캐릭터 정보)가 삭제돼요.
STOVE Platform 통합 계정은 유지돼요. 게임 DB 내 정보는 게임에서 직접 삭제 처리해야 해요.
STOVE 재화(cash) 시스템을 사용하는 경우 재화(cash)도 함께 삭제되니 주의가 필요해요.
Q3. GAME_WITHDRAW_CANCEL과 GAME_WITHDRAW_COMPLETE 이벤트는 어떤 용도인가요?
A. 취소 시 GAME_WITHDRAW_CANCEL로 신청 상태를 해제하고, 완료 시 GAME_WITHDRAW_COMPLETE로 완료 상태를 반영해요. 즉시 해지는 선행 신청 이벤트 없이 완료 이벤트만 전달돼요.
Q4. 유예기간 해지 처리 시 배치 서버를 반드시 구현해야 하나요?
A. 유예 완료 처리는 스토브 배치 서버가 자동으로 수행하므로, CP사가 해지 완료를 위해 별도 API를 호출하는 배치는 필요하지 않아요.
대신 CP사는 완료 콜백(STOVE Event)을 수신해 인게임 데이터를 삭제하고, 개별 월드로 운영하는 경우 해지 취소에 대한 서버 간 동기화를 구현해야 해요.
Q5. 스토브 회원 탈퇴와 게임 해지는 어떻게 다른가요?
A. 게임 해지는 특정 게임의 인게임 데이터만 삭제하고 스토브 계정은 유지돼요.
스토브 회원 탈퇴는 스토브 플랫폼 계정 자체가 삭제되며, 해당 계정과 연결된 모든 게임에 영향을 줘요.
Q6. PLATFORM_WITHDRAW 이벤트를 받으면 어떻게 처리해야 하나요?
A. 이용자가 스토브 플랫폼 탈퇴를 신청한 시점에 전달되는 이벤트예요.
수신 시 해당 이용자를 인게임에서 로그아웃 처리해 주세요.
탈퇴가 완료되면 가입된 게임별로 GAME_WITHDRAW_COMPLETE가 전달되므로, 게임 해지 완료와 동일하게 데이터를 정리하면 돼요.
Q7. 이용자가 유예기간 중에 회원 탈퇴를 철회하면 어떻게 되나요?
A. 철회 시 게임사에 별도 이벤트는 전달되지 않아요.
이용자가 다시 로그인하면 정상적으로 게임을 이용할 수 있으므로, 게임사가 추가로 처리할 것은 없어요.
Q8. 스토브 회원 탈퇴 완료 이용자는 어떻게 확인하나요?
A. 가입된 게임별로 전달되는 GAME_WITHDRAW_COMPLETE 이벤트로 확인해요. 별도 조회 API를 호출할 필요가 없어요.
STOVE 이벤트는 GUID 기반 서비스에서만 지원하므로, Member_no 기반 서비스는 기술 담당자에게 별도 안내를 요청해 주세요.
Q9. 탈퇴 완료된 이용자 데이터를 즉시 삭제해야 하나요?
A. 즉시 삭제하지 않아도 돼요. 인게임DB 내 flag 변경 처리 후, 이후 점검 등을 통해 데이터 백업 후 삭제하는 방식을 권장해요.
단, 이용자의 개인 정보를 수집하고 있을 경우 법적 책임이 발생할 수 있으므로 삭제가 꼭 필요해요.



문의가 필요하신가요?