결제

#if UNITY_ANDROID
using Stove.StoveSDK.IAP.Google;
#endif

public void Initialize()
{
    IAP.Initialize((Result result) =>
    {
        if (result.IsSuccessful)
        {
            SetListener(); // setListener 호출
        }
        else if (result.ErrorCode == Auth.UnauthorizedError)
        {
            //TODO : login
        }
        else
        {
            //InitializeError. Android Only
            // see https://developer.android.com/reference/com/android/billingclient/api/BillingClient.BillingResponseCode
        }
    });
}

public void SetListener()
{
    IAP.SetListener((Result result, IAPProduct product, IAPPurchaseDetail purchaseDetail) =>
    {
        if (result.IsSuccessful)
        {
            //구매 성공
        }
        else if (result.IsCanceled)
        {
            //구매 취소
        }
        else if (result.ErrorCode == IAPError.SuccessButUserMissMatchError)
        {
            //구매 성공 (계정 불일치)
            //결제 검증이 완료되지 않은 상태에서 계정 변경 또는 월드 이동 시 발생 가능
        }
        else if (result.ErrorCode == IAPError.PurchasedError)
        {
            //결제 검증 대기 중 - 추후 빌링 서버에서 자동 처리, 푸시로 알림
        }
        else if (result.ErrorCode == IAPError.WaitingError)
        {
            //지급 대기 중 - 추후 자동 처리, 푸시로 알림
        }
        else if (result.ErrorCode == IAPError.MarketError)
        {
            //Android: BillingClient.BillingResponseCode
            //iOS: SKError.Code
        }
    });
}

#if UNITY_ANDROID
using Stove.StoveSDK.IAP.Google;
#endif

public void FetchProducts()
{
    IAP.FetchProducts((Result result, List<IAPProduct> products) =>
    {
        if (result.IsSuccessful)
        {
            foreach (IAPProduct product in products)
            {
                IAPProduct.ProductState state = product.State;
                if (state == IAPProduct.ProductState.Available) { /* 구매 가능 */ }
                else if (state == IAPProduct.ProductState.Waiting) { /* 결제 중 */ }
                else if (state == IAPProduct.ProductState.Purchased) { /* flush 필요 */ }
                string localizedTitle = product.LocalizedTitle;
                string price = product.Price;
            }
        }
        else if (result.IsServerError) { /* 빌링 서버 오류 */ }
        else { /* 네트워크 오류 */ }
    });
}

#if UNITY_ANDROID
using Stove.StoveSDK.IAP.Google;
#endif

public void StartPurchase(IAPProduct product)
{
    IAPProduct.ProductState state = product.State;
    if (state == IAPProduct.ProductState.Waiting) { /* 결제 중 - 버튼 비활성화 */ }
    else if (state == IAPProduct.ProductState.Available)
    {
        IAP.StartPurchase(product, (Result result) =>
        {
            if (result.IsSuccessful) { /* 결제 시작됨 */ }
            else if (result.IsServerError)
            {
                if (result.ErrorCode == 93106) { /* 이미 구독 중인 상품 */ }
            }
            else if (result.ErrorCode == Auth.UnauthorizedError) { /* AuthUI.login */ }
            else if (result.ErrorCode == IAPError.InvalidProductError) { /* fetchProducts 결과 사용 */ }
            else { /* 네트워크 오류 */ }
        });
    }
    else if (state == IAPProduct.ProductState.Purchased)
    {
        IAP.Flush(); //재지급 처리
    }
}

public void Flush()
{
    IAP.Flush();
    // 결과는 setListener의 콜백으로 전달됨
}

string serviceOrderId = "set your developer payload";
IAP.StartPurchase(product, serviceOrderId, null, (Result result) => { });

#if UNITY_ANDROID
using Stove.StoveSDK.IAP.Google;
#endif

public void HandleVoidedPurchases()
{
    IAP.HandleVoidedPurchases((Result result) =>
    {
        if (result.IsSuccessful)
        {
            /** 게임 진입 가능 **/
        }
        else if (result.IsCanceled)
        {
            if (result.UserInfo != null && result.UserInfo.TryGetValue("userAction", out string userAction))
            {
                if (!string.IsNullOrEmpty(userAction) && userAction.Equals("customerSupport"))
                {
                    ViewUI.CustomerSupport((Result result, Dictionary<string, string> dictionary) =>
                    {
                        HandleVoidedPurchases();
                    });
                    return;
                }
            }
            HandleVoidedPurchases();
        }
        else
        {
            OperationUI.HandleResult(result, (Result operationResult) =>
            {
                if (result.ErrorCode == 40303)
                {
                    Auth.Logout();
                }
            });
        }
    });
}

IAP.SetCustomBillingGUID("{STOVE_guid}_{STOVE_character_no}");

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// 1) 초기화 — Base_Initialize 완료 이후 호출합니다.
std::wstring shopKey = L"YOUR_SHOP_KEY";
auto initResult = IAP_Initialize(shopKey.c_str());
// 부모 창 지정이 필요하면: IAP_InitializeWithWndInfo(shopKey.c_str(), mainWindowHandle);
if (!initResult.IsSuccessful())
{
    // 초기화 실패 시 로직을 구현해 주세요.
    return;
}

// 2) 종료 — IAP_UnInitialize 후 Base_UnInitialize 순서로 정리합니다.
IAP_UnInitialize();
// 이후 Base_UnInitialize() 호출

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// 필수 약관 동의 여부 조회 (IAP_Initialize 완료 이후)
StovePCTermsOption termsOption;
termsOption.SetOperation(StovePCTermsOperation::WITH_WEBVIEW);
termsOption.SetWebviewMode(Base::WebViewMode::INTERNAL);
termsOption.SetWebviewRect(0, 0, 800, 600);
IAP_FetchTermsAgreement(&termsOption,
    [](CallbackResult callbackResult, bool agreed, const wchar_t* url)
    {
        if (callbackResult.GetResult().IsSuccessful() && !agreed)
        {
            // 약관 동의 흐름을 노출해 주세요.
        }
    });

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// 1) 카테고리 조회
IAP_FetchShopCategories(
    [](CallbackResult callbackResult, StovePCShopCategory* categories, uint32_t categoriesSize)
    {
        if (callbackResult.GetResult().IsSuccessful())
        {
            // categories[0..categoriesSize) 로 상점 탭 UI 구성
        }
    });

// 2) 상품 목록 조회
StovePCFetchProductParam fetchParams;
fetchParams.SetCategoryId(L"");   // 빈 값이면 전체 카테고리
fetchParams.SetPageNumber(1);
fetchParams.SetPageSize(20);
IAP_FetchProducts(&fetchParams,
    [](CallbackResult callbackResult, StovePCProduct* products, uint32_t productsSize)
    {
        if (callbackResult.GetResult().IsSuccessful())
        {
            // products[0..productsSize) 로 상점 UI 구성
        }
    });

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

void IAP_StartPurchase_WITH_WEBVIEW_AND_CONFIRM_RESULT_Example()
{
    // (1) 상품/파라미터 구성 (실제로는 사용자가 선택한 인게임 아이템 정보를 전달)
    StovePCOrderProduct product1; product1.SetProductId(123); product1.SetSalePrice(1000);  product1.SetQuantity(3);
    StovePCOrderProduct product2; product2.SetProductId(456); product2.SetSalePrice(5000);  product2.SetQuantity(2);
    StovePCOrderProduct product3; product3.SetProductId(789); product3.SetSalePrice(39800); product3.SetQuantity(1);

    StovePCStartPurchaseParam params;
    params.CreateOrderProduct(3);            // 주문 상품 개수만큼 내부 배열 생성
    params.SetOrderProduct(0, &product1);
    params.SetOrderProduct(1, &product2);
    params.SetOrderProduct(2, &product3);

    // (2) 옵션: SDK가 결제창 표시 + 결제 완료 감지 + ConfirmPurchase(서버 확정)까지 자동 처리
    StovePCPurchaseOption option;
    option.SetOperation(StovePCPurchaseOperation::WITH_WEBVIEW_AND_CONFIRM_RESULT);
    option.SetWebviewMode(Base::WebViewMode::INTERNAL);
    // SetWebviewRect 인자: (x, y, width, height). 정중앙은 (-1, -1).
    option.SetWebviewRect(0, 0, 420, 700);
    params.SetPurchaseOption(option);

    Game::ShopUI::SetPurchaseButtonEnabled(false);   // (개발사 Psudo 함수) 결제 진행 중 중복 클릭 방지

    // (3) 결제 시작 — 결제창이 닫히므로 onDestroy 를 받는 Ex API 사용
    //     이 동선은 0원 아이템 제품 (NOT_NEED_PAYMENT_WINDOW) 케이스까지 SDK가 내부에서 ConfirmPurchase 를
    //     자동 처리해 그 결과를 onFinished 로 전달한다. 따라서 GetPurchaseProgress() 분기나
    //     IAP_ConfirmPurchase 수동 호출이 필요 없다(직접 호출하면 중복 확정이 된다).
    IAP_StartPurchaseEx(&params,
        // onFinished: 실제 구매 완료 처리 지점 (SDK가 ConfirmPurchase까지 끝낸 뒤 1회 호출)
        [](CallbackResult callbackResult, StovePCPurchaseResult purchaseResult)
        {
            // (3-1) 결제 실패/취소 처리. 흐름이 정상 종료되지 못한 모든 경우가 여기로 온다(purchased 는 항상 false).
            //       원인은 ResultCode 로 구분한다.
            if (!callbackResult.GetResult().IsSuccessful())
            {
                if (callbackResult.GetResult().GetResultCode() == (uint32_t)SDKResultCode::WEBVIEW_CLOSED_BEFORE_PURCHASE)
                {
                    // 사용자가 결제를 완료하지 않고 결제창을 닫음(결제 취소). 에러가 아닌 의도적 취소로 처리한다.
                }
                else
                {
                    // 그 외 오류: 결제창 진입 실패(VIEWUI_NOT_INITIALIZED / WEBVIEW_CREATE_FAIL / WEBVIEW_LOAD_URL_FAIL),
                    //            파라미터 오류, REST 네트워크/서버 오류, ConfirmPurchase 서버 API 실패 등.
                }
                return;   // 어느 경우든 아이템 지급 없음
            }

            // (3-2) 여기가 실제 구매 완료 시점.
            //       SDK가 ConfirmPurchase 까지 끝낸 결과가 purchaseResult 에 담겨 있으므로,
            //       IsPurchased()==true 이면 여기서 바로(그리고 여기서만) 아이템을 지급한다.
            //       0원 아이템 제품 (NOT_NEED_PAYMENT_WINDOW) 케이스도 purchased=true 로 동일하게 들어와 함께 처리된다.
            if (purchaseResult.IsPurchased())
            {
                // 구매 완료 지급 시점. 여기에서 purchasedProducts[0..purchasedProductSize) 를 인벤토리/재화에 반영하는 코드를 적용한다.
                //   transactionMasterNumber 는 거래마다 고유(Unique)한 값이다. 게임 서버를 운영하는 개발사는
                //   이 값을 기준으로 서버 측 중복 지급을 방지할 수 있고, UI 에서도 중복 처리(중복 지급 노출 등)를
                //   방지하는 키로 사용할 수 있다.
                for (uint32_t i = 0; i < purchaseResult.GetPurchasedProductCount(); ++i)
                {
                    const StovePCPurchasedProduct* product = purchaseResult.GetPurchasedProduct(i);
                    int64_t        detailNo   = product->GetTransactionDetailNumber();  // 구매 상세 번호(구매 상품 TID)
                    int64_t        productId  = product->GetProductId();                // 플랫폼 상품 아이디
                    const wchar_t* categoryId = product->GetCategoryId();               // 카테고리 아이디
                    int32_t        totalQty   = product->GetTotalQuantity();            // 상품 총 판매수량
                    int32_t        memberQty  = product->GetMemberQuantity();           // 회원 구매 수량
                    int32_t        guidQty    = product->GetGuidQuantity();             // guid 구매 수량
                    // 구매한 아이템 별로 처리 구현
                }

                // 결제에 사용된 재화/결제수단 정보(StovePCChargeInfo). 영수증 표시·정산 로깅 등에 활용.
                for (uint32_t i = 0; i < purchaseResult.GetChargeInfoCount(); ++i)
                {
                    const StovePCChargeInfo* charge = purchaseResult.GetChargeInfo(i);
                    int32_t        type       = charge->GetChargeType();              // 98:STOVE 캐시, 99:포인트, 그 외:PG 결제 수단
                    const wchar_t* typeName   = charge->GetChargeTypeName();          // 결제 수단 이름
                    double         deductVal  = charge->GetChargeDeductVal();         // 결제 가격
                    double         displayVal = charge->GetChargeDisplayDeductVal();  // 결제 가격의 캐시 전환 가격
                    // 결제 수단별 처리 구현
                }
            }
            else
            {
                // 흐름은 정상(IsSuccessful()==true)이나 서버가 결제 완료를 확인하지 않은 상태.
                //   (ConfirmPurchase 가 HTTP 200 이지만 서버 응답 status=false 인 드문 케이스 = 결제 상태 미확정)
                // 아이템을 지급하지 않고, 서버 측 구매 상태 재조회 또는 고객지원 처리로 넘긴다.
                // (사용자 취소·결제 실패는 여기가 아니라 위 (3-1) IsSuccessful()==false 로 처리된다.)
            }
        },
        // onDestroy: 결제창 팝업이 닫혔을 때 호출. 
        [](CallbackResult callbackResult)
        {
            // UI 정리 전용 콜백. (완료 판정/지급은 위 onFinished에서 처리)
            Game::ShopUI::SetPurchaseButtonEnabled(true);   // (개발사 Psudo 함수) 잠가둔 구매 버튼 재활성화
            Game::ShopUI::HideLoadingSpinner();             // (개발사 Psudo 함수) 로딩/오버레이 해제
        });
}

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// IAP_ConfirmPurchase 결과 콜백 (DEFAULT / NOT_NEED_PAYMENT_WINDOW 공용)
//   status == true 인 이 시점이 실제 구매 완료 시점이다.
static void OnConfirmPurchase(CallbackResult callbackResult, bool status,
                              StovePCPurchasedProduct* purchasedProducts, uint32_t purchasedProductSize,
                              StovePCChargeInfo* chargeInfos, uint32_t chargeInfoSize)
{
    if (callbackResult.GetResult().IsSuccessful() && status)
    {
        // 구매 완료 지급 시점. 여기에서 purchasedProducts[0..purchasedProductSize) 를 인벤토리/재화에 반영하는 코드를 적용한다.
        //   transactionMasterNumber 는 거래마다 고유(Unique)한 값이다. 게임 서버를 운영하는 개발사는
        //   이 값을 기준으로 서버 측 중복 지급을 방지할 수 있고, UI 에서도 중복 처리(중복 지급 노출 등)를
        //   방지하는 키로 사용할 수 있다.
        for (uint32_t i = 0; i < purchasedProductSize; ++i)
        {
            const StovePCPurchasedProduct* product = &purchasedProducts[i];
            int64_t        detailNo   = product->GetTransactionDetailNumber();  // 구매 상세 번호(구매 상품 TID)
            int64_t        productId  = product->GetProductId();                // 플랫폼 상품 아이디
            const wchar_t* categoryId = product->GetCategoryId();               // 카테고리 아이디
            int32_t        totalQty   = product->GetTotalQuantity();            // 상품 총 판매수량
            int32_t        memberQty  = product->GetMemberQuantity();           // 회원 구매 수량
            int32_t        guidQty    = product->GetGuidQuantity();             // guid 구매 수량
            // 구매한 아이템 별로 처리 구현
        }

        // 결제에 사용된 재화/결제수단 정보(StovePCChargeInfo). 영수증 표시·정산 로깅 등에 활용.
        for (uint32_t i = 0; i < chargeInfoSize; ++i)
        {
            const StovePCChargeInfo* charge = &chargeInfos[i];
            int32_t        type       = charge->GetChargeType();              // 98:STOVE 캐시, 99:포인트, 그 외:PG 결제 수단
            const wchar_t* typeName   = charge->GetChargeTypeName();          // 결제 수단 이름
            double         deductVal  = charge->GetChargeDeductVal();         // 결제 가격
            double         displayVal = charge->GetChargeDisplayDeductVal();  // 결제 가격의 캐시 전환 가격
            // 결제 수단별 처리 구현
        }
    }
    else if (!callbackResult.GetResult().IsSuccessful())
    {
        // ConfirmPurchase 호출 자체가 실패(네트워크/서버 오류, 파라미터 오류 등). 아이템 지급 금지 + 실패 로그/재시도/문의 안내.
    }
    else
    {
        // 호출은 성공(IsSuccessful()==true)했으나 서버가 결제 완료를 확인하지 않음(status==false).
        //   사용자가 결제를 완료하지 않고 결제창을 닫은 취소, 또는 결제 미확정 상태가 여기에 해당한다.
        // 아이템 지급 금지. 필요 시 서버 측 구매 상태 재조회/안내.
    }
}

void IAP_StartPurchase_DEFAULT_Example()
{
    // (1) 상품/파라미터 구성 (실제로는 사용자가 선택한 인게임 아이템 정보를 전달)
    StovePCOrderProduct product1; product1.SetProductId(123); product1.SetSalePrice(1000);  product1.SetQuantity(3);
    StovePCOrderProduct product2; product2.SetProductId(456); product2.SetSalePrice(5000);  product2.SetQuantity(2);
    StovePCOrderProduct product3; product3.SetProductId(789); product3.SetSalePrice(39800); product3.SetQuantity(1);

    StovePCStartPurchaseParam params;
    params.CreateOrderProduct(3);            // 주문 상품 개수만큼 내부 배열 생성
    params.SetOrderProduct(0, &product1);
    params.SetOrderProduct(1, &product2);
    params.SetOrderProduct(2, &product3);

    // (2) 옵션: DEFAULT — SDK가 결제 웹뷰를 띄우지 않는다(게임이 직접 결제 URL을 표시).
    //     SDK 결제창이 없으므로 SetWebviewMode / SetWebviewRect 설정은 무의미하다(생략).
    StovePCPurchaseOption option;
    option.SetOperation(StovePCPurchaseOperation::DEFAULT);
    params.SetPurchaseOption(option);

    // (3) 결제 시작.
    //     DEFAULT 는 SDK 결제창이 없어 onDestroy 콜백이 호출되지 않지만(내부적으로 POPUP_NOT_CREATED 가
    //     발생하나 Cpp 래퍼가 가로채 사용자 onDestroy 를 호출하지 않음), API 통일을 위해 IAP_StartPurchaseEx 를 사용한다.
    IAP_StartPurchaseEx(&params,
        // onFinished: "결제 URL 발급" 시점 (구매 완료 아님)
        [](CallbackResult callbackResult, StovePCPurchaseResult purchaseResult)
        {
            // (3-1) 결제 시작 성공 여부. 실패면 URL 발급도 안 된 것. 사용자 실패 안내 후 종료.
            if (!callbackResult.GetResult().IsSuccessful())
                return;

            // (3-2) 결제창이 필요 없는 케이스(0원 결제 등). 이미 결제 완료 상태.
            //       확정 지급 목록을 받기 위해 ConfirmPurchase 로 마무리한다. (완료 결과는 OnConfirmPurchase)
            if (purchaseResult.GetPurchaseProgress() == PurchaseProgress::NOT_NEED_PAYMENT_WINDOW)
            {
                IAP_ConfirmPurchase(purchaseResult.GetTransactionMasterNumber(), OnConfirmPurchase);
                return;
            }

            // (3-3) 이 onFinished 는 "결제 URL이 발급됐다"는 신호일 뿐 구매 완료가 아니다.
            //       게임이 이 URL로 자체 결제 페이지를 띄워 사용자 결제를 진행시키고,
            //       ConfirmPurchase 호출까지 거래번호(txnNo)를 보관한다.
            const wchar_t* paymentUrl = purchaseResult.GetOneTimePaymentUrl();
            int64_t        txnNo      = purchaseResult.GetTransactionMasterNumber();
            Game::SavePendingTransaction(txnNo);           // (개발사 Psudo 함수) 거래번호 보관
            Game::OpenOwnPaymentPage(paymentUrl, txnNo);   // (개발사 Psudo 함수) 자체 결제 페이지 표시
        },
        // onDestroy: DEFAULT 는 SDK 결제창이 없어 이 콜백이 호출되지 않는다.
        [](CallbackResult callbackResult)
        {
        });
}

// (4) 게임이 자체 결제 페이지에서 결제 완료를 감지한 시점에 호출. 구매 완료 결과는 OnConfirmPurchase 로 들어온다.
//     주의: onFinished(URL 발급) 시점에 호출하지 않는다. 그 시점은 아직 사용자가 결제하기 전이다.
void Game_ConfirmOwnPurchase()
{
    int64_t txnNo = Game::TakePendingTransaction();      // (개발사 Psudo 함수) 보관한 거래번호 회수
    if (txnNo != 0)
        IAP_ConfirmPurchase(txnNo, OnConfirmPurchase);
}

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// IAP_ConfirmPurchase 결과 콜백 (WITH_WEBVIEW / NOT_NEED_PAYMENT_WINDOW 공용)
//   status == true 인 이 시점이 실제 구매 완료 시점이다.
static void OnConfirmPurchase(CallbackResult callbackResult, bool status,
                              StovePCPurchasedProduct* purchasedProducts, uint32_t purchasedProductSize,
                              StovePCChargeInfo* chargeInfos, uint32_t chargeInfoSize)
{
    if (callbackResult.GetResult().IsSuccessful() && status)
    {
        // 구매 완료 지급 시점. 여기에서 purchasedProducts[0..purchasedProductSize) 를 인벤토리/재화에 반영하는 코드를 적용한다.
        //   transactionMasterNumber 는 거래마다 고유(Unique)한 값이다. 게임 서버를 운영하는 개발사는
        //   이 값을 기준으로 서버 측 중복 지급을 방지할 수 있고, UI 에서도 중복 처리(중복 지급 노출 등)를
        //   방지하는 키로 사용할 수 있다.
        for (uint32_t i = 0; i < purchasedProductSize; ++i)
        {
            const StovePCPurchasedProduct* product = &purchasedProducts[i];
            int64_t        detailNo   = product->GetTransactionDetailNumber();  // 구매 상세 번호(구매 상품 TID)
            int64_t        productId  = product->GetProductId();                // 플랫폼 상품 아이디
            const wchar_t* categoryId = product->GetCategoryId();               // 카테고리 아이디
            int32_t        totalQty   = product->GetTotalQuantity();            // 상품 총 판매수량
            int32_t        memberQty  = product->GetMemberQuantity();           // 회원 구매 수량
            int32_t        guidQty    = product->GetGuidQuantity();             // guid 구매 수량
            // 구매한 아이템 별로 처리 구현
        }

        // 결제에 사용된 재화/결제수단 정보(StovePCChargeInfo). 영수증 표시·정산 로깅 등에 활용.
        for (uint32_t i = 0; i < chargeInfoSize; ++i)
        {
            const StovePCChargeInfo* charge = &chargeInfos[i];
            int32_t        type       = charge->GetChargeType();              // 98:STOVE 캐시, 99:포인트, 그 외:PG 결제 수단
            const wchar_t* typeName   = charge->GetChargeTypeName();          // 결제 수단 이름
            double         deductVal  = charge->GetChargeDeductVal();         // 결제 가격
            double         displayVal = charge->GetChargeDisplayDeductVal();  // 결제 가격의 캐시 전환 가격
            // 결제 수단별 처리 구현
        }
    }
    else if (!callbackResult.GetResult().IsSuccessful())
    {
        // ConfirmPurchase 호출 자체가 실패(네트워크/서버 오류, 파라미터 오류 등). 아이템 지급 금지 + 실패 로그/재시도/문의 안내.
    }
    else
    {
        // 호출은 성공(IsSuccessful()==true)했으나 서버가 결제 완료를 확인하지 않음(status==false).
        //   사용자가 결제를 완료하지 않고 결제창을 닫은 취소, 또는 결제 미확정 상태가 여기에 해당한다.
        // 아이템 지급 금지. 필요 시 서버 측 구매 상태 재조회/안내.
    }
}

void IAP_StartPurchase_WITH_WEBVIEW_Example()
{
    // (1) 상품/파라미터 구성 (실제로는 사용자가 선택한 인게임 아이템 정보를 전달)
    StovePCOrderProduct product1; product1.SetProductId(123); product1.SetSalePrice(1000);  product1.SetQuantity(3);
    StovePCOrderProduct product2; product2.SetProductId(456); product2.SetSalePrice(5000);  product2.SetQuantity(2);
    StovePCOrderProduct product3; product3.SetProductId(789); product3.SetSalePrice(39800); product3.SetQuantity(1);

    StovePCStartPurchaseParam params;
    params.CreateOrderProduct(3);            // 주문 상품 개수만큼 내부 배열 생성
    params.SetOrderProduct(0, &product1);
    params.SetOrderProduct(1, &product2);
    params.SetOrderProduct(2, &product3);

    // (2) 옵션: WITH_WEBVIEW — SDK 결제 웹뷰는 띄우지만 ConfirmPurchase 는 자동 호출하지 않는다.
    StovePCPurchaseOption option;
    option.SetOperation(StovePCPurchaseOperation::WITH_WEBVIEW);
    option.SetWebviewMode(Base::WebViewMode::INTERNAL);          // 게임 창 내부에 표시
    // SetWebviewRect 인자: (x, y, width, height). 정중앙은 (-1, -1).
    option.SetWebviewRect(0, 0, 420, 700);
    params.SetPurchaseOption(option);

    // (3) 결제 시작 — 결제창이 닫히므로 onDestroy 를 받는 Ex API 사용
    Game::ShopUI::SetPurchaseButtonEnabled(false);   // (개발사 Psudo 함수) 결제 진행 중 중복 클릭 방지

    IAP_StartPurchaseEx(&params,
        // onFinished: "결제창 표시됨" 신호 (구매 완료 아님)
        [](CallbackResult callbackResult, StovePCPurchaseResult purchaseResult)
        {
            // (3-1) 결제창 진입 성공 여부. 실패면 웹뷰가 안 뜬 것(UI 복구는 onDestroy에서).
            if (!callbackResult.GetResult().IsSuccessful())
                return;

            // (3-2) 0원 아이템 구매와 같은 상황이므로 결제창이 열리지 않는다. ConfirmPurchase 로 확정 목록 수령.
            if (purchaseResult.GetPurchaseProgress() == PurchaseProgress::NOT_NEED_PAYMENT_WINDOW)
            {
                IAP_ConfirmPurchase(purchaseResult.GetTransactionMasterNumber(), OnConfirmPurchase);
                return;
            }

            // (3-3) 이 onFinished 는 웹뷰 URL 로드가 끝났다는 신호일 뿐 구매 완료가 아니다.
            //       SDK는 결제 완료를 통지하지 않으므로, 완료 결과를 받으려면 게임이 직접
            //       IAP_ConfirmPurchase 를 호출해야 한다. 거래번호를 보관해 둔다.
            Game::SavePendingTransaction(purchaseResult.GetTransactionMasterNumber());   // (개발사 Psudo 함수) 거래번호 보관
        },
        // onDestroy: 결제창 팝업이 닫혔을 때. UI 정리 전용
        [](CallbackResult callbackResult)
        {
            // (4) "웹뷰가 닫혔다"는 화면 이벤트(결제 성공/실패와 무관).
            //     결제 판정, 지급, ConfirmPurchase 를 여기서 하지 않는다.
            //     (창 닫힘은 결제 완료가 아니고, 결제 후 창을 안 닫으면 호출되지도 않으므로)
            Game::ShopUI::SetPurchaseButtonEnabled(true);   // (개발사 Psudo 함수) 잠가둔 구매 버튼 재활성화
            Game::ShopUI::HideLoadingSpinner();             // (개발사 Psudo 함수) 로딩/오버레이 해제
        });
}

// (5) 게임이 결제 완료를 확신할 수 있는 명시적 시점(예: 결제 후 게임 복귀/구매내역 확인)에 호출.
//     주의: onDestroy(창 닫힘)에 묶지 않는다. 창 닫힘은 결제 완료 신호가 아니므로 위험.
void Game_ConfirmPendingPurchase()
{
    int64_t txnNo = Game::TakePendingTransaction();      // (개발사 Psudo 함수) 보관한 거래번호 회수
    if (txnNo != 0)
        IAP_ConfirmPurchase(txnNo, OnConfirmPurchase);   // 구매 완료 결과는 OnConfirmPurchase 로
}

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// StartPurchase 콜백과 스팀 오버레이 노출은 순서가 보장되지 않는다.
// 콜백에서 받은 거래 마스터 번호를 보관해 두었다가 Steamworks 콜백 시점에 사용한다.
static int64_t g_PendingTxnNo = 0;

// (4) 구매 확정 결과 콜백
//     스팀 동선에서는 status / purchasedProducts / chargeInfos 가 기본값으로 내려온다.
//     따라서 성공 여부는 CallbackResult 로만 판정한다.
void OnConfirmPurchase(CallbackResult callbackResult, bool status,
                       StovePCPurchasedProduct* purchasedProducts, uint32_t purchasedProductsSize,
                       StovePCChargeInfo* chargeInfos, uint32_t chargeInfosSize)
{
    if (!callbackResult.GetResult().IsSuccessful())
    {
        // 확정 실패 — 아이템 지급 금지. 실패 안내 또는 재시도 처리를 구현해 주세요.
        return;
    }

    // 확정 완료. 지급 결과는 보관함 조회로 확인한다.
    IAP_FetchInventory(
        [](CallbackResult cb, StovePCInventoryItem* items, uint32_t itemsSize)
        {
            if (cb.GetResult().IsSuccessful())
            {
                // items[0..itemsSize) 로 보관함/재화 UI 갱신
            }
        });
}

// (1) 구매 시작 — PurchaseOption 은 설정하지 않는다(스팀 동선에서는 적용되지 않음).
void StartSteamPurchase()
{
    StovePCOrderProduct product; product.SetProductId(123); product.SetSalePrice(1000); product.SetQuantity(1);

    StovePCStartPurchaseParam params;
    params.CreateOrderProduct(1);
    params.SetOrderProduct(0, &product);
    // 결제창은 스팀런처가 주입하므로 StovePCPurchaseOption 은 기본값 그대로 둔다.

    Game::ShopUI::SetPurchaseButtonEnabled(false);   // (개발사 Psudo 함수) 중복 클릭 방지

    IAP_StartPurchase(&params,
        [](CallbackResult callbackResult, StovePCPurchaseResult purchaseResult)
        {
            // 스팀 동선에서는 CallbackResult 로만 성공/실패를 판정한다.
            if (!callbackResult.GetResult().IsSuccessful())
            {
                Game::ShopUI::SetPurchaseButtonEnabled(true);   // (개발사 Psudo 함수)
                return;
            }

            // (2) 거래 마스터 번호만 유효한 값이다. 결제 URL·구매 진행 상태 등 나머지는 기본값이므로
            //     DEFAULT 예제의 NOT_NEED_PAYMENT_WINDOW 분기는 여기서 필요 없다.
            //     이 번호를 보관해 두었다가 스팀 결제 결과가 도착할 때 사용한다.
            g_PendingTxnNo = purchaseResult.GetTransactionMasterNumber();
        });

    // 이 호출 전후로 스팀런처가 게임 위에 결제 오버레이를 띄운다(개발사 UI 구현 불필요).
}

// (3) 스팀 결제 결과 수신 — Steamworks 의 MicroTxnAuthorizationResponse_t 콜백에서 호출한다.
//     콜백 등록과 SteamAPI_RunCallbacks() 호출은 게임이 연동한 Steamworks SDK 영역이다.
void OnSteamMicroTxnAuthorized(bool authorized)
{
    Game::ShopUI::SetPurchaseButtonEnabled(true);   // (개발사 Psudo 함수)

    if (!authorized || g_PendingTxnNo == 0)
    {
        // 이용자가 취소했거나 승인되지 않음 — 지급 없음
        g_PendingTxnNo = 0;
        return;
    }

    // 보관한 거래 마스터 번호로 구매를 확정한다. 스팀 동선에는 자동 확정이 없다.
    IAP_ConfirmPurchase(g_PendingTxnNo, OnConfirmPurchase);
    g_PendingTxnNo = 0;
}

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// StartPurchase 결과에서 얻은 transaction master number 로 구매를 확정합니다.
void IAP_ConfirmPurchase_Example(int64_t transactionMasterNumber)
{
    IAP_ConfirmPurchase(
        transactionMasterNumber,
        [](CallbackResult callbackResult, bool isPurchased,
           StovePCPurchasedProduct* purchasedProducts, uint32_t purchasedProductsSize,
           StovePCChargeInfo* chargeInfos, uint32_t chargeInfosSize)
        {
            if (callbackResult.GetResult().IsSuccessful() && isPurchased)
            {
                // 게임 서버 2차 검증 후 아이템 지급 처리
            }
            else
            {
                // 구매 검증 실패 처리
            }
        });
}

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

IAP_FetchInventory(
    [](CallbackResult callbackResult, StovePCInventoryItem* inventoryItems, uint32_t inventoryItemSize)
    {
        if (callbackResult.GetResult().IsSuccessful())
        {
            // inventoryItems[0..inventoryItemSize) 로 보관함 UI 구성
        }
    });

#include "IAPSDK.h"
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::IAP;

// 1) 게임 탈퇴(약관 철회) UI 표시
StovePCWithdrawGameOption withdrawOption;
withdrawOption.SetWebviewMode(Base::WebViewMode::INTERNAL);
withdrawOption.SetWebviewRect(0, 0, 800, 600);
IAP_WithdrawGame(&withdrawOption,
    [](CallbackResult callbackResult, bool gameWithdraw)
    {
        if (callbackResult.GetResult().IsSuccessful() && gameWithdraw)
        {
            // 게임해지(약관철회) 성공 시 로직을 구현해 주세요.
        }
    },
    [](CallbackResult callbackResult)
    {
        // 게임해지(약관철회) 팝업이 닫힌 후 로직을 구현해 주세요.
    });

// 2) 열린 결제 창 일괄 닫기
IAP_CloseAllPopups();