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표시 금액과
    상시적으로 변경될 수 있는 마켓 결제 팝업 금액이 다를 수 있으므로, 마켓(=모듈)의 금액을 인게임 상점으로
    불러오는 방식으로 구현해야 한다.
Google

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) -> 결제 팝업 노출