Skip to content

결제 (Unity IAP) ​

준비 ​

  1. Package Manager에서 In-App Purchasing(4.8 이상)을 설치해요. 설치되면 WK.GameApi.UnityIap 어셈블리가 자동으로 켜져요.
  2. 운영 담당자에게 Google Play·App Store 연동 정보를 전달해요 — 게임 등록과 키
csharp
using UnityEngine.Purchasing;
using WK.GameApi.UnityIap;

var api = await WKGameApi.InitAsync(new WKGameApiOptions
{
    AppKey = "…", AppSecret = "…",
    Store = new WKUnityIapStore(
        new WKIapProduct("gem_100", ProductType.Consumable),
        new WKIapProduct("no_ads", ProductType.NonConsumable)),
});

api.Iap.GrantHandler = async p =>       // 로그인 전에 등록
{
    if (p.ProductId == "gem_100") save.gems += 100;
    await api.Storage.SetAsync("save", save);
};
await api.Auth.LoginAsync();            // 지난번 미지급 결제 자동 복구

구매 ​

csharp
try
{
    var p = await api.Iap.PurchaseAsync("gem_100");   // 검증 → GrantHandler → 완료 보고 → 스토어 완료
    Debug.Log(p.Status);                             // consumed = 지급 완료, pending = 결제 대기
}
catch (WKError e) when (e.Code == "CANCELED") { }    // 유저 취소
멤버설명
api.Iap.Products상품 목록 — PriceString(표시 가격), Title, Available
api.Iap.IsReady스토어 초기화 완료
api.Iap.RestoreAsync()미지급 결제 복구 (로그인 직후 자동 호출)
api.Iap.Restored구매 밖에서 처리된 결제 알림 (앱 시작 때 복구 등)
api.Iap.HistoryAsync()결제 내역

동작 방식 ​

  • 결제는 ProcessPurchase에서 Pending으로 붙잡아 두고, 서버 검증·지급이 끝난 뒤 ConfirmPendingPurchase로 완료해요.
  • GrantHandler가 예외를 던지면 완료 처리하지 않아요. 다음 실행 때 Unity IAP가 같은 결제를 다시 넘겨주고, SDK가 로그인 후 다시 지급해요.
  • 같은 결제는 서버가 한 번만 verified로 돌려줘서 중복 지급되지 않아요.
  • Google Play는 스토어 응답에 가격이 없어서 표시 가격(localizedPrice)을 매출 지표용으로 함께 보내요.

에디터에서는 확인할 수 없어요

FakeStore 영수증은 서버에서 검증할 수 없어요. 실제 기기 빌드와 테스트 계정으로 확인하세요.

© WEBZEN K. All rights reserved.