---
url: https://developers.webzenk.kr/guide/iap.md
---
# 결제 검증

앱에서 받은 영수증을 서버가 **스토어 서버에 직접 조회**해서 확인해요. 영수증 위조, 다른 유저 영수증 재사용, 중복 지급을 막아요.

| 스토어 | 검증 방식 |
|---|---|
| Google Play | Google Play Developer API로 구매 조회 + 승인(acknowledge) |
| App Store | App Store Server API로 거래 조회 (운영 → 샌드박스 순) |
| 삼성 Instant Plays | 영수증 서명 검증 + 삼성 receipt API — [삼성 Instant Plays](./samsung) |

## 흐름

1. 앱에서 스토어 결제창으로 결제해요. 스토어 쪽 완료 처리(consume·finish)는 **아직 하지 않아요**.
2. 영수증을 서버로 보내 **검증**해요.
3. 상태가 `verified`면 아이템을 **지급**해요.
4. 지급이 끝나면 **지급 완료를 보고**해요 → `consumed`
5. 스토어에 **완료 처리**해요. 완료 처리하지 않은 결제는 다음 실행 때 스토어가 다시 넘겨줘요.

SDK를 쓰면 2~5단계를 자동으로 해요. 게임은 **지급 함수**만 만들면 돼요.

## 결제 상태

| 상태 | 뜻 | 게임이 할 일 |
|---|---|---|
| `verified` | 검증됨, 지급 보고 전 | 지급 → 지급 완료 보고 |
| `consumed` | 지급 완료 보고됨 | 없음 (스토어 완료 처리만) |
| `pending` | Google 보류 결제 (결제 미완료) | 지급하지 말고 나중에 다시 |
| `refunded` | 환불됨 | — [환불 처리](./refunds) |

## 꼭 알아 둘 것

* **같은 영수증은 한 번만 지급돼요.** 다시 보내면 같은 결제 기록과 `already_processed: true`가 와요. 지급 여부는 상태로 판단하세요.
* **지급 도중 앱이 꺼져도 괜찮아요.** 로그인 직후 `verified`로 남은 결제를 다시 지급하면 돼요(SDK는 자동).
* **테스트 결제**(Google 라이선스 테스터, Apple 샌드박스, 삼성 TEST 모드)도 검증되고 `is_sandbox: true`로 표시돼요. 매출 지표에서 빠져요.
* 다른 유저가 등록한 영수증은 `PURCHASE_OWNED_BY_OTHER`, 위조·취소된 영수증은 `RECEIPT_INVALID`예요. 지급하지 마세요.
* 스토어 장애(`503 STORE_UNAVAILABLE`)면 스토어 완료 처리를 하지 말고 나중에 다시 시도하세요.
* 정기결제(구독)와 ONE store는 아직 지원하지 않아요.

**관련 문서** · [결제 API](/api/iap) · [Unity IAP 연동](/sdk/unity/iap) · [HTML5 결제](/sdk/html5/iap-ads) · [환불 처리](./refunds)
