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

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

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

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

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

타입정의
typedef void(^	HIVEIAPMarketInfoHandler) (HIVEResultAPI result, NSArray< NSNumber > *marketIDs)
	HIVE IAP 에서 상점 및 상품의 구성을 위한 정보 조회 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPShopInfoHandler) (HIVEResultAPI result, HIVEIAPShop iapShop, NSUInteger balance)
	HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPPurchaseHandler) (HIVEResultAPI result, HIVEIAPProduct product, NSString *iapTransactionId)
	상품 결제 시도 결과 통지 상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다. 더 자세히 ...

typedef void(^	HIVEIAPRestoreHandler) (HIVEResultAPI result, NSArray< HIVEIAPProduct > productList, NSArray< NSString > *iapTransactionIdList)
	HIVE IAP 상품에 대한 미지급된 아이템 지급을 요청 결과 통지 상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다. 더 자세히 ...

typedef void(^	HIVEIAPPurchaseReceiptHandler) (HIVEResultAPI result, HIVEIAPReceipt receipt)
	상품 결제 시도 결과 통지 상품은 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 과 HIVE IAP 백오피스에 등록된 HIVE IAP 상품 (gamePid) 으로 구분된다. 더 자세히 ...

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

typedef void(^	HIVEIAPCheckPromotePurchaseHandler) (HIVEResultAPI result, NSString gamePid)
	iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지 더 자세히 ...

함수
typedef	NS_ENUM (NSUInteger, HIVEIAPType)
	결제 마켓 형태 더 자세히 ...

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

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

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

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

상세한 설명

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

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

타입정의 문서화

§ HIVEIAPCheckPromotePurchaseHandler

typedef void(^ HIVEIAPCheckPromotePurchaseHandler) (HIVEResultAPI *result, NSString *gamePid)

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

매개변수

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

§ HIVEIAPMarketInfoHandler

typedef void(^ HIVEIAPMarketInfoHandler) (HIVEResultAPI *result, NSArray< NSNumber * > *marketIDs)

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

매개변수

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

  ^(HIVEIAPMarketInfoHandler)(HIVEResultAPI *result, NSArray<NSNumber *> *marketIDs) {
if (result.isSuccess) {
 for (NSNumber marketID in marketIDs) {
  HIVEIAPType type  = (HIVEIAPType)[marketID integerValue];
        
  switch (type) {
   // do something...
  }
 }
}
};

§ HIVEIAPPurchaseHandler

typedef void(^ HIVEIAPPurchaseHandler) (HIVEResultAPI *result, HIVEIAPProduct *product, NSString *iapTransactionId)

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

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

매개변수

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

잘못된 코드:: use HIVEIAPPurchaseReceiptHandler instead.

§ HIVEIAPPurchaseReceiptHandler

typedef void(^ HIVEIAPPurchaseReceiptHandler) (HIVEResultAPI *result, HIVEIAPReceipt *receipt)

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

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

§ HIVEIAPRestoreHandler

typedef void(^ HIVEIAPRestoreHandler) (HIVEResultAPI *result, NSArray< HIVEIAPProduct * > *productList, NSArray< NSString * > *iapTransactionIdList)

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

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

매개변수

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

잘못된 코드:: use HIVEIAPRestoreReceiptHandler instead.

§ HIVEIAPRestoreReceiptHandler

typedef void(^ HIVEIAPRestoreReceiptHandler) (HIVEResultAPI *result, NSArray< HIVEIAPReceipt * > *receiptList)

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

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

매개변수

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

§ HIVEIAPShopInfoHandler

typedef void(^ HIVEIAPShopInfoHandler) (HIVEResultAPI *result, HIVEIAPShop *iapShop, NSUInteger balance)

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

매개변수

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

함수 문서화

§ getShopInfo:handler:()

+ (void) getShopInfo:	(NSString *)	locationCode
handler:	(HIVEIAPShopInfoHandler)	handler

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

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

매개변수

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

§ initialize:()

+ (void) initialize: (HIVEIAPMarketInfoHandler) handler

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

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

매개변수

handler API 결과 통지

§ NS_ENUM()

typedef NS_ENUM	(	NSUInteger	,
		HIVEIAPType
	)

결제 마켓 형태

< kHIVEIAPTypeAppStore Apple App Store

< kHIVEIAPTypeGoogle Google Play Store

< kHIVEIAPTypeLebi HIVE Lebi Store

< kHIVEIAPTypeOneStore One Store

§ purchase:additionalInfo:handler:()

+ (void) purchase:	(NSString *)	pid
additionalInfo:	(NSString *)	additionalInfo
handler:	(HIVEIAPPurchaseReceiptHandler)	handler

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

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

매개변수

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

§ restoreReceipt:()

+ (void) restoreReceipt: (HIVEIAPRestoreReceiptHandler) handler

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

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

매개변수

handler API 결과 통지

HIVE SDK for iOS

클래스

타입정의

함수

상세한 설명

타입정의 문서화

§ HIVEIAPCheckPromotePurchaseHandler

§ HIVEIAPMarketInfoHandler

§ HIVEIAPPurchaseHandler

§ HIVEIAPPurchaseReceiptHandler

§ HIVEIAPRestoreHandler

§ HIVEIAPRestoreReceiptHandler

§ HIVEIAPShopInfoHandler

함수 문서화

§ getShopInfo:handler:()

§ initialize:()

§ NS_ENUM()

§ purchase:additionalInfo:handler:()

§ restoreReceipt:()