HIVE IAP 는 마켓별 구매 프로세스의 개발 비용을 최소화 할 수 있고 구매 로그를 일관성 있게 수집하여 사업, 개발, 관리 부서에 필요한 정보를 제공할 수 있다. 더 자세히 ...

클래스
class	IAP
	HIVE IAP 는 마켓별 구매 프로세스의 개발 비용을 최소화 할 수 있고 구매 로그를 일관성 있게 수집하여 사업, 개발, 관리 부서에 필요한 정보를 제공할 수 있다. 더 자세히 ...

class	IAPShop
	HIVE IAP 백오피스에서 구성한 상점 정보 더 자세히 ...

class	IAPProduct
	HIVE IAP 백오피스에서 생성한 상품 정보 마켓에 등록된 상품(Market Pid)과 HIVE IAP 백오피스에 등록한 상품 (Game Pid) 의 정보를 포함한다. 더 자세히 ...

class	IAPReceipt
	purchase() 나 restoreReceipt() API 에서 받을 수 있는 결과 정보. 더 자세히 ...

타입정의
typedef std::function< void(ResultAPI const &result, std::vector< IAPType > const &iapTypeList)>	IAP::onIAPMarketInfo
	HIVE IAP 에서 상점 및 상품의 구성을 위한 정보 조회 결과 통지 더 자세히 ...

typedef std::function< void(ResultAPI const &result, IAPShop const &iapShop, int balance)>	IAP::onIAPShopInfo
	HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지 더 자세히 ...

typedef std::function< void(ResultAPI const &result, IAPProduct const &product, std::string const &transactionId)>	IAP::onIAPPurchase
	상품 결제 시도 결과 통지 상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다. 더 자세히 ...

typedef std::function< void(ResultAPI const &result, IAPReceipt const &receipt)>	IAP::onIAPPurchaseReceipt
	상품 결제 시도 결과 통지 상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다. 더 자세히 ...

typedef std::function< void(ResultAPI const &result, std::vector< IAPReceipt > const &receipts)>	IAP::onIAPRestoreReceipt
	HIVE IAP 상품에 대한 미지급된 아이템 지급을 요청 결과 통지 상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다. 더 자세히 ...

typedef std::function< void(ResultAPI const &result, int balance)>	IAP::onIAPBalanceInfo
	HIVE 러비 상점일 경우 잔액 확인 결과 통지 더 자세히 ...

typedef std::function< void(ResultAPI const &result, std::string gamePid)>	IAP::onCheckPromotePurchase
	iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지 더 자세히 ...

열거형 타입
enum class	IAPType { IAPType::APPLE_APPSTORE = 1 , IAPType::GOOGLE_PLAYSTORE , IAPType::HIVE_LEBI , IAPType::ONESTORE }
	결제 마켓 형태 더 자세히 ...

함수
static void	IAP::initialize (onIAPMarketInfo listener)
	IAP 결재 API 초기화 요청 HIVE IAP 의 초기화를 수행하면 결과 통지시 사용 가능한 마켓 정보의 목록을 전달하게 된다. 더 자세히 ...

static void	IAP::getShopInfo (std::string locationCode, onIAPShopInfo listener)
	HIVE IAP 에서 상점 및 상품의 구성을 위한 정보를 조회할 수 있다 상점은 판매 전략에 따라서 일반 상점, 스팟 (Spot) 상점, 이벤트 (Event) 상점을 노출 할 수 있다. 더 자세히 ...

static void	IAP::purchase (std::string gamePid, std::string additionalInfo, onIAPPurchaseReceipt listener)
	상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (pid) 으로 구분된다. 더 자세히 ...

static void	IAP::restoreReceipt (onIAPRestoreReceipt listener)
	HIVE IAP 상품에 대한 미지급된 아이템 지급을 요청한다. 더 자세히 ...

static void	IAP::showMarketSelection (onIAPMarketInfo listener)
	러비 상점이나 구글 상점을 선택하기 위한 창을 띄운다. 더 자세히 ...

static void	IAP::getBalanceInfo (onIAPBalanceInfo listener)
	러비 상점일 경우 잔액 정보 조회. 더 자세히 ...

static void	IAP::showCharge (onIAPBalanceInfo listener)
	러비 충전 페이지 노출 (Android only.) 더 자세히 ...

상세한 설명

HIVE IAP 는 마켓별 구매 프로세스의 개발 비용을 최소화 할 수 있고 구매 로그를 일관성 있게 수집하여 사업, 개발, 관리 부서에 필요한 정보를 제공할 수 있다.

JNI 환경변수와 JavaVM을 얻을 수 있는 클래스이다.

현재 HIVE IAP 가 제공하는 결제 마켓은 애플 앱스토어, 구글 플레이 스토어, 원스토어 (https://www.tstore.co.kr), HIVE 러비(Lebi) 을 제공한다.
HIVE 러비(Lebi) 상점은 중국 시장에서 상점을 구성하고 상품을 구매 할 수 있는 시스템으로서 HIVE 에서 자체적으로 운영하고 있다.

안드로이드에서만 사용된다.

타입정의 문서화

◆ onCheckPromotePurchase

typedef std::function<void(ResultAPI const & result, std::string gamePid)> IAP::onCheckPromotePurchase

iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지

매개변수

result	API 호출 결과
gamePid	구매 예약한 상점아이템의 gamePid

◆ onIAPBalanceInfo

typedef std::function<void(ResultAPI const & result, int balance)> IAP::onIAPBalanceInfo

HIVE 러비 상점일 경우 잔액 확인 결과 통지

매개변수

result	API 호출 결과
balance	HIVE 러비 상점일 경우 잔액

◆ onIAPMarketInfo

typedef std::function<void(ResultAPI const & result, std::vector<IAPType> const & iapTypeList)> IAP::onIAPMarketInfo

HIVE IAP 에서 상점 및 상품의 구성을 위한 정보 조회 결과 통지

매개변수

result	API 호출 결과
iapTypeList	사용 가능한 마켓 정보의 목록 이 마켓 정보의 목록은 게임 클라이언트에서 사용 가능한 마켓을 의미한다. 마켓 목록이 2개 이상이라면 유저가 상점을 선택할 수 있도록 게임에서 유저에게 노출할 수 있는 화면을 제공해야 한다

◆ onIAPPurchase

typedef std::function<void(ResultAPI const & result, IAPProduct const & product, std::string const & transactionId)> IAP::onIAPPurchase

상품 결제 시도 결과 통지
상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다.

HIVE IAP 의 상품 구매는 HIVE IAP 백오피스에 등록된 상품 (gamePid) 을 요청하게 된다

매개변수

result	API 호출 결과
product	구매 성공한 상품 정보
transactionId	HIVE IAP 서버의 트랜젝션 ID

잘못된 코드:: use onIAPPurchaseReceipt instead.

◆ onIAPPurchaseReceipt

typedef std::function<void(ResultAPI const & result, IAPReceipt const & receipt)> IAP::onIAPPurchaseReceipt

상품 결제 시도 결과 통지
상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다.

HIVE IAP 의 상품 구매는 HIVE IAP 백오피스에 등록된 상품 (gamePid) 을 요청하게 된다
(Note: 결재 시도전에 restore() 를 호출하여 미지급된 아이템 지급을 요청해야 한다)

◆ onIAPRestoreReceipt

typedef std::function<void(ResultAPI const & result, std::vector<IAPReceipt> const & receipts)> IAP::onIAPRestoreReceipt

HIVE IAP 상품에 대한 미지급된 아이템 지급을 요청 결과 통지
상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다.

이런 상황을 대비하기 위해서 미 지급된 아이템 지급을 요청 해야 한다.

매개변수

result	API call result
receipts	구매 성공한 상품 정보 리스트

◆ onIAPShopInfo

typedef std::function<void(ResultAPI const & result, IAPShop const & iapShop, int balance)> IAP::onIAPShopInfo

HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지

매개변수

result	API 호출 결과
iapShop	상점 정보
balance	HIVE Lebi 상점의 경우 잔액 정보

열거형 타입 문서화

◆ IAPType

enum class IAPType

strong

결제 마켓 형태

열거형 멤버
APPLE_APPSTORE	APPLE_APPSTORE Apple App Store
GOOGLE_PLAYSTORE	GOOGLE_PLAYSTORE Google Play Store
HIVE_LEBI	HIVE_LEBI HIVE Lebi
ONESTORE	ONESTORE OneStore

함수 문서화

◆ getBalanceInfo()

static void IAP::getBalanceInfo ( onIAPBalanceInfo listener )

static

러비 상점일 경우 잔액 정보 조회.

(Android only.)

매개변수

listener API 결과 통지

◆ getShopInfo()

static void IAP::getShopInfo	(	std::string	locationCode,
		onIAPShopInfo	listener
	)

static

HIVE IAP 에서 상점 및 상품의 구성을 위한 정보를 조회할 수 있다
상점은 판매 전략에 따라서 일반 상점, 스팟 (Spot) 상점, 이벤트 (Event) 상점을 노출 할 수 있다.

스팟 상점과 이벤트 상점은 HIVE 백오피스에 Location Code 를 설정하고, 게임의 노출 위치에 Location Code 를 삽입한다

매개변수

locationCode	백오피스에 설정된 상점 위치 코드 ex. “DEFAULT,”“MAIN”, “EVENT”, “SPOT”. DEFAULT 상점의 경우 백오피스 내 "상품등록", "시리즈 상품등록"의 모든 상품 목록을 반환한다.
listener	API 결과 통지

◆ initialize()

static void IAP::initialize ( onIAPMarketInfo listener )

static

IAP 결재 API 초기화 요청
HIVE IAP 의 초기화를 수행하면 결과 통지시 사용 가능한 마켓 정보의 목록을 전달하게 된다.

이 마켓 정보의 목록은 게임 클라이언트에서 사용 가능한 마켓을 의미한다.

매개변수

listener API 결과 통지

◆ purchase()

static void IAP::purchase	(	std::string	gamePid,
		std::string	additionalInfo,
		onIAPPurchaseReceipt	listener
	)

static

상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (pid) 으로 구분된다.

HIVE IAP 의 상품 구매는 HIVE IAP 백오피스에 등록된 상품 (pid) 을 요청하게 된다.
additionalInfo 의 경우 구매 요청에 대한 보충 정보로 구매 완료 콜백에 다시 포함되어 전송되지만
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수

gamePid	HIVE IAP 시스템에서 관리하는 하나의 상품을 지칭하는 고유 코드
additionalInfo	구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다.
listener	API 결과 통지

◆ restoreReceipt()

static void IAP::restoreReceipt ( onIAPRestoreReceipt listener )

static

HIVE IAP 상품에 대한 미지급된 아이템 지급을 요청한다.

상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다.
이런 상황을 대비하기 위해서 미 지급된 아이템 지급을 요청 해야 한다.
restore(IAPRestoreListener) API 와 다른점은 추가된 IAPReceipt 로 전달 되며 이 경우 additionalInfo 값도 포함되어 있다.

매개변수

listener API 결과 통지

◆ showCharge()

static void IAP::showCharge ( onIAPBalanceInfo listener )

static

러비 충전 페이지 노출 (Android only.)

매개변수

listener API 결과 통지

◆ showMarketSelection()

static void IAP::showMarketSelection ( onIAPMarketInfo listener )

static

러비 상점이나 구글 상점을 선택하기 위한 창을 띄운다.

(Android only.)
만약 Google Store 와 HIVE 러비(Lebi) 상점을 동시에 사용 가능한 상황이라면 유저가 상점 선택을 할 수 있도록 상점 선택 화면을 노출해야 한다

매개변수

listener API 결과 통지

HIVE SDK for C++

클래스

타입정의

열거형 타입

함수

상세한 설명

타입정의 문서화

◆ onCheckPromotePurchase

◆ onIAPBalanceInfo

◆ onIAPMarketInfo

◆ onIAPPurchase

◆ onIAPPurchaseReceipt

◆ onIAPRestoreReceipt

◆ onIAPShopInfo

열거형 타입 문서화

◆ IAPType

함수 문서화

◆ getBalanceInfo()

◆ getShopInfo()

◆ initialize()

◆ purchase()

◆ restoreReceipt()

◆ showCharge()

◆ showMarketSelection()