1. 상품 구매 시작

UMyStoveSDKObject::StoveSDKStartPurchase 함수로 상품 구매를 시작합니다.

// 입력 파라미터
// const TArray<FStoveOrderProduct> Products : 주문 상품 정보
// ProductSize : 주문상품 갯수 

FStoveResult UMyStoveSDKObject::StoveSDKStartPurchase(const TArray<FStoveOrderProduct> Products, const int ProductSize)
{
    /*Add the 'walkthrough' codes here.*/

    FStoveResult ErrorResult = Super::StoveSDKStartPurchase(Products, ProductSize);

    if (ErrorResult.Result == StovePCResult::STOVE_PC_NO_ERROR)
    {
        //성공처리 
    }

    return ErrorResult;
}

UMyStoveSDKObject::StoveSDKStartPurchase 함수가 정상적으로 처리되면 OnStartPurchase 콜백이 호출됩니다.

콜백에 전달되는 FStovePurchase 구조체에는 상품 구매에 대한 메타정보가 포함되어 있습니다.

• FStovePurchase.TransactionMasterNo : 거래 고유 마스터 번호
• FStovePurchase.TempPaymentUrl : 1회용 결제 URL
• FStovePurchase.PurchaseProgress : 구매 진행 상태
  • 1: 결제중 (TempPaymentUrl 을 이용하여 외부브라우저 또는 웹뷰에 페이지 표시 필요)
  • 2: 구매 완료 (판매가격이 0 인 상품의 구매 진행으로 결제가 완료 상태로써 TempPaymentUrl 을 이용하여 외부브라우저 또는 웹뷰에 페이지 표시 불필요)

이때 게임은 외부브라우저(또는 내장브라우저)를 통해 1회용 결재 URL을 탐색합니다.

void UMyStoveSDKObject::OnStartPurchase(FStovePurchase Purchase)
{
    /*Add the 'walkthrough' codes here.*/
    OnLog("[OnStartPurchase]");

    OnLog(" TransactionMasterNo : %I64d", Purchase.TransactionMasterNo);
    OnLog(" TempPaymentUrl : %s", *(Purchase.TempPaymentUrl));
    OnLog(" PurchaseProgress : %d", Purchase.PurchaseProgress);

    if (Purchase.PurchaseProgress == 1)
    {
        FWindowsPlatformProcess::LaunchURL(*(Purchase.TempPaymentUrl), nullptr, nullptr);
    }
    else if(Purchase.PurchaseProgress == 2)
    {
        //구매완료 처리 (e.g. 구매완료 메세지 박스)
     }
}

UMyStoveSDKObject::StoveSDKStartPurchase' 함수가 실행중에 오류가 발생하면 OnError 콜백이 호출됩니다.

FStoveError 구조체의 ExternalError 필드를 통해 외부 오류를 확인할 수 있습니다.

일반적으로 UMyStoveSDKObject::StoveSDKStartPurchase 함수 호출에 대해 OnError 콜백이 호출되면 게임은 실패에 대한 메세지를 게임 사용자에게 노출합니다.

아래 표는 게임 사용자에게 표시 할 메세지에 대한 가이드를 함께 제시합니다.