- 마지막 업데이트
게임에서 구매하기
스토브 가입
스토브 로그인
기기등록
게임진입
결제
기타설정
게임해지
스토브 탈퇴서비스 소개
이용자는 게임에서 아이템·캐시·구독 상품을 사고, 결제한 상품을 게임 안에서 바로 받아서 사용할 수 있어요. PC에서는 스토브 결제창으로, 모바일에서는 각 마켓의 인앱 결제로 결제할 수 있어, 어떤 기기로 플레이하든 같은 게임에서 결제할 수 있어요. 결제가 끝나면 상품이 안전하게 지급되도록 결제 확인과 환불 처리까지 스토브가 함께 챙겨요.
| 항목 | PC | 모바일 |
|---|---|---|
| 지원 환경 | Windows | Android, iOS |
| 지원 마켓 | 스토브 (PC) | Google Play, Apple App Store 등 |
| 지원 결제 유형 | 일반 상품 구매 | 일반 상품 구매 구독 상품 구매 — Google Play · Apple App Store (SDK v2.6.0+) |
| 이용자 조건 | 정회원 전용 (게스트 결제 불가) | 정회원 · 게스트 회원 모두 결제 가능 |
| 미성년자 제한 | 대한민국(KR) : 청소년(연 나이 19세 미만) 결제 금액 · 시간대 제한 | |
결제 기본 정보
스토브는 PC와 모바일을 함께 지원하는 멀티플랫폼 결제를 제공해요. PC에서는 스토브 결제창으로, 모바일에서는 각 마켓의 인앱 결제(IAP)창으로 결제하며, 플랫폼에 따라 통화 · 수단 · 한도 등이 다르게 적용돼요.
| 항목 | PC 결제 (스토브 결제창) | 모바일 결제 (마켓 IAP) |
|---|---|---|
| 통화 | 가입 국가 통화 (KRW · USD · JPY 등) |
마켓 계정에 설정된 통화 |
| 결제 수단 | 한국 : 스토브 페이 · 간편결제 · 카드 등 글로벌 : PayPal · 카드 · ApplePay 등 |
마켓 계정에 등록된 결제 수단 |
| 결제 한도 | 한국 : 성인 자가 설정 · 미성년 월 7만원 일본 : 연령별 한도 그 외 : 별도 한도 없음 |
별도 한도 없음 (일본은 PC와 합산 적용) |
| 확인 · 증빙 | 이메일 안내 · 스토브 [내정보] · 현금영수증 | 마켓 결제 내역 · 영수증 |
| 취소 · 환불 | 청약 철회 기간 · 상품 사용 여부 기준 (철회 기간은 게임별 상이) |
마켓 환불 정책 기준 (이용자 단독 취소 시 비정상 환불 처리) |
※ 구글 월렛으로 결제한 현금성 금액은 최종 사용처인 스마일게이트에서 현금영수증을 자동으로 발행해요.
핵심개념
| 용어 | 내용 |
|---|---|
| IAP (In-App Purchase) | ㆍ 모바일 인앱 결제 ㆍ 각 마켓(Google Play, Apple App Store 등)의 결제 시스템을 통해 처리 |
| TID (스토브 빌링 결제 주문번호) | ㆍ 결제 건마다 발급되는 고유 주문번호 ㆍ 게임 서버에 저장해 중복 지급 방지 |
| 결제 완료 알림(Noti) | ㆍ 결제 완료 후 스토브 빌링이 게임 서버로 보내는 상품 지급 요청 ㆍ 실패 시 최대 100회(1～5분 간격) 재전송 |
| 비정상 환불 (Voided Purchase) | ㆍ 아이템 수령 후 마켓에서 직접 결제를 취소한 경우 ㆍ 스토브 빌링은 게임에서 조회 요청이 오면, 저장된 재결제 대상 환불 목록을 게임 서버에 전달 ㆍ 5분 주기 전달 방식은 추후 지원 종료 예정이며, 환불·재결제 프로세스는 변경될 수 있어요 |
| 구독 상품 | ㆍ 지정 주기마다 자동 갱신되는 결제 상품 ㆍ Google Play·Apple App Store 지원, SDK v2.6.0 이상 필요 |
이용 시나리오
아이템 구매하기
이용자가 게임 상점에서 아이템이나 캐시를 고르고 결제하면, 잠시 뒤 게임으로 아이템이 지급돼요. 이용자가 체감하는 건 '상점에서 선택 → 마켓 결제 → 아이템 수령'까지의 짧은 흐름이고, 그 사이 결제 검증과 지급은 스토브 빌링과 게임 서버가 자동으로 처리해요.
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 이용자 → 마켓 | 마켓에서 인앱 결제 완료 |
| 2 | 스토브 빌링 → 게임 서버 | 결제 완료 알림(Noti) 전송 |
| 3 | 게임 서버 | 결제 유효성 검증 (TID로 중복 여부 확인) |
| 4 | 게임 서버 → 이용자 | 아이템 지급 후 이용자에게 전달 |
이건 꼭 알아 두세요
ㆍ TID(스토브 빌링 결제 주문번호)는 게임 서버에 반드시 저장해 관리해요.
ㆍ 같은 결제 알림이 재전송될 수 있으니, TID 기준으로 중복 지급을 막는 로직이 필요해요.
ㆍ 알림이 100회까지 재전송된 뒤에도 실패하면, 파트너스에서 수동으로 지급할 수 있어요.
쿠폰으로 보상 받기
이용자가 이벤트·사전 등록·마케팅 등으로 받은 쿠폰 번호를 입력하면, 게임 내 아이템이나 캐시를 보상으로 받아요. 입력하는 곳은 플랫폼마다 다른데, iOS는 앱 안에서 직접 입력할 수 없어 스토브 웹사이트나 게임 공식 홈페이지를 이용해요.
| 플랫폼 | 쿠폰 입력 경로 | 비고 |
|---|---|---|
| Android (모바일) | 게임 내 쿠폰 등록 버튼 → SDK 쿠폰 팝업 | 인게임 팝업 권장 |
| iOS (모바일) | 스토브 웹사이트 쿠폰함 또는 게임 공식 홈페이지 | 앱 내 직접 입력 불가 |
| PC (Windows) | SDK 쿠폰 팝업 또는 스토브 웹사이트 · 게임 공식 홈페이지 | 멀티플랫폼 게임만 SDK 팝업 가능 |
| 웹 | 스토브 웹사이트 쿠폰함 · 게임 공식 홈페이지 | 스토브 로그인 필요 |
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 이용자 → 게임 클라이언트 | 쿠폰 번호 입력 (인게임 팝업 또는 웹) |
| 2 | 스토브 플랫폼 | 쿠폰 유효성 확인 (만료·중복·지급 조건) 유효하지 않으면 오류 안내 |
| 3 | 스토브 ItemBox → 게임 서버 | 게임 서버에 상품 지급 정보 전달 실패 시 10분 간격 최대 5회 재전송 |
| 4 | 게임 서버 → 이용자 | 상품 지급 후 이용자에게 완료 안내 |
| 상황 | 처리 방식 |
|---|---|
| 만료된 쿠폰 입력 | 오류 반환, 게임 서버에 지급 요청 없음 |
| 이미 사용한 쿠폰 재입력 | 중복 사용 오류 반환, 이용자에게 안내 |
| ItemBox 전송 실패 | 10분 간격 최대 5회 재전송 동일 transaction_id이므로 게임 서버에서 중복 방어 필요 |
| 점검·장애로 지급 실패 | 파트너스에서 수동 재처리 가능 |
이건 꼭 알아 두세요
ㆍ transaction_id를 게임 서버에 저장해 중복 지급을 막아요. 이미 지급된 건이 재요청되면 return_code를 "0"으로 응답해요.
ㆍ 쿠폰에 여러 아이템을 매핑하면 지급 요청도 그만큼 늘어나요. 꾸러미 상품으로 묶어 한 번에 받도록 구성하길 권장해요.
구독 상품 구매하기
이용자가 구독 상품을 한 번 구매하면, 정해진 주기마다 자동으로 갱신되며 혜택이 이어져요. Google Play와 Apple App Store에서 지원하고, 자동 갱신형만 제공해요.
※ 연동에는 SDK v2.6.0 이상과 마켓별 서버 알림 설정이 필요해요.
| OS/지원 마켓 | 구독 갱신 주기 | 구독 유형 |
|---|---|---|
| Android / Google Play Store | 주간 / 1개월 / 3개월 / 6개월 / 연간 | 자동 갱신형만 지원 |
| iOS / Apple App Store | 주간 / 1개월 / 2개월 / 3개월 / 6개월 / 연간 | 자동 갱신형만 지원 |
| 마켓 | 설정 위치 | 필요 설정 |
|---|---|---|
| Google Play | 마켓 콘솔 | Pub/Sub Topic · Subscription 등록 스토브 빌링 서버 URL을 엔드포인트로 설정 |
| Apple App Store | 마켓 콘솔 / 파트너스 | App Store Connect에 서버 알림 URL(버전 2) 등록 |
이건 꼭 알아 두세요
ㆍ 구독 상품은 자동 갱신형만 지원해요. 비갱신 구독 상품은 지원하지 않아요.
ㆍ iOS는 2025년 1월 이후 기존 서버 알림 방식(버전 1)을 더 이상 지원하지 않아요.
ㆍ App Store Connect에서 서버 알림 URL을 반드시 버전 2 알림으로 설정해야 해요.
구매 취소·환불 흐름
이용자가 아이템을 받은 뒤 마켓에서 결제를 직접 취소하면, 받은 아이템을 그대로 쓰는 일을 막아야 해요. 스토브 빌링이 이런 환불 내역을 모아 게임 서버에 알려 주고, 게임사는 재결제를 안내하거나 콘텐츠 이용을 제한해요.
환불은 처리 방식에 따라 정상 환불과 비정상 환불로 나뉘어요.
| 구분 | 내용 |
|---|---|
| 비정상 환불 | ㆍ 게임 내 운영 정책이나 안내된 프로세스와 무관하게, 이용자가 마켓에 직접 취소를 요청해 환불받은 거래 ㆍ 구매했던 아이템·혜택이 회수되지 않아 일시적인 어뷰징으로 간주 ㆍ 해당 금액을 재결제하면 정상 이용 가능 |
| 정상 환불 | ㆍ 환불 가능한 상태인지 게임 운영자가 확인한 후 취소하는 거래 ㆍ 환불 가능 여부는 구매 후 경과 기간, 아이템 손상·미사용, 잔여 아이템 회수 등을 종합해 판단 ㆍ 재결제 대상이 아님 |
아래는 이용자가 마켓에서 직접 결제를 취소한 비정상 환불이 발생했을 때의 처리 흐름이에요.
| 단계 | 처리 주체 | 내용 |
|---|---|---|
| 1 | 이용자 → 마켓 | 아이템 수령 후 마켓에서 직접 환불 요청 |
| 2 | 스토브 빌링 → 게임 서버 | 5분 주기로 비정상 환불 목록을 게임 서버에 전달 |
| 3 | 게임 서버 → 이용자 | 재결제 안내 팝업 또는 콘텐츠 이용 제한 재결제 시 voided_tid로 환불 건을 확인하고, 아이템은 추가 지급하지 않음 |
이건 꼭 알아 두세요
ㆍ 재결제는 아이템 지급이 아닌 환불 금액 회수 목적으로 처리돼요.
ㆍ 비정상 환불 기능 구현 전 퍼블리싱 담당자와 반드시 사전 협의가 필요해요.
ㆍ 판매 종료된 상품이더라도 재결제 팝업 처리를 위해 파트너스와 마켓에서 판매 상태를 유지해야 해요.
미성년자 결제 제한 안내
대한민국(KR)에서 서비스하는 게임은 청소년 이용자가 결제할 때, 게임물관리위원회 등급 기준에 따른 제한을 받아요. 여기서 청소년은 연 나이(현재 연도에서 출생 연도를 뺀 나이) 19세 미만을 의미하며, 만 나이와는 달라요. 이 제한은 스토브 플랫폼이 자동으로 적용하므로, 게임사가 따로 구현할 필요는 없어요.
| 항목 | 내용 |
|---|---|
| 적용 대상 | 대한민국(KR) 게임 내 연 나이 19세 미만 이용자 |
| 제한 기준 | 월 결제 한도 · 결제 가능 시간대 제한 |
| 처리 방식 | 본인 인증 연령 기반으로 자동 처리 (게임사 구현 불필요) |
| 이용자 안내 | 한도 초과 · 제한 시간대 접근 시 스토브 안내 화면 자동 노출 |
결제 한도는 빌링 환경과 이용자 유형에 따라 달라요. 아래는 대표적인 기준이며, 국가별 법령에 따라 달라질 수 있어요.
| 빌링 환경 | 이용자 유형 | 한도 |
|---|---|---|
| PC 빌링 | 미성년자 | 월 7만 원 |
| PC 빌링 | 성인 | 월 10만 원 ～ 3천만 원 범위에서 자율 설정 |
| 모바일 빌링 | 미성년자 | 1일 50만 원 충전, 소진 후 익일 재충전 FamilyLink로 보호자가 결제 허락 등 제어 |
| 모바일 빌링 | 성인 | 1일 50만 원 충전, 소진 후 익일 재충전 사실상 한도 없음 |
※ 일본 등 일부 국가는 자금결제법 등 현지 법령에 따라 미성년자 한도가 별도로 적용될 수 있어요.
이건 꼭 알아 두세요
ㆍ 미성년자 결제 제한은 스토브 본인 인증(KR)으로 확인한 연령을 기준으로 동작해요.
ㆍ 본인 인증은 PC·웹에서 이뤄지며, 멀티플랫폼 게임은 PC 최초 실행 시 1회 적용돼요. 본인 인증이 없는 환경에서는 연령 확인이 불가능해 결제가 제한될 수 있어요.
ㆍ 본인 인증 절차는 로그인하기 문서에서 자세히 확인할 수 있어요.
연동개요
전체 적용 흐름
| 단계 | 활동 주체 | 상세 내용 |
|---|---|---|
| 1단계 | 게임사 기획팀 | 적용 범위 결정 후 퍼블리싱 담당자에게 전달 ㆍ 지원 마켓 (Google Play · Apple App Store · Huawei · Amazon · PC) ㆍ 구독 상품 도입 여부 ㆍ 비정상 환불 대응 여부 ※ 구독 · 비정상 환불은 Google Play · Apple App Store만 지원 |
| 2단계 | 기획팀 · 퍼블리싱 담당자 | 파트너스 빌링 · 마켓 정보 설정 |
| 3단계 | 게임사 개발팀 | 클라이언트 SDK 결제 연동 ※ 구독 도입 시 SDK v2.6.0 이상 |
| 4단계 | 게임사 개발팀 | 서버 알림 수신 · 지급 처리 구현 |
| 5단계 | 게임사 QA팀 | 검증 후 배포 (Sandbox → Live) |
역할 분담
결제 연동에서 스토브가 처리하는 영역과 게임사가 직접 구현하는 영역을 구분하면 개발팀과 소통하기 수월해요.
스토브 플랫폼이 제공하는 것
게임사가 구현해야 하는 것마켓별 지원 범위
| 결제 유형 | Google Play · Apple App Store | Huawei · Amazon | PC |
|---|---|---|---|
| 일반 결제 | 지원 | 지원 | 지원 |
| 구독 결제 | 지원 | 미지원 | 미지원 |
| 비정상 환불 수집 | 지원 | 미지원 | 미지원 |
환경 구분 안내
연동 테스트는 반드시 Sandbox(샌드박스) 환경에서 먼저 진행한 뒤, 검증이 완료된 후 Live 환경에 적용해요.
| 구분 | Sandbox (샌드박스) | Live (운영) |
|---|---|---|
| API Host | https://api.gate8.com | https://api.onstove.com |
| 웹 / 플랫폼 | https://www.gate8.com | https://www.onstove.com |
| 용도 | 개발·QA 테스트 전용. 실 이용자에게 영향 없음 | 실제 서비스 환경. QA 완료 후 배포 |
체크리스트
| 구분 | 역할 | 점검항목 |
|---|---|---|
| 필수 | 게임 클라이언트 | STOVE Mobile SDK 결제 모듈 적용 확인
|
| 필수 | 게임 클라이언트 | 파트너스 빌링 연동 정보 등록 확인
|
| 필수 | 게임 서버 | 결제 완료 알림 수신 처리 구현
|
| 필수 | 게임 서버 | TID 기반 중복 지급 방지 로직 구현
|
| 권장 | 게임 서버 | 비정상 환불 재결제 처리 로직 구현
|