---
url: https://developers.webzenk.kr/sdk/unity/errors.md
---
# 오류 처리 (Unity)

모든 API는 실패하면 `WKError`를 던집니다.

```csharp
try { await api.Storage.SetAsync("save", save); }
catch (WKError e) when (e.Code == "VERSION_CONFLICT") { /* 다시 읽어서 합치기 */ }
catch (WKError e) when (e.Retryable) { /* 잠시 후 다시 */ }
catch (WKError e) { Debug.LogError($"{e.Code} {e.Message} trace={e.TraceId}"); }
```

| 속성 | 설명 |
|---|---|
| `Code` | 서버 오류 코드 또는 SDK 코드 |
| `Status` | HTTP 상태 (네트워크 오류는 0) |
| `Retryable` | 네트워크·5xx·429 — 잠시 후 다시 시도 |
| `TraceId` | 문의할 때 함께 전달 |
| `Details` | 추가 정보 (`current_version`, `retry_after` 등) |

## SDK 코드

| Code | 뜻 |
|---|---|
| `NETWORK_ERROR` | 네트워크 끊김·타임아웃 |
| `NOT_LOGGED_IN` | 로그인 전 호출 |
| `NOT_SUPPORTED` | 설치·설정되지 않은 기능 (스토어·광고 모듈 없음, GrantHandler 미등록) |
| `STORE_ERROR` | Unity IAP 오류 |
| `CANCELED` | 유저가 결제를 취소 |

서버 오류 코드는 [오류 코드](/api/errors)를 보세요.

`api.BackgroundError` — 로그인 직후 자동 복구(결제·광고 보상)에서 난 오류를 알려 줍니다.
