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

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

게임 해지

이해하기

게임 해지(이용해지)는 이용자가 특정 게임의 인게임 데이터를 삭제하는 기능이에요.
스토브 플랫폼 통합 계정은 유지되며, 해당 게임과 연결된 캐릭터, 재화, 월드 내 모든 정보만 삭제돼요.

처리 방식

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

해지 상태 알림

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

연동 가이드

사전 준비

기본 연동 구조

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

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

• 해지 처리 완료 시 자동으로 로그아웃되므로, 이후 동선(예: 게임 종료 또는 초기 화면 이동)을 처리해야 해요.

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

• 유예기간 설정 및 데이터 삭제 방법
  • 게임 해지 유예기간은 각 게임별 자체 정책으로 관리해요.
    • 해지 처리 기간 내 게임 진입 시 (PC 예시)

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

개발하기

모바일 SDK 연동

동작 흐름

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

게임 측 구현 사항

참고

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

PC SDK 연동

PCSDK IAPSDK가 제공하는 게임 해지 API(IAP_WithdrawGame)를 사용하면 게임 클라이언트에서 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 호출 없이 이용자에게 결과만 안내한 뒤 게임 프로세스를 종료해요.

트러블슈팅

시퀀스 다이어그램

샘플 코드

#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)
        {
            // 팝업 종료 후 결과 안내 + 게임 종료
        }
    );
}

서버 연동

개발 흐름 - 즉시 탈퇴 처리

0. 유저가 게임 내에서 탈퇴 신청을 해요.
1. 클라이언트가 게임 서버에 요청을 Game User Access Token을 같이 전달해요.
2. 게임 서버 내, 유저 정보를 삭제해요.(트랜잭션으로 제어 합니다)
3. DELETE /stove-terms/v3.0/agree?service_id={게임id}를 호출해 탈퇴 요청을 보냅니다.
   이때 Game User Access Token을 같이 보내주세요.
4. STOVE에서 탈퇴 완료 및 데이터를 삭제시킵니다.
5. game server 측으로 성공 응답을 줍니다.
6. 유저가 탈퇴완료 되었고, 게임에서 접속 종료시킵니다.

• 유예기간 없이 즉시 탈퇴 처리

개발 흐름 - 유예기간의 탈퇴 처리

0. 유저가 게임 내에서 탈퇴 신청을 해요.
1. 클라이언트가 게임 서버에 요청을 Game User Access Token을 같이 전달해요.
2. 게임 서버 내, 유저 정보를 탈퇴 신청 상태로 변경합니다.(트랜잭션으로 제어 합니다)
3. DELETE /stove-terms/agree?service_id={게임id}&delete_yn=N를 호출해 탈퇴 요청을 보냅니다.
   이때 Game User Access Token을 같이 보내주세요.
4. STOVE에서 탈퇴 신청을 진행합니다.
5. game server 측으로 탈퇴 예정일자와 성공 응답을 줍니다.
6. 유저가 탈퇴가 신청 되었고, 게임에서 접속 종료시킵니다.

• 유예기간를 두고 유저 탈퇴 처리

트러블슈팅

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

샘플 코드

게임 탈퇴 신청 API (DELETE /stove-terms/v3.0/agree?service_id={게임id}) 호출 예제예요.

// 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 {
        // 즉시 철회 완료 — 게임 세션 종료
    }
}

자주 묻는 질문