Hive IAP 가 제공하는 결제 마켓은 애플 앱스토어, 구글 플레이스토어, 원스토어, 삼성 갤럭시스토어, 아마존 앱스토어,
화웨이 앱커넥트, PG, Steam, Hive 러비(Lebi) 를 제공한다. 더 자세히 ...

클래스
class	FHiveIAPV4
	현재 Hive IAP 가 제공하는 결제 마켓은 애플 앱스토어, 구글 플레이스토어, 원스토어, 삼성 갤럭시스토어, 아마존 앱스토어, 페이스북 클라우드 게임, 화웨이 앱커넥트, PG, Steam, Hive 러비(Lebi) 를 제공한다. 더 자세히 ...

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

class	FHiveIAPV4Receipt
	Purchase 나 Restore API 에서 받을 수 있는 결과 정보. 더 자세히 ...

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

함수
static void	FHiveIAPV4::MarketConnect (const FHiveIAPV4OnMarketConnectDelegate &Delegate)
	IAPV4 결재 API 초기화 요청 Hive IAPV4 의 초기화를 수행하면 결과 통지시 사용 가능한 마켓 정보의 목록을 전달하게 된다. 더 자세히 ...

static void	FHiveIAPV4::GetMarketProductInfo (const TArray< FString > &MarketPidList, const FHiveIAPV4OnProductInfoDelegate &Delegate)
	Apple Appstore 에서 상품의 구성을 위한 정보를 조회할 수 있다. 더 자세히 ...

static void	FHiveIAPV4::GetProductInfo (const FHiveIAPV4OnProductInfoDelegate &Delegate)
	Hive IAPV4 에서 상품의 구성을 위한 정보를 조회할 수 있다. 더 자세히 ...

static void	FHiveIAPV4::GetSubscriptionProductInfo (const FHiveIAPV4OnProductInfoDelegate &Delegate)
	Hive IAPV4 에서 구독형 상품의 구성을 위한 정보를 조회할 수 있다. 더 자세히 ...

static void	FHiveIAPV4::Purchase (const FString &MarketPid, const FString &IapPayload, const FHiveIAPV4OnPurchaseDelegate &Delegate)
	App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다. 더 자세히 ...

static void	FHiveIAPV4::Purchase (const FString &MarketPid, const FString &IapPayload, int quantity, const FHiveIAPV4OnPurchaseDelegate &Delegate)
	App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다. 더 자세히 ...

static void	FHiveIAPV4::PurchaseSubscription (const FHiveIAPV4PurchaseParam &Param, const FHiveIAPV4OnPurchaseDelegate &Delegate)
	App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다. 더 자세히 ...

static void	FHiveIAPV4::Restore (const FHiveIAPV4OnRestoreDelegate &Delegate)
	Hive IAPV4 상품에 대한 미지급된 아이템 지급을 요청한다. 더 자세히 ...

static void	FHiveIAPV4::RestoreSubscription (const FHiveIAPV4OnRestoreDelegate &Delegate)
	HIVE IAPV4 상품에 대한 미지급된 구독 상품 지급을 요청한다. 더 자세히 ...

static void	FHiveIAPV4::TransactionFinish (const FString &MarketPid, const FHiveIAPV4OnTransactionFinishDelegate &Delegate)
	HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 트랜잭션 완료 처리를 요청한다. 더 자세히 ...

static void	FHiveIAPV4::TransactionMultiFinish (const TArray< FString > &MarketPidList, const FHiveIAPV4OnTransactionMultiFinishDelegate &Delegate)
	Hive IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 복수 개의 트랜잭션 완료 처리를 요청한다. 더 자세히 ...

static void	FHiveIAPV4::ShowMarketSelection (const FIAPV4OnMarketSelectionDelegate &Delegate)
	러비 상점이나 구글 상점을 선택하기 위한 창을 띄운다. 더 자세히 ...

static void	FHiveIAPV4::GetBalanceInfo (const FHiveIAPV4OnBalanceDelegate &Delegate)
	러비 상점일 경우 잔액 정보 조회. 더 자세히 ...

static void	FHiveIAPV4::ShowCharge (const FHiveIAPV4OnBalanceDelegate &Delegate)
	러비 충전 페이지 노출 더 자세히 ...

static void	FHiveIAPV4::CheckPromotePurchase (const FHiveIAPV4OnCheckPromotePurchaseDelegate &Delegate)
	Apple AppStore Promote InApp Purchase 동작으로 얻어온 MarketPID를 요청한다. 더 자세히 ...

static TOptional< EHiveIAPV4Type >	FHiveIAPV4::GetSelectedMarket ()
	현재 선택된 마켓 타입을 반환한다. 더 자세히 ...

static FString	FHiveIAPV4::GetAccountUuid ()
	현재 계정의 UUIDv3 값을 반환한다. 더 자세히 ...

static void	FHiveIAPV4::ShowInAppMessages (int32 CategoryId, const FHiveIAPV4OnInAppMessagesDelegate &Delegate)
	Google In-App Offers 더 자세히 ...

static void	FHiveIAPV4::GetConsumeInfoAgreement (const FHiveIAPV4OnGetConsumeInfoAgreementDelegate &Delegate)
	소비정보 전송 약관에 대한 유저의 마지막 동의 상태 및 시기를 반환한다. 더 자세히 ...

static void	FHiveIAPV4::ShowConsumeInfoAgreement (const FHiveIAPV4OnShowConsumeInfoAgreementDelegate &Delegate)
	소비정보 전송 약관 팝업을 노출한다. 더 자세히 ...

상세한 설명

Hive IAP 가 제공하는 결제 마켓은 애플 앱스토어, 구글 플레이스토어, 원스토어, 삼성 갤럭시스토어, 아마존 앱스토어,
화웨이 앱커넥트, PG, Steam, Hive 러비(Lebi) 를 제공한다.

열거형 타입 문서화

◆ EHiveIAPV4Type

enum class EHiveIAPV4Type

strong

결제 마켓 형태

함수 문서화

◆ CheckPromotePurchase()

static void FHiveIAPV4::CheckPromotePurchase ( const FHiveIAPV4OnCheckPromotePurchaseDelegate & Delegate )

static

Apple AppStore Promote InApp Purchase 동작으로 얻어온 MarketPID를 요청한다.

앱의 시작, 앱의 Background -> Foreground시에 이 API를 호출하여 MarketPID를 얻어오도록 한다.

얻어온 MarketPID로 구매를 진행하도록 한다.

경고: iOS 11 이상에서만 지원한다.

매개변수

Delegate API 호출 결과 통지

◆ GetAccountUuid()

static FString FHiveIAPV4::GetAccountUuid ( )

static

현재 계정의 UUIDv3 값을 반환한다.

Returns the Hive account ID converted to a UUID version 3. return null, if not logged in.

◆ GetBalanceInfo()

static void FHiveIAPV4::GetBalanceInfo ( const FHiveIAPV4OnBalanceDelegate & Delegate )

static

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

매개변수

Delegate API 결과 통지

◆ GetConsumeInfoAgreement()

static void FHiveIAPV4::GetConsumeInfoAgreement ( const FHiveIAPV4OnGetConsumeInfoAgreementDelegate & Delegate )

static

소비정보 전송 약관에 대한 유저의 마지막 동의 상태 및 시기를 반환한다.

Returns the lastest consent status and timing for the Consumption Information Transmission Terms.

◆ GetMarketProductInfo()

static void FHiveIAPV4::GetMarketProductInfo	(	const TArray< FString > &	MarketPidList,
		const FHiveIAPV4OnProductInfoDelegate &	Delegate
	)

static

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

매개변수

Delegate API 결과 통지

◆ GetProductInfo()

static void FHiveIAPV4::GetProductInfo ( const FHiveIAPV4OnProductInfoDelegate & Delegate )

static

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

매개변수

Delegate API 결과 통지

◆ GetSelectedMarket()

static TOptional< EHiveIAPV4Type > FHiveIAPV4::GetSelectedMarket ( )

static

현재 선택된 마켓 타입을 반환한다.

얻어온 마켓 타입으로 구매를 진행하도록 한다.

◆ GetSubscriptionProductInfo()

static void FHiveIAPV4::GetSubscriptionProductInfo ( const FHiveIAPV4OnProductInfoDelegate & Delegate )

static

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

매개변수

Delegate API 결과 통지

◆ MarketConnect()

static void FHiveIAPV4::MarketConnect ( const FHiveIAPV4OnMarketConnectDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지

◆ Purchase() [1/2]

static void FHiveIAPV4::Purchase	(	const FString &	MarketPid,
		const FString &	IapPayload,
		const FHiveIAPV4OnPurchaseDelegate &	Delegate
	)

static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.

iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수

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

◆ Purchase() [2/2]

static void FHiveIAPV4::Purchase	(	const FString &	MarketPid,
		const FString &	IapPayload,
		int	quantity,
		const FHiveIAPV4OnPurchaseDelegate &	Delegate
	)

static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.

iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수

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

◆ PurchaseSubscription()

static void FHiveIAPV4::PurchaseSubscription	(	const FHiveIAPV4PurchaseParam &	Param,
		const FHiveIAPV4OnPurchaseDelegate &	Delegate
	)

static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.

iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다. 구독형 상품을 업그레이드하거나 다운그레이드를 수행하는 경우 기존에 구독 중인 상품의 고유코드 oldMarketPid를 필수로 넣어야 한다.

매개변수

Param	구매시 필요한 parameter 의 모음
Delegate	API 결과 통지

◆ Restore()

static void FHiveIAPV4::Restore ( const FHiveIAPV4OnRestoreDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지

◆ RestoreSubscription()

static void FHiveIAPV4::RestoreSubscription ( const FHiveIAPV4OnRestoreDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지

◆ ShowCharge()

static void FHiveIAPV4::ShowCharge ( const FHiveIAPV4OnBalanceDelegate & Delegate )

static

러비 충전 페이지 노출

매개변수

Delegate API 결과 통지

◆ ShowConsumeInfoAgreement()

static void FHiveIAPV4::ShowConsumeInfoAgreement ( const FHiveIAPV4OnShowConsumeInfoAgreementDelegate & Delegate )

static

소비정보 전송 약관 팝업을 노출한다.

Displays the Consumption Information Transmission Terms Popup.

◆ ShowInAppMessages()

static void FHiveIAPV4::ShowInAppMessages	(	int32	CategoryId,
		const FHiveIAPV4OnInAppMessagesDelegate &	Delegate
	)

static

Google In-App Offers

매개변수

categoryId	3(PROMOTIONAL)
listener	Int(responseCode) 가 2(NAVIGATE_TO_DEV_APP_STORE) 일 경우 유저가 제안(Offer)를 확인하고 사용하기를 원한 상황입니다. 개발자는 유저가 구매할 인앱 항목을 선택할 수 있는 게임/앱 내 상점으로 (유저가 해당 화면에 없는 경우) 유저를 이동해야 합니다.

0 은 아무런 액션을 하지 않아도 되고, 음수는 에러상황 입니다.

◆ ShowMarketSelection()

static void FHiveIAPV4::ShowMarketSelection ( const FIAPV4OnMarketSelectionDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지

◆ TransactionFinish()

static void FHiveIAPV4::TransactionFinish	(	const FString &	MarketPid,
		const FHiveIAPV4OnTransactionFinishDelegate &	Delegate
	)

static

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

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

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

매개변수

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

◆ TransactionMultiFinish()

static void FHiveIAPV4::TransactionMultiFinish	(	const TArray< FString > &	MarketPidList,
		const FHiveIAPV4OnTransactionMultiFinishDelegate &	Delegate
	)

static

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

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

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

매개변수

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

HIVE SDK for Unreal Engine

클래스

열거형 타입

함수

상세한 설명

열거형 타입 문서화

◆ EHiveIAPV4Type

함수 문서화

◆ CheckPromotePurchase()

◆ GetAccountUuid()

◆ GetBalanceInfo()

◆ GetConsumeInfoAgreement()

◆ GetMarketProductInfo()

◆ GetProductInfo()

◆ GetSelectedMarket()

◆ GetSubscriptionProductInfo()

◆ MarketConnect()

◆ Purchase() [1/2]

◆ Purchase() [2/2]

◆ PurchaseSubscription()

◆ Restore()

◆ RestoreSubscription()

◆ ShowCharge()

◆ ShowConsumeInfoAgreement()

◆ ShowInAppMessages()

◆ ShowMarketSelection()

◆ TransactionFinish()

◆ TransactionMultiFinish()