Hive SDK v1.19.1부터 IAP v1의 지원을 종료합니다. Hive SDK v1.19.1 이상의 환경에서는 Hive IAP v4를 적용하시기 바랍니다.
본 가이드는 Hive IAP v1에 대해 안내하며, Hive SDK v1.19.0 이하 환경에서 적용하실 수 있습니다.
Platform 구매
Hive IAP v1을 사용하여 iOS, Android 등 플랫폼 간 마켓별 과금 SDK를 각기 달리하여 적용해야 하는 부하를 줄일 수 있으며 과금 시 정해진 Flow와 로그를 남김으로써 통일된 로그와 정상 결제에 대한 인증을 보장한다.
러비(Lebi)란?
- 중국 본토 내에서 InApp 과금처리를 위해 자사에서 만든 모듈로서 러비(Lebi)라는 단위의 화폐를 충전하여 사용하는 방식이다.
- 국내에서 러비 과금 테스트가 필요할 시 플랫폼 라이브팀에 무조건 러비과금 선택 팝업이 뜨는 테스트 라이브러리를 요청해야 한다.
- 또한, 국내에서는 실제 결재가 되지 않기 때문에 러비 충전 할 Hive 아이디를 플랫폼 라이브팀에 전달하여 충전 요청을 하여 러비 사용 테스트를 진행 한다.
(추후 중국 지사을 통해 실제 과금 테스트 진행 필수)
아이템 가격표시 적용하기
용어 정리
| 통화기호 (Currency symbol) |
통화를 약칭하여 쓰는 상징적 기호이다. $, €, ₩, ¥ 과 같은 기호를 일컫는다. |
|---|---|
| 통화코드 (Currency code) |
통화의 이름을 3문자의 부호(통화 코드 라고도 알려짐)로 표현한 것으로 국제 표준화 기구가 정의한 코드(ISO 4217)이다. UED, EUR, KRW, JPY와 같은 코드를 일컫는다. |
시작하기 전에
- Apple, Google의 가격정책은 환율, 부가세 변동, 지원 통화 추가 등에 따라 상시 변동될 수 있다.
- Apple 마켓에서 판매중인 아이템 가격은 국가별로 환율이 정의된 Tier 표에 따라 결정된다.
가격 변동 시 Tier 표를 업데이트하여 모든 게임에 동일하게 적용된다. - Apple Tier 표가 업데이트 되면, Google 마켓에서 판매중인 아이템 가격도 Apple과 동일한 가격으로
변경하여 모든 게임에 동일하게 적용된다. - 아이템 가격표기 적용 시, 지원 화폐 및 금액을 고정(하드코딩)으로 하는 경우, 인게임 상점 UI표시 금액과
상시적으로 변경될 수 있는 마켓 결제 팝업 금액이 다를 수 있으므로, 마켓(=모듈)의 금액을 인게임 상점으로
불러오는 방식으로 구현해야 한다.
formattedString 사용
- Api.Inapp_Description의 formattedString을 이용하여 상점의 가격을 표기한다.
- 통화코드와 가격(ex. USD54.99) 또는 통화기호와 가격(ex. $54.99) 형태로 내려준다.
- “한국: ₩1,000, 미국: USD1.99, 일본: JYP100” 와 같이 국가별로 다른 형태로 전달될 수 있다.
(예시)
formattedString의 전달값 -> USD54.99 또는 $54.99
(변환 과정 없이 그대로 출력하면 됨)
Apple
formattedString 사용
- Api.Inapp_Description의 formattedString을 이용하여 상점의 가격을 표기한다.
- 통화코드와 가격을 “USD|54.99” 형태로 내려주며, “|” 구분자 제외 후 출력하면 된다.
(예시)
formattedString의 전달값 -> USD|54.99
구분자 제외 후 출력 -> USD54.99
앱스토어 내 인앱 구매 기능 지원
iOS 11 버전부터 앱스토어 내 인앱 구매(Promotional IAP) 기능을 지원한다. 애플 스토어의 상품 페이지 및 검색창에서 게임 내 인앱 상품을 노출할 수 있으며, 최대 20개까지 등록이 가능하다. Promotional IAP로 등록한 상품은 iOS 11 버전 이상에서만 볼 수 있다. 게임에서는 Hive SDK 1.12.1 이상 또는 Hive SDK 1.11.5 이상을 적용해야 Promotional IAP 기능을 사용할 수 있다.
애플 스토어에서 Promotional IAP 상품을 구매한 경우, 게임의 설치 여부에 따라 아래와 같은 플로우 제공한다.
- 게임 미설치 유저 : 구매 클릭 -> 게임 설치 페이지로 이동 -> 설치 -> 게임 진입-> 인증 완료 (인증 v1 또는 v4) -> 결제 팝업 노출
- 게임 설치 유저 : 구매 클릭 -> 게임으로 진입 -> 인증 완료 (인증 v1 또는 v4) -> 결제 팝업 노출
