HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments. More...

Classes
class	HIVEIAPV4
	HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments. More...

class	HIVEIAPV4Product
	HIVE IAP v4 상품 정보 More...

class	HIVEIAPV4Receipt
	HIVE IAP v4 결제 영수증 정보 More...

class	HIVEIAPV4ReceiptApple
	HIVE IAP v4 애플 결제 영수증 정보 More...

Typedefs
typedef void(^	HIVEIAPV4MarketConnectHandler) (HIVEResultAPI result, NSArray< NSNumber > *marketIDs)
	HIVE IAPV4 Market information request result callback. More...

typedef void(^	HIVEIAPV4ProductInfoHandler) (HIVEResultAPI result, NSArray< HIVEIAPV4Product > *productInfoList, NSUInteger balance)
	HIVE IAPV4 Product Information request callback. More...

typedef void(^	HIVEIAPV4PurchaseHandler) (HIVEResultAPI result, HIVEIAPV4Receipt receipt)
	Purchase request result callback The purchase of HIVE IAPV4 will require a marketPid registered in the App Store and Google Store. More...

typedef void(^	HIVEIAPV4RestoreHandler) (HIVEResultAPI result, NSArray< HIVEIAPV4Receipt > *receiptList)
	HIVE IAPV4 Restore request result callback It may happen that the item delivery fails due to various situations in the product purchase process. More...

typedef void(^	HIVEIAPV4TransactionFinishHandler) (HIVEResultAPI result, NSString marketPid)
	HIVE IAP v4 Transaction Finish request result callback More...

typedef void(^	HIVEIAPV4TransactionMultiFinishHandler) (NSArray< HIVEResultAPI > resultList, NSArray< NSString > marketPidList)
	HIVE IAP v4 Multiple Transaction Finish request result callback More...

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

Functions
typedef	NS_ENUM (NSUInteger, HIVEIAPV4Type)
	결제 마켓 형태 More...

(void)	+ HIVEIAPV4::marketConnect:
	IAPV4 It initialize IAPV4 Purchase module. More...

(void)	+ HIVEIAPV4::getProductInfo:
	HIVE IAPV4 It returns information for composition of the product. More...

(void)	+ HIVEIAPV4::getSubscriptionProductInfo:
	HIVE IAPV4 It returns information for composition of the product. More...

(void)	+ HIVEIAPV4::purchase:additionalInfo:handler:
	HIVE IAPV4 The purchase will require a marketPid from the App Store and Google Store. More...

(void)	+ HIVEIAPV4::purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:
	HIVE IAPV4 The purchase will require a marketPid from the App Store and Google Store. More...

(void)	+ HIVEIAPV4::restore:
	HIVE IAPV4 It restore the item that has not been delivered. More...

(void)	+ HIVEIAPV4::restoreSubscription:
	HIVE IAPV4 It restore the item that has not been delivered. More...

(void)	+ HIVEIAPV4::transactionFinish:handler:
	HIVE IAP v4 It requests the transaction completion processing for the purchase receipt of the item that have been delivered. More...

(void)	+ HIVEIAPV4::transactionMultiFinish:handler:
	HIVE IAP v4 It requests the multiple transaction completion processing for the purchase receipt of the item that have been delivered. More...

Detailed Description

HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments.

* Currently, HIVE IAP supports Apple App Store, Google Play Store, One Store (https://www.tstore.co.kr) and HIVE Lobby (Lebi).
HIVE LIVE (Lebi) store is a system that can organize stores and purchase goods in Chinese market. It is operated by HIVE itself.

Typedef Documentation

§ HIVEIAPV4CheckPromotePurchaseHandler

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

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

Parameters

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

§ HIVEIAPV4MarketConnectHandler

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

HIVE IAPV4 Market information request result callback.

Parameters

result	Result of API call
marketIDs	사용 가능한 마켓 정보의 목록 This list of market information means the market available on the game client. If there is more than one market list, you must provide a screen that display the available market list to the user so that the user can select a store.

See also: HIVEResultAPI

§ HIVEIAPV4ProductInfoHandler

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

HIVE IAPV4 Product Information request callback.

Parameters

result	Result of API call
productInfoList	Product Information
balance	Balance information for HIVE Lebi Market If Lebi Market enabled.

See also: HIVEResultAPI; HIVEIAPV4Product

§ HIVEIAPV4PurchaseHandler

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

Purchase request result callback
The purchase of HIVE IAPV4 will require a marketPid registered in the App Store and Google Store.

additionalInfo is supplementary information for the purchase request, and is included in the purchase completion callback,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in receipt.

Parameters

result	Result of API call
receipt	It includes the purchased product information and additionalInfo.

See also: HIVEResultAPI; HIVEIAPV4Receipt

§ HIVEIAPV4RestoreHandler

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

HIVE IAPV4 Restore request result callback
It may happen that the item delivery fails due to various situations in the product purchase process.

In order to prepare for this situation, you should request to deliver the item that has not been delivered.

Parameters

result	Result of API call
receiptList	It includes the purchased product information and additionalInfo

See also: HIVEResultAPI; HIVEIAPV4Receipt

§ HIVEIAPV4TransactionFinishHandler

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

HIVE IAP v4 Transaction Finish request result callback

Parameters

result	Result of API call
marketPid	marketPid of the product whose transaction ended

See also: HIVEResultAPI; HIVEIAPV4TransactionMultiFinishHandler

§ HIVEIAPV4TransactionMultiFinishHandler

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

HIVE IAP v4 Multiple Transaction Finish request result callback

Parameters

resultList	Result list of the transaction end
marketPidList	marketPid list of the transaction end

See also: HIVEIAPV4TransactionFinishHandler

Function Documentation

§ getProductInfo:()

+ (void) getProductInfo: (HIVEIAPV4ProductInfoHandler) handler

HIVE IAPV4 It returns information for composition of the product.

Parameters

handler Result of API call

See also: HIVEIAPV4ProductInfoHandler; HIVEIAPV4Product

§ getSubscriptionProductInfo:()

+ (void) getSubscriptionProductInfo: (HIVEIAPV4ProductInfoHandler) handler

HIVE IAPV4 It returns information for composition of the product.

Parameters

handler Result of API call

Since: 4.11.6

§ marketConnect:()

+ (void) marketConnect: (HIVEIAPV4MarketConnectHandler) handler

IAPV4 It initialize IAPV4 Purchase module.

When HIVE IAPV4 is initialized, it sends a list of available market information in the result callback.
This list of market information means the market available on the game client.

Parameters

handler Result of API call

See also: 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 The purchase will require a marketPid from the App Store and Google Store.

additionalInfo is supplementary information for the purchase request, and is included in the purchase completion callback,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in iapV4Receipt.

Parameters

marketPid	Unique code registered on the App Store or Google Store.
additionalInfo	A string containing supplementary information about the purchase request, specified by the developer.
handler	Result of API call

See also: HIVEIAPV4PurchaseHandler; HIVEIAPV4Product

§ purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:()

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

HIVE IAPV4 The purchase will require a marketPid from the App Store and Google Store.

additionalInfo is supplementary information for the purchase request, and is included in the purchase completion callback,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in iapV4Receipt.

Parameters

marketPid	Unique code registered on the App Store or Google Store.
oldMarketPid	Unique code registered on the App Store or Google Store. (Android Only)
additionalInfo	A string containing supplementary information about the purchase request, specified by the developer. (Android Only)
handler	Result of API call

Since: 4.11.6

§ restore:()

+ (void) restore: (HIVEIAPV4RestoreHandler) handler

HIVE IAPV4 It restore the item that has not been delivered.

It may happen that the item delivery fails due to various situations in the product purchase process.
In order to prepare for this situation, you should request to deliver the item that has not been delivered.

Parameters

handler API 결과 통지

See also: HIVEIAPV4RestoreHandler; HIVEIAPV4Product

§ restoreSubscription:()

+ (void) restoreSubscription: (HIVEIAPV4RestoreHandler) handler

HIVE IAPV4 It restore the item that has not been delivered.

Parameters

handler Result of API call

Since: 4.11.6

§ transactionFinish:handler:()

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

HIVE IAP v4 It requests the transaction completion processing for the purchase receipt of the item that have been delivered.

At the completion of item delivery after purchasing or restoring, this API should be called to complete the purchase on the market.

Warning: If you do not notify the completion of the purchase to the market after payment has been made, it will be left as an unpaid item..
Since the unpaid items will continue to be recovered until the transactionFinish API call, you should check for duplicate receipts.

Parameters

marketPid	The unique ID of the item for which the transaction is to be completed.
handler	Result of API call

See also: HIVEIAPV4TransactionFinishHandler; + transactionMultiFinish:handler:

§ transactionMultiFinish:handler:()

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

HIVE IAP v4 It requests the multiple transaction completion processing for the purchase receipt of the item that have been delivered.

At the completion of item delivery after purchasing or restoring, this API should be called to complete the purchase on the market.

Warning: If you do not notify the completion of the purchase to the market after payment has been made, it will be left as an unpaid item..
Since the unpaid items will continue to be recovered until the transactionFinish API call, you should check for duplicate receipts.

Parameters

marketPid	The list of unique ID of the item for which the transaction is to be completed.
handler	Result of API call

See also: HIVEIAPV4TransactionFinishHandler; + transactionFinish:handler:

HIVE SDK for iOS

Classes

Typedefs

Functions

Detailed Description

Typedef Documentation

§ HIVEIAPV4CheckPromotePurchaseHandler

§ HIVEIAPV4MarketConnectHandler

§ HIVEIAPV4ProductInfoHandler

§ HIVEIAPV4PurchaseHandler

§ HIVEIAPV4RestoreHandler

§ HIVEIAPV4TransactionFinishHandler

§ HIVEIAPV4TransactionMultiFinishHandler

Function Documentation

§ getProductInfo:()

§ getSubscriptionProductInfo:()

§ marketConnect:()

§ NS_ENUM()

§ purchase:additionalInfo:handler:()

§ purchaseSubscriptionUpdate:oldMarketPid:additionalInfo:handler:()

§ restore:()

§ restoreSubscription:()

§ transactionFinish:handler:()

§ transactionMultiFinish:handler:()