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

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

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

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

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

열거형 타입
enum	hive.IAPType
	결제 마켓 형태 더 자세히 ...

함수
delegate void	hive.IAP.onIAPMarketInfo (ResultAPI result, List< IAPType > iapTypeList)
	HIVE IAP 에서 상점 및 상품의 구성을 위한 정보 조회 결과 통지 더 자세히 ...

delegate void	hive.IAP.onIAPShopInfo (ResultAPI result, IAPShop iapShop, int balance)
	HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지 더 자세히 ...

delegate void	hive.IAP.onIAPPurchaseReceipt (ResultAPI result, IAPReceipt iapReceipt)
	상품 결제 시도 결과 통지 상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다. 더 자세히 ...

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

delegate void	hive.IAP.onIAPBalanceInfo (ResultAPI result, int balance)
	HIVE 러비 상점일 경우 잔액 확인 결과 통지 더 자세히 ...

delegate void	hive.IAP.onIAPCheckPromotePurchase (ResultAPI result, String gamePid)
	iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지 더 자세히 ...

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

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

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

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

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

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

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

static void	hive.IAP.checkPromotePurchase (onIAPCheckPromotePurchase listener)
	iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지 등록 더 자세히 ...

상세한 설명

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

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

열거형 타입 문서화

◆ IAPType

enum hive.IAPType

결제 마켓 형태

함수 문서화

◆ checkPromotePurchase()

static void hive.IAP.checkPromotePurchase ( onIAPCheckPromotePurchase listener )

static

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

매개변수

listener API 결과 통지

◆ getBalanceInfo()

static void hive.IAP.getBalanceInfo ( onIAPBalanceInfo listener )

static

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

(Android only.)

매개변수

listener API 결과 통지

◆ getShopInfo()

static void hive.IAP.getShopInfo	(	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 hive.IAP.initialize ( onIAPMarketInfo listener )

static

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

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

매개변수

listener API 결과 통지

◆ onIAPBalanceInfo()

delegate void hive.IAP.onIAPBalanceInfo	(	ResultAPI	result,
		int	balance
	)

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

매개변수

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

◆ onIAPCheckPromotePurchase()

delegate void hive.IAP.onIAPCheckPromotePurchase	(	ResultAPI	result,
		String	gamePid
	)

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

매개변수

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

◆ onIAPMarketInfo()

delegate void hive.IAP.onIAPMarketInfo	(	ResultAPI	result,
		List< IAPType >	iapTypeList
	)

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

매개변수

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

◆ onIAPPurchaseReceipt()

delegate void hive.IAP.onIAPPurchaseReceipt	(	ResultAPI	result,
		IAPReceipt	iapReceipt
	)

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

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

작성자: imsunghoon

◆ onIAPRestoreReceipt()

delegate void hive.IAP.onIAPRestoreReceipt	(	ResultAPI	result,
		List< IAPReceipt >	receiptList
	)

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

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

매개변수

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

작성자: imsunghoon

◆ onIAPShopInfo()

delegate void hive.IAP.onIAPShopInfo	(	ResultAPI	result,
		IAPShop	iapShop,
		int	balance
	)

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

매개변수

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

◆ purchase()

static void hive.IAP.purchase	(	String	gamePid,
		String	additionalInfo,
		onIAPPurchaseReceipt	listener
	)

static

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

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

매개변수

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

◆ restore()

static void hive.IAP.restore ( onIAPRestoreReceipt listener )

static

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

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

매개변수

listener API 결과 통지

◆ showCharge()

static void hive.IAP.showCharge ( onIAPBalanceInfo listener )

static

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

매개변수

listener API 결과 통지

◆ showMarketSelection()

static void hive.IAP.showMarketSelection ( onIAPMarketInfo listener )

static

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

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

매개변수

listener API 결과 통지

HIVE SDK for Unity3D

클래스

열거형 타입

함수

상세한 설명

열거형 타입 문서화

◆ IAPType

함수 문서화

◆ checkPromotePurchase()

◆ getBalanceInfo()

◆ getShopInfo()

◆ initialize()

◆ onIAPBalanceInfo()

◆ onIAPCheckPromotePurchase()

◆ onIAPMarketInfo()

◆ onIAPPurchaseReceipt()

◆ onIAPRestoreReceipt()

◆ onIAPShopInfo()

◆ purchase()

◆ restore()

◆ showCharge()

◆ showMarketSelection()