---
url: https://developers.webzenk.kr/sdk/unity/iap.md
---
# 결제 (Unity IAP)

## 준비

1. Package Manager에서 **In-App Purchasing**(4.8 이상)을 설치합니다. 설치되면 `WK.GameApi.UnityIap` 어셈블리가 자동으로 켜집니다.
2. 운영 담당자에게 Google Play·App Store 연동 정보를 전달합니다 — [게임 등록과 키](/guide/registration#쓰는-기능의-연동-정보-전달)

```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`)을 매출 지표용으로 함께 보냅니다.

::: warning 에디터에서는 확인할 수 없습니다
FakeStore 영수증은 서버에서 검증할 수 없습니다. 실제 기기 빌드와 테스트 계정으로 확인하세요.
:::
