화면 모드
결제 (Unity IAP)
준비
- Package Manager에서 In-App Purchasing(4.8 이상)을 설치해요. 설치되면
WK.GameApi.UnityIap어셈블리가 자동으로 켜져요. - 운영 담당자에게 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 영수증은 서버에서 검증할 수 없어요. 실제 기기 빌드와 테스트 계정으로 확인하세요.