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

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

class	HIVEIAPV4Product
	HIVE IAP v4 상품 정보 더 자세히 ...

class	HIVEIAPV4Receipt
	HIVE IAP v4 결제 영수증 정보 더 자세히 ...

class	HIVEIAPV4ReceiptApple
	HIVE IAP v4 애플 결제 영수증 정보 더 자세히 ...

타입정의
typedef void(^	HIVEIAPV4MarketConnectHandler) (HIVEResultAPI result, NSArray< NSNumber > *marketIDs)
	HIVE IAPV4 에서 마켓의 구성을 위한 정보 조회 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPV4ProductInfoHandler) (HIVEResultAPI result, NSArray< HIVEIAPV4Product > *productInfoList, NSUInteger balance)
	HIVE IAPV4 상품 정보 조회 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPV4PurchaseHandler) (HIVEResultAPI result, HIVEIAPV4Receipt receipt)
	상품 결제 시도 결과 통지 HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 을 요청하게 된다. 더 자세히 ...

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

typedef void(^	HIVEIAPV4TransactionFinishHandler) (HIVEResultAPI result, NSString marketPid)
	HIVE IAP v4에서 상품에 대한 지급 완료 후 결제 트랜잭션을 종료하기 위한 요청 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPV4TransactionMultiFinishHandler) (NSArray< HIVEResultAPI > resultList, NSArray< NSString > marketPidList)
	HIVE IAP v4에서 상품에 대한 지급 완료 후 복수 개의 결제 트랜잭션을 종료하기 위한 요청 결과 통지 더 자세히 ...

typedef void(^	HIVEIAPV4CheckPromotePurchaseHandler) (HIVEResultAPI result, NSString marketPid)
	Apple AppStore Promote InApp Purchase 동작으로 MarketPID를 얻어오기 위한 결과 통지 더 자세히 ...

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

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

(void)	+ HIVEIAPV4::getProductInfo:
	HIVE IAPV4 에서 상품의 구성을 위한 정보를 조회할 수 있다. 더 자세히 ...

(void)	+ HIVEIAPV4::getSubscriptionProductInfo:
	HIVE IAPV4 에서 구독형 상품의 구성을 위한 정보를 조회할 수 있다. 더 자세히 ...

(void)	+ HIVEIAPV4::purchase:additionalInfo:handler:
	HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 을 요청하게 된다. 더 자세히 ...

(void)	+ HIVEIAPV4::purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:
	HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 구독 상품 (marketPid) 을 요청하게 된다. 더 자세히 ...

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

(void)	+ HIVEIAPV4::restoreSubscription:
	HIVE IAPV4 상품에 대한 미지급된 구독 상품 지급을 요청한다. 더 자세히 ...

(void)	+ HIVEIAPV4::transactionFinish:handler:
	HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 트랜잭션 완료 처리를 요청한다. 더 자세히 ...

(void)	+ HIVEIAPV4::transactionMultiFinish:handler:
	HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 복수 개의 트랜잭션 완료 처리를 요청한다. 더 자세히 ...

상세한 설명

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

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

타입정의 문서화

§ HIVEIAPV4CheckPromotePurchaseHandler

typedef void(^ HIVEIAPV4CheckPromotePurchaseHandler) (HIVEResultAPI *result, NSString *marketPid)

Apple AppStore Promote InApp Purchase 동작으로 MarketPID를 얻어오기 위한 결과 통지

매개변수

result	API 호출 결과
marketPid	AppStore Promote InApp Purchase 동작으로 얻어온 MarketPID

§ HIVEIAPV4MarketConnectHandler

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

HIVE IAPV4 에서 마켓의 구성을 위한 정보 조회 결과 통지

매개변수

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

참고: HIVEResultAPI

§ HIVEIAPV4ProductInfoHandler

typedef void(^ HIVEIAPV4ProductInfoHandler) (HIVEResultAPI *result, NSArray< HIVEIAPV4Product * > *productInfoList, NSUInteger balance)

HIVE IAPV4 상품 정보 조회 결과 통지

매개변수

result	API 호출 결과
productInfoList	상품 정보
balance	HIVE Lebi 마켓의 경우 잔액 정보

참고: HIVEResultAPI; HIVEIAPV4Product

§ HIVEIAPV4PurchaseHandler

typedef void(^ HIVEIAPV4PurchaseHandler) (HIVEResultAPI *result, HIVEIAPV4Receipt *receipt)

상품 결제 시도 결과 통지
HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 을 요청하게 된다.

additionalInfo 의 경우 구매 요청에 대한 보충 정보로 구매 완료 콜백에 다시 포함되어 전송되지만
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수

result	API 호출 결과
receipt	구매 성공한 상품 정보 와 additionalInfo 를 포함한 정보

참고: HIVEResultAPI; HIVEIAPV4Receipt

§ HIVEIAPV4RestoreHandler

typedef void(^ HIVEIAPV4RestoreHandler) (HIVEResultAPI *result, NSArray< HIVEIAPV4Receipt * > *receiptList)

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

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

매개변수

result	API 호출 결과
receiptList	구매 성공한 상품 정보 와 additionalInfo 를 포함한 정보

§ HIVEIAPV4TransactionFinishHandler

typedef void(^ HIVEIAPV4TransactionFinishHandler) (HIVEResultAPI *result, NSString *marketPid)

HIVE IAP v4에서 상품에 대한 지급 완료 후 결제 트랜잭션을 종료하기 위한 요청 결과 통지

매개변수

result	API 호출 결과
marketPid	트랜잭션이 종료된 상품의 marketPid

참고: HIVEResultAPI; HIVEIAPV4TransactionMultiFinishHandler

§ HIVEIAPV4TransactionMultiFinishHandler

typedef void(^ HIVEIAPV4TransactionMultiFinishHandler) (NSArray< HIVEResultAPI * > *resultList, NSArray< NSString * > *marketPidList)

HIVE IAP v4에서 상품에 대한 지급 완료 후 복수 개의 결제 트랜잭션을 종료하기 위한 요청 결과 통지

매개변수

resultList	트랜잭션의 종료 결과 목록
marketPidList	트랜잭션이 종료된 상품의 marketPid 목록

참고: HIVEIAPV4TransactionFinishHandler

함수 문서화

§ getProductInfo:()

+ (void) getProductInfo: (HIVEIAPV4ProductInfoHandler) handler

HIVE IAPV4 에서 상품의 구성을 위한 정보를 조회할 수 있다.

매개변수

handler API 결과 통지

참고: HIVEIAPV4ProductInfoHandler; HIVEIAPV4Product

§ getSubscriptionProductInfo:()

+ (void) getSubscriptionProductInfo: (HIVEIAPV4ProductInfoHandler) handler

HIVE IAPV4 에서 구독형 상품의 구성을 위한 정보를 조회할 수 있다.

매개변수

handler API 결과 통지

Since: 4.11.6

§ marketConnect:()

+ (void) marketConnect: (HIVEIAPV4MarketConnectHandler) handler

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

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

매개변수

handler API 결과 통지

참고: HIVEIAPV4MarketConnectHandler

§ NS_ENUM()

typedef NS_ENUM	(	NSUInteger	,
		HIVEIAPV4Type
	)

결제 마켓 형태

< kHIVEIAPV4TypeAppleAppStore Apple AppStore

< kHIVEIAPV4TypeGooglePlayStore Google PlayStore

< kHIVEIAPV4TypeLebi HIVE Lebi Store

< kHIVEIAPV4TypeOneStore One Store

§ purchase:additionalInfo:handler:()

+ (void) purchase:	(NSString *)	marketPid
additionalInfo:	(NSString *)	additionalInfo
handler:	(HIVEIAPV4PurchaseHandler)	handler

HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 마켓 상품 (marketPid) 을 요청하게 된다.

additionalInfo 의 경우 구매 요청에 대한 보충 정보로 구매 완료 콜백에 다시 포함되어 전송되지만
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수

marketPid	App Store, Google Store 에 등록된 하나의 상품을 지칭하는 고유 코드
additionalInfo	구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다.
handler	API 결과 통지

경고: additionalInfo는 iOS에서는 지원되지 않음.

참고: HIVEIAPV4PurchaseHandler; HIVEIAPV4Product

§ purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:()

+ (void) purchaseSubscriptionUpdate:	(NSString *)	marketPid
oldMarketPid:	(NSString *)	oldMarketPid
additionalInfo:	(NSString *)	additionalInfo
handler:	(HIVEIAPV4PurchaseHandler)	handler

HIVE IAPV4 의 상품 구매는 App Store, Google Store 에 등록된 구독 상품 (marketPid) 을 요청하게 된다.

additionalInfo 의 경우 구매 요청에 대한 보충 정보로 구매 완료 콜백에 다시 포함되어 전송되지만
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다. Android타겟의 경우 구독형 상품을 업그레이드 하거나 다운그레이드를 수행하는 경우 기존에 구독중인 상품의 고유코드 oldMarketPid를 필수로 넣어야한다.

매개변수

marketPid	App Store, Google Store 에 등록된 하나의 상품을 지칭하는 새로운 구독 상품의 고유 코드
oldMarketPid	App Store, Google Store 에 등록된 하나의 상품을 지칭하는 기존 구독 상품의 고유 코드 (Android Only)
additionalInfo	구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다. (Android Only)
handler	API 결과 통지

Since: 4.11.6

§ restore:()

+ (void) restore: (HIVEIAPV4RestoreHandler) handler

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

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

매개변수

handler API 결과 통지

참고: HIVEIAPV4RestoreHandler; HIVEIAPV4Product

§ restoreSubscription:()

+ (void) restoreSubscription: (HIVEIAPV4RestoreHandler) handler

HIVE IAPV4 상품에 대한 미지급된 구독 상품 지급을 요청한다.

상품 구매 과정에서 여러가지 상황으로 인하여 구독 상태를 갱신하지 못할 수 있다.
구독 상태를 확인할 수 없는 경우, 구독 상태 복구를 요청 해야 한다.

매개변수

handler API 결과 통지

Since: 4.11.6

§ transactionFinish:handler:()

+ (void) transactionFinish:	(NSString *)	marketPid
handler:	(HIVEIAPV4TransactionFinishHandler)	handler

HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 트랜잭션 완료 처리를 요청한다.

구매나 복구 기능 사용 후 아이템 지급이 완료된 시점에 이 API를 호출하여 마켓에 구매 완료 처리를 해야한다.

경고: 만약, 지급 완료 후에도 마켓으로의 구매 완료 처리를 하지 않으면, 미지급된 상품으로 남는다.
미지급된 상품은 transactionFinish API 호출 전까지 계속 복구가 되므로, 영수증 중복 여부를 확인해야 한다.

매개변수

marketPid	지급이 완료되어 트랜잭션 완료 처리를 위한 상품의 고유 ID
handler	API 결과 통지

참고: HIVEIAPV4TransactionFinishHandler; + transactionMultiFinish:handler:

§ transactionMultiFinish:handler:()

+ (void) transactionMultiFinish:	(NSArray< NSString * > *)	marketPidList
handler:	(HIVEIAPV4TransactionMultiFinishHandler)	handler

HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 복수 개의 트랜잭션 완료 처리를 요청한다.

구매나 복구 기능 사용 후 아이템 지급이 완료된 시점에 이 API를 호출하여 마켓에 구매 완료 처리를 해야한다.

경고: 만약, 지급 완료 후에도 마켓으로의 구매 완료 처리를 하지 않으면, 미지급된 상품으로 남는다.
미지급된 상품은 transactionFinish API 호출 전까지 계속 복구가 되므로, 영수증 중복 여부를 확인해야 한다.

매개변수

marketPidList	지급이 완료되어 트랜잭션 완료 처리를 위한 상품의 고유 ID 목록
handler	API 결과 통지

참고: HIVEIAPV4TransactionFinishHandler; + transactionFinish:handler:

HIVE SDK for iOS

클래스

타입정의

함수

상세한 설명

타입정의 문서화

§ HIVEIAPV4CheckPromotePurchaseHandler

§ HIVEIAPV4MarketConnectHandler

§ HIVEIAPV4ProductInfoHandler

§ HIVEIAPV4PurchaseHandler

§ HIVEIAPV4RestoreHandler

§ HIVEIAPV4TransactionFinishHandler

§ HIVEIAPV4TransactionMultiFinishHandler

함수 문서화

§ getProductInfo:()

§ getSubscriptionProductInfo:()

§ marketConnect:()

§ NS_ENUM()

§ purchase:additionalInfo:handler:()

§ purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:()

§ restore:()

§ restoreSubscription:()

§ transactionFinish:handler:()

§ transactionMultiFinish:handler:()