- 마지막 업데이트
StoveIAP 릴리즈 노트
인앱 결제 모듈(iOS StoveIAP2 · Android stove-iap 과 마켓 모듈 · Unity · Unreal StoveIAP)의 버전별 변경 사항이에요.
4.0.0 (2026-11-13)
iOS 4.0.0 은 Xcode 27.1 이상에서 빌드해야 해요.
Xcode 27.1 이상에서는 SceneDelegate 적용과 모든 타깃의 Deployment Target 15.0 이상 설정이 필수예요. 모든 모듈을 4.0.0 으로 함께 교체해야 하고, 3.x 모듈과 섞어 쓸 수 없어요. 호출 코드는 바꾸지 않아도 돼요. 전체 업그레이드 절차는 Stove 4.0.0을 확인해 주세요.
함께 쓰는 버전
| 모듈 | 버전 |
|---|---|
| Stove · StoveProviders · StoveIAP · StovePush · StoveGameLog | 4.0.0 |
- 화웨이 · 원스토어 마켓 모듈(
stove-iap-huawei·stove-iap-onestore)도 4.0.0 으로 맞춰요.
개선 사항
- Android 모듈 버전을 하나의 Gradle 파일에서 관리하도록 바꿨어요.
모듈마다build.gradle에 따로 적던 버전을 공통 Gradle 설정 한 곳에서 모듈 단위로 관리해요. - iOS 는 Xcode 27.1 · iOS 27.1 SDK 빌드 환경을 기준으로 제공해요.
다운로드
| 플랫폼 | 받는 방법 |
|---|---|
| Android (Gradle) | com.stove:stove-iap:4.0.0 · com.stove:stove-iap-google:4.0.0 · com.stove:stove-iap-huawei:4.0.0 · com.stove:stove-iap-onestore:4.0.0 |
| iOS (CocoaPods) | pod 'StoveIAP2', '4.0.0' |
| Unity | StoveIAP-4.0.0.unitypackage · StoveIAPGoogle-4.0.0.unitypackage · StoveIAPHuawei-4.0.0.unitypackage · StoveIAPONEStore-4.0.0.unitypackage |
| Unreal | StoveIAP-4.0.0.zip |
3.1.1 (2026-11-11)
Unity iOS 빌드의 상품 가격(
priceAmountMicros) 부동소수점 오차를 고치고, SDK 내부 동작을 개선했어요.
이번에는 인앱 결제 모듈만 배포했어요. 3.1.0 을 쓰는 게임은 3.1.1 로 교체를 권장해요. 3.0.0 을 쓰는 게임은 같은 수정이 들어간 아래 3.0.1 을 쓰면 돼요. 다른 모듈은 그대로 써요.
한눈에 보기
| 변경 | 영향받는 게임 | 해야 할 일 |
|---|---|---|
Unity iOS priceAmountMicros 부동소수점 오차 개선 | Unity 엔진을 쓰는 게임 (iOS 빌드) | 권장 — 인앱 결제 모듈만 3.1.1 로 교체 |
| SDK 내부 개선 | 전체 | 권장 — 인앱 결제 모듈만 3.1.1 로 교체 |
함께 쓰는 버전
| 모듈 | 버전 |
|---|---|
| StoveIAP | 3.1.1 |
| Stove · StoveProviders · StovePush | 3.0.0 이상 |
💡 아직 2.9.x 를 쓰는 게임은 3.0.0 업그레이드 안내를 먼저 진행해 주세요.
업그레이드 시 해야 할 일
인앱 결제 모듈만 3.1.1 로 바꿔요.
호출 코드는 바꾸지 않아도 돼요. 다른 모듈은 그대로 둬요.
iOS (Podfile)
pod 'StoveIAP2', '3.1.1'
Android (build.gradle)
implementation 'com.stove:stove-iap:3.1.1'
implementation 'com.stove:stove-iap-google:3.1.1'
stove-iap와stove-iap-google을 함께 3.1.1 로 맞춰요. Android 는 iOS 와 같은 버전으로 맞춰 배포했어요.- 화웨이 · 원스토어 마켓 모듈은 3.1.1 배포 대상이 아니에요. 화웨이 · 원스토어 빌드는 인앱 결제 모듈을 3.0.0 그대로 써요.
Unity · Unreal
| 엔진 | 교체할 것 |
|---|---|
| Unity (iOS) | Podfile 의 StoveIAP2 를 3.1.1 로 변경 — 패키지는 3.1.0 을 써요 |
| Unity (Android) | mainTemplate.gradle 의 인앱 결제 좌표를 com.stove:stove-iap:3.1.1 · com.stove:stove-iap-google:3.1.1 로 변경 |
| Unreal (Android) | 게임 모듈 _APL.xml 의 인앱 결제 좌표를 com.stove:stove-iap:3.1.1 · com.stove:stove-iap-google:3.1.1 로 변경 |
| Unreal (iOS) | StoveIAP 플러그인을 3.1.1 로 교체(StoveIAP-3.1.1.zip) — 의존성만 바꿀 수 없어요 |
📌 3.1.1 핫픽스를 쓰려면 Unity 패키지 버전을 3.1.0 으로 맞춰 주세요.
StoveIAP-3.1.0.unitypackage · StoveIAPGoogle-3.1.0.unitypackage
버그 수정
- 상품 가격(
priceAmountMicros)의 부동소수점 오차를 개선했어요. (Unity iOS 빌드)
일부 가격에서 마이크로 단위 가격을 계산할 때 부동소수점 오차가 생겨 정수로 떨어지지 않았어요(예: $1.99 →1989999.9999999998). 이 때문에 쉼표를 소수점으로 쓰는 기기 언어 · 지역 설정(베트남어 등)에서 상품 가격이 실제보다 매우 큰 값으로 읽혔어요. 이제 마이크로 단위 가격을 항상 정수 값으로 계산해요. 필드 이름과 타입은 그대로예요.
개선 사항
- SDK 내부 동작을 개선했어요. (iOS · Android Google Play, Unity · Unreal 포함)
게임에 전달되는 결과와 호출 방식은 그대로예요.
다운로드
| 플랫폼 | 받는 방법 |
|---|---|
| Android (Gradle) | com.stove:stove-iap:3.1.1 · com.stove:stove-iap-google:3.1.1 |
| iOS (CocoaPods) | pod 'StoveIAP2', '3.1.1' |
| Unity | StoveIAP-3.1.0.unitypackage · StoveIAPGoogle-3.1.0.unitypackage — 패키지는 3.1.0 을 쓰고, 의존성 좌표만 3.1.1 로 변경해요 |
| Unreal | StoveIAP-3.1.1.zip |
💡 화웨이 · 원스토어 빌드는 아래 3.0.0 파일을 써요.
3.0.1 (2026-11-11)
Unity iOS 빌드의 상품 가격(
priceAmountMicros) 부동소수점 오차를 고치고, SDK 내부 동작을 개선했어요.
3.1.1 과 같은 수정을 3.0.0 기반으로 배포했어요. 구매 제한 정보(3.1.0)를 쓰지 않고 3.0.0 을 쓰는 게임은 3.0.1 로 교체를 권장해요. 다른 모듈은 그대로 써요.
한눈에 보기
| 변경 | 영향받는 게임 | 해야 할 일 |
|---|---|---|
Unity iOS priceAmountMicros 부동소수점 오차 개선 | Unity 엔진을 쓰는 게임 (iOS 빌드) | 권장 — 인앱 결제 모듈만 3.0.1 로 교체 |
| SDK 내부 개선 | 전체 | 권장 — 인앱 결제 모듈만 3.0.1 로 교체 |
함께 쓰는 버전
| 모듈 | 버전 |
|---|---|
| StoveIAP | 3.0.1 |
| Stove · StoveProviders · StovePush | 3.0.0 이상 |
업그레이드 시 해야 할 일
인앱 결제 모듈만 3.0.1 로 바꿔요.
호출 코드는 바꾸지 않아도 돼요. 다른 모듈은 그대로 둬요.
iOS (Podfile)
pod 'StoveIAP2', '3.0.1'
Android (build.gradle)
implementation 'com.stove:stove-iap:3.0.1'
implementation 'com.stove:stove-iap-google:3.0.1'
stove-iap와stove-iap-google을 함께 3.0.1 로 맞춰요. Android 는 iOS 와 같은 버전으로 맞춰 배포했어요.- 화웨이 · 원스토어 마켓 모듈은 3.0.1 배포 대상이 아니에요. 화웨이 · 원스토어 빌드는 인앱 결제 모듈을 3.0.0 그대로 써요.
Unity · Unreal
| 엔진 | 교체할 것 |
|---|---|
| Unity (iOS) | Podfile 의 StoveIAP2 를 3.0.1 로 변경 — 패키지는 3.0.0 을 그대로 써요 |
| Unity (Android) | mainTemplate.gradle 의 인앱 결제 좌표를 com.stove:stove-iap:3.0.1 · com.stove:stove-iap-google:3.0.1 로 변경 |
| Unreal (Android) | 게임 모듈 _APL.xml 의 인앱 결제 좌표를 com.stove:stove-iap:3.0.1 · com.stove:stove-iap-google:3.0.1 로 변경 |
| Unreal (iOS) | StoveIAP 플러그인을 3.0.1 로 교체(StoveIAP-3.0.1.zip) — 의존성만 바꿀 수 없어요 |
📌 3.0.1 핫픽스를 쓰려면 Unity 패키지 버전을 3.0.0 으로 맞춰 주세요.
StoveIAP-3.0.0.unitypackage · StoveIAPGoogle-3.0.0.unitypackage
버그 수정
- 상품 가격(
priceAmountMicros)의 부동소수점 오차를 개선했어요. (Unity iOS 빌드)
위 3.1.1 의 버그 수정과 같아요.
개선 사항
- SDK 내부 동작을 개선했어요. (iOS · Android Google Play, Unity · Unreal 포함)
게임에 전달되는 결과와 호출 방식은 그대로예요.
다운로드
| 플랫폼 | 받는 방법 |
|---|---|
| Android (Gradle) | com.stove:stove-iap:3.0.1 · com.stove:stove-iap-google:3.0.1 |
| iOS (CocoaPods) | pod 'StoveIAP2', '3.0.1' |
| Unity | 의존성 좌표만 변경 — 패키지는 3.0.0 을 그대로 써요 |
| Unreal | StoveIAP-3.0.1.zip |
💡 화웨이 · 원스토어 빌드는 아래 3.0.0 파일을 써요.
3.1.0 (2026-10-15)
상품 정보에 통합 구매 제한 필드가 추가됐어요.
이번에는 인앱 결제 모듈만 배포했어요. 구매 제한 수량을 상점에 표시하려는 게임만 인앱 결제 모듈을 교체하면 되고, 다른 모듈은 3.0.0 을 그대로 써요.
📌 3.1.0 구매 제한 정보는 iOS · Android · Unity · Unreal 에서 제공하며, Android 는 Google Play 한정이에요. 화웨이 · 원스토어에서는 지원하지 않는 기능이에요.
한눈에 보기
| 변경 | 영향받는 게임 | 해야 할 일 |
|---|---|---|
| 상품 정보에 통합 구매 제한 필드 추가 | 구매 제한 수량을 표시하려는 게임 | 선택 — 인앱 결제 모듈만 3.1.0 으로 교체 |
함께 쓰는 버전
| 모듈 | 버전 |
|---|---|
| StoveIAP | 3.1.0 |
| Stove · StoveProviders · StovePush | 3.0.0 이상 |
💡 아직 2.9.x 를 쓰는 게임은 3.0.0 업그레이드 안내를 먼저 진행해 주세요.
업그레이드 시 해야 할 일
1. 인앱 결제 모듈만 3.1.0 으로 바꿔요.
호출 코드는 바꾸지 않아도 돼요. 다른 모듈은 3.0.0 을 그대로 둬요.
iOS (Podfile)
pod 'StoveIAP2', '3.1.0'
Android (build.gradle)
implementation 'com.stove:stove-iap:3.1.0'
implementation 'com.stove:stove-iap-google:3.1.0'
stove-iap와stove-iap-google을 함께 3.1.0 으로 맞춰요. 구매 제한 정보는 Google Play 에서만 제공해요.- 화웨이 · 원스토어 마켓 모듈은 3.1.0 배포 대상이 아니에요. 화웨이 · 원스토어 빌드는 인앱 결제 모듈을 3.0.0 그대로 써요.
Unity · Unreal
| 엔진 | 교체할 것 |
|---|---|
| Unity | StoveIAP · StoveIAPGoogle 패키지(StoveIAP-3.1.0.unitypackage · StoveIAPGoogle-3.1.0.unitypackage), Podfile 의 StoveIAP2, mainTemplate.gradle 의 인앱 결제 좌표 |
| Unreal | StoveIAP 플러그인(StoveIAP-3.1.0.zip), 게임 모듈 _APL.xml 의 인앱 결제 좌표 |
새로운 기능
- 상품 정보에 통합 구매 제한 정보가 추가됐어요. (Unity · Unreal · Android Google Play · iOS)
상품 목록 조회 결과의 각 상품에purchaseLimit이 추가돼, 계정 · 캐릭터 · 월드 기준의 구매 제한 수량과 구매 수량을 상점에 표시할 수 있어요. 필드 설명과 유의 사항은 결제 가이드의 "구매 제한 정보 (3.1.0 이상)" 를 확인해 주세요.
📌 구매 제한 정보는 스토브 측 설정이 활성화된 게임에만 내려가요. 사용하려면 담당 기술 PL 에 문의해 주세요.
요구 환경
💡 3.0.0 과 같아요. 각 플랫폼(Apple · Google · 엔진)의 정책을 따라요.
다운로드
| 플랫폼 | 받는 방법 |
|---|---|
| Android (Gradle) | com.stove:stove-iap:3.1.0 · com.stove:stove-iap-google:3.1.0 |
| iOS (CocoaPods) | pod 'StoveIAP2', '3.1.0' |
| Unity | StoveIAP-3.1.0.unitypackage · StoveIAPGoogle-3.1.0.unitypackage |
| Unreal | StoveIAP-3.1.0.zip |
💡 화웨이 · 원스토어 빌드는 아래 3.0.0 파일을 써요.
3.0.0 (2026-10-08)
인앱 결제 모듈의 이름이 바뀌었어요.
모든 모듈을 함께 3.0.0 으로 교체해야 하고, 2.9.x 모듈과 섞어 쓸 수 없어요. 업그레이드 절차는 3.0.0 업그레이드 안내를 따라 주세요.
바뀐 이름
| 플랫폼 | 3.0.0 | 2.9.x |
|---|---|---|
| iOS (pod) | StoveIAP2 | SGSIAP2 |
| Android (Gradle) | stove-iap | iap |
| Android (Gradle) | stove-iap-google | iap-google |
| Android (Gradle) | stove-iap-huawei | iap-huawei |
| Android (Gradle) | stove-iap-onestore | iap-onestore |
💡 Unity · Unreal 은 마이그레이션 가이드(Unity) · 마이그레이션 가이드(Unreal)를 따라 주세요.
버그 수정
- iOS 결제가 완료됐는데 실패로 알리던 문제를 고쳤어요.
결제와 검증이 정상적으로 끝났는데도 트랜잭션 종료 단계의 불필요한 오류를 게임에 전달하던 문제예요.
다운로드
| 플랫폼 | 받는 방법 |
|---|---|
| Android (Gradle) | com.stove:stove-iap:3.0.0 · com.stove:stove-iap-google:3.0.0 · com.stove:stove-iap-huawei:3.0.0 · com.stove:stove-iap-onestore:3.0.0 |
| iOS (CocoaPods) | pod 'StoveIAP2', '3.0.0' |
| Unity | StoveIAP-3.0.0.unitypackage · StoveIAPGoogle-3.0.0.unitypackage · StoveIAPHuawei-3.0.0.unitypackage · StoveIAPONEStore-3.0.0.unitypackage |
| Unreal | StoveIAP-3.0.0.zip |
- 개발자센터 이용/스마일게이트 퍼블리싱 게임 관련: stove.developers@smilegate.com
- 스토브 스토어 입점/스토브 스튜디오 관련: store.support@smilegate.com